phenoml 0.0.1__py3-none-any.whl

phenoml/tools/raw_client.py

@@ -0,0 +1,745 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+from json.decoder import JSONDecodeError
+
+from ..core.api_error import ApiError
+from ..core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
+from ..core.http_response import AsyncHttpResponse, HttpResponse
+from ..core.pydantic_utilities import parse_obj_as
+from ..core.request_options import RequestOptions
+from ..core.serialization import convert_and_respect_annotation_metadata
+from .errors.bad_request_error import BadRequestError
+from .errors.failed_dependency_error import FailedDependencyError
+from .errors.forbidden_error import ForbiddenError
+from .errors.internal_server_error import InternalServerError
+from .errors.unauthorized_error import UnauthorizedError
+from .types.cohort_request_provider import CohortRequestProvider
+from .types.cohort_response import CohortResponse
+from .types.fhir_client_config import FhirClientConfig
+from .types.lang2fhir_and_create_request_provider import Lang2FhirAndCreateRequestProvider
+from .types.lang2fhir_and_create_request_resource import Lang2FhirAndCreateRequestResource
+from .types.lang2fhir_and_create_response import Lang2FhirAndCreateResponse
+from .types.lang2fhir_and_search_request_provider import Lang2FhirAndSearchRequestProvider
+from .types.lang2fhir_and_search_response import Lang2FhirAndSearchResponse
+
+# this is used as the default value for optional parameters
+OMIT = typing.cast(typing.Any, ...)
+
+
+class RawToolsClient:
+    def __init__(self, *, client_wrapper: SyncClientWrapper):
+        self._client_wrapper = client_wrapper
+
+    def create_fhir_resource(
+        self,
+        *,
+        resource: Lang2FhirAndCreateRequestResource,
+        text: str,
+        provider: typing.Optional[Lang2FhirAndCreateRequestProvider] = OMIT,
+        meta: typing.Optional[FhirClientConfig] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> HttpResponse[Lang2FhirAndCreateResponse]:
+        """
+        Converts natural language to FHIR resource and optionally stores it in a FHIR server
+
+        Parameters
+        ----------
+        resource : Lang2FhirAndCreateRequestResource
+            Type of FHIR resource to create. Use 'auto' for automatic resource type detection, or specify a supported US Core profile.
+
+        text : str
+            Natural language text to convert to FHIR resource
+
+        provider : typing.Optional[Lang2FhirAndCreateRequestProvider]
+            FHIR provider to use for storing the resource
+
+        meta : typing.Optional[FhirClientConfig]
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        HttpResponse[Lang2FhirAndCreateResponse]
+            Successfully created FHIR resource
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            "tools/lang2fhir-and-create",
+            method="POST",
+            json={
+                "resource": resource,
+                "text": text,
+                "provider": provider,
+                "meta": convert_and_respect_annotation_metadata(
+                    object_=meta, annotation=FhirClientConfig, direction="write"
+                ),
+            },
+            headers={
+                "content-type": "application/json",
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    Lang2FhirAndCreateResponse,
+                    parse_obj_as(
+                        type_=Lang2FhirAndCreateResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return HttpResponse(response=_response, data=_data)
+            if _response.status_code == 400:
+                raise BadRequestError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Optional[typing.Any],
+                        parse_obj_as(
+                            type_=typing.Optional[typing.Any],  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 401:
+                raise UnauthorizedError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Optional[typing.Any],
+                        parse_obj_as(
+                            type_=typing.Optional[typing.Any],  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 403:
+                raise ForbiddenError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Optional[typing.Any],
+                        parse_obj_as(
+                            type_=typing.Optional[typing.Any],  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 424:
+                raise FailedDependencyError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Optional[typing.Any],
+                        parse_obj_as(
+                            type_=typing.Optional[typing.Any],  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 500:
+                raise InternalServerError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Optional[typing.Any],
+                        parse_obj_as(
+                            type_=typing.Optional[typing.Any],  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    def search_fhir_resources(
+        self,
+        *,
+        text: str,
+        patient_id: typing.Optional[str] = OMIT,
+        practitioner_id: typing.Optional[str] = OMIT,
+        count: typing.Optional[int] = OMIT,
+        provider: typing.Optional[Lang2FhirAndSearchRequestProvider] = OMIT,
+        meta: typing.Optional[FhirClientConfig] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> HttpResponse[Lang2FhirAndSearchResponse]:
+        """
+        Converts natural language to FHIR search parameters and executes search in FHIR server
+
+        Parameters
+        ----------
+        text : str
+            Natural language text to convert to FHIR search parameters
+
+        patient_id : typing.Optional[str]
+            Patient ID to filter results
+
+        practitioner_id : typing.Optional[str]
+            Practitioner ID to filter results
+
+        count : typing.Optional[int]
+            Maximum number of results to return
+
+        provider : typing.Optional[Lang2FhirAndSearchRequestProvider]
+            FHIR provider to use for searching
+
+        meta : typing.Optional[FhirClientConfig]
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        HttpResponse[Lang2FhirAndSearchResponse]
+            Successfully generated search and retrieved results
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            "tools/lang2fhir-and-search",
+            method="POST",
+            json={
+                "text": text,
+                "patient_id": patient_id,
+                "practitioner_id": practitioner_id,
+                "count": count,
+                "provider": provider,
+                "meta": convert_and_respect_annotation_metadata(
+                    object_=meta, annotation=FhirClientConfig, direction="write"
+                ),
+            },
+            headers={
+                "content-type": "application/json",
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    Lang2FhirAndSearchResponse,
+                    parse_obj_as(
+                        type_=Lang2FhirAndSearchResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return HttpResponse(response=_response, data=_data)
+            if _response.status_code == 400:
+                raise BadRequestError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Optional[typing.Any],
+                        parse_obj_as(
+                            type_=typing.Optional[typing.Any],  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 401:
+                raise UnauthorizedError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Optional[typing.Any],
+                        parse_obj_as(
+                            type_=typing.Optional[typing.Any],  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 403:
+                raise ForbiddenError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Optional[typing.Any],
+                        parse_obj_as(
+                            type_=typing.Optional[typing.Any],  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 424:
+                raise FailedDependencyError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Optional[typing.Any],
+                        parse_obj_as(
+                            type_=typing.Optional[typing.Any],  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 500:
+                raise InternalServerError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Optional[typing.Any],
+                        parse_obj_as(
+                            type_=typing.Optional[typing.Any],  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    def analyze_cohort(
+        self,
+        *,
+        text: str,
+        provider: CohortRequestProvider,
+        meta: typing.Optional[FhirClientConfig] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> HttpResponse[CohortResponse]:
+        """
+        Uses LLM to extract search concepts from natural language and builds patient cohorts with inclusion/exclusion criteria
+
+        Parameters
+        ----------
+        text : str
+            Natural language text describing the patient cohort criteria
+
+        provider : CohortRequestProvider
+            FHIR provider to use for searching
+
+        meta : typing.Optional[FhirClientConfig]
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        HttpResponse[CohortResponse]
+            Successfully analyzed cohort and retrieved patient list
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            "tools/cohort",
+            method="POST",
+            json={
+                "text": text,
+                "provider": provider,
+                "meta": convert_and_respect_annotation_metadata(
+                    object_=meta, annotation=FhirClientConfig, direction="write"
+                ),
+            },
+            headers={
+                "content-type": "application/json",
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    CohortResponse,
+                    parse_obj_as(
+                        type_=CohortResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return HttpResponse(response=_response, data=_data)
+            if _response.status_code == 400:
+                raise BadRequestError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Optional[typing.Any],
+                        parse_obj_as(
+                            type_=typing.Optional[typing.Any],  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 401:
+                raise UnauthorizedError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Optional[typing.Any],
+                        parse_obj_as(
+                            type_=typing.Optional[typing.Any],  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 403:
+                raise ForbiddenError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Optional[typing.Any],
+                        parse_obj_as(
+                            type_=typing.Optional[typing.Any],  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 500:
+                raise InternalServerError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Optional[typing.Any],
+                        parse_obj_as(
+                            type_=typing.Optional[typing.Any],  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+
+class AsyncRawToolsClient:
+    def __init__(self, *, client_wrapper: AsyncClientWrapper):
+        self._client_wrapper = client_wrapper
+
+    async def create_fhir_resource(
+        self,
+        *,
+        resource: Lang2FhirAndCreateRequestResource,
+        text: str,
+        provider: typing.Optional[Lang2FhirAndCreateRequestProvider] = OMIT,
+        meta: typing.Optional[FhirClientConfig] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> AsyncHttpResponse[Lang2FhirAndCreateResponse]:
+        """
+        Converts natural language to FHIR resource and optionally stores it in a FHIR server
+
+        Parameters
+        ----------
+        resource : Lang2FhirAndCreateRequestResource
+            Type of FHIR resource to create. Use 'auto' for automatic resource type detection, or specify a supported US Core profile.
+
+        text : str
+            Natural language text to convert to FHIR resource
+
+        provider : typing.Optional[Lang2FhirAndCreateRequestProvider]
+            FHIR provider to use for storing the resource
+
+        meta : typing.Optional[FhirClientConfig]
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AsyncHttpResponse[Lang2FhirAndCreateResponse]
+            Successfully created FHIR resource
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            "tools/lang2fhir-and-create",
+            method="POST",
+            json={
+                "resource": resource,
+                "text": text,
+                "provider": provider,
+                "meta": convert_and_respect_annotation_metadata(
+                    object_=meta, annotation=FhirClientConfig, direction="write"
+                ),
+            },
+            headers={
+                "content-type": "application/json",
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    Lang2FhirAndCreateResponse,
+                    parse_obj_as(
+                        type_=Lang2FhirAndCreateResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return AsyncHttpResponse(response=_response, data=_data)
+            if _response.status_code == 400:
+                raise BadRequestError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Optional[typing.Any],
+                        parse_obj_as(
+                            type_=typing.Optional[typing.Any],  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 401:
+                raise UnauthorizedError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Optional[typing.Any],
+                        parse_obj_as(
+                            type_=typing.Optional[typing.Any],  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 403:
+                raise ForbiddenError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Optional[typing.Any],
+                        parse_obj_as(
+                            type_=typing.Optional[typing.Any],  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 424:
+                raise FailedDependencyError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Optional[typing.Any],
+                        parse_obj_as(
+                            type_=typing.Optional[typing.Any],  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 500:
+                raise InternalServerError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Optional[typing.Any],
+                        parse_obj_as(
+                            type_=typing.Optional[typing.Any],  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    async def search_fhir_resources(
+        self,
+        *,
+        text: str,
+        patient_id: typing.Optional[str] = OMIT,
+        practitioner_id: typing.Optional[str] = OMIT,
+        count: typing.Optional[int] = OMIT,
+        provider: typing.Optional[Lang2FhirAndSearchRequestProvider] = OMIT,
+        meta: typing.Optional[FhirClientConfig] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> AsyncHttpResponse[Lang2FhirAndSearchResponse]:
+        """
+        Converts natural language to FHIR search parameters and executes search in FHIR server
+
+        Parameters
+        ----------
+        text : str
+            Natural language text to convert to FHIR search parameters
+
+        patient_id : typing.Optional[str]
+            Patient ID to filter results
+
+        practitioner_id : typing.Optional[str]
+            Practitioner ID to filter results
+
+        count : typing.Optional[int]
+            Maximum number of results to return
+
+        provider : typing.Optional[Lang2FhirAndSearchRequestProvider]
+            FHIR provider to use for searching
+
+        meta : typing.Optional[FhirClientConfig]
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AsyncHttpResponse[Lang2FhirAndSearchResponse]
+            Successfully generated search and retrieved results
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            "tools/lang2fhir-and-search",
+            method="POST",
+            json={
+                "text": text,
+                "patient_id": patient_id,
+                "practitioner_id": practitioner_id,
+                "count": count,
+                "provider": provider,
+                "meta": convert_and_respect_annotation_metadata(
+                    object_=meta, annotation=FhirClientConfig, direction="write"
+                ),
+            },
+            headers={
+                "content-type": "application/json",
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    Lang2FhirAndSearchResponse,
+                    parse_obj_as(
+                        type_=Lang2FhirAndSearchResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return AsyncHttpResponse(response=_response, data=_data)
+            if _response.status_code == 400:
+                raise BadRequestError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Optional[typing.Any],
+                        parse_obj_as(
+                            type_=typing.Optional[typing.Any],  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 401:
+                raise UnauthorizedError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Optional[typing.Any],
+                        parse_obj_as(
+                            type_=typing.Optional[typing.Any],  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 403:
+                raise ForbiddenError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Optional[typing.Any],
+                        parse_obj_as(
+                            type_=typing.Optional[typing.Any],  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 424:
+                raise FailedDependencyError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Optional[typing.Any],
+                        parse_obj_as(
+                            type_=typing.Optional[typing.Any],  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 500:
+                raise InternalServerError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Optional[typing.Any],
+                        parse_obj_as(
+                            type_=typing.Optional[typing.Any],  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    async def analyze_cohort(
+        self,
+        *,
+        text: str,
+        provider: CohortRequestProvider,
+        meta: typing.Optional[FhirClientConfig] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> AsyncHttpResponse[CohortResponse]:
+        """
+        Uses LLM to extract search concepts from natural language and builds patient cohorts with inclusion/exclusion criteria
+
+        Parameters
+        ----------
+        text : str
+            Natural language text describing the patient cohort criteria
+
+        provider : CohortRequestProvider
+            FHIR provider to use for searching
+
+        meta : typing.Optional[FhirClientConfig]
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AsyncHttpResponse[CohortResponse]
+            Successfully analyzed cohort and retrieved patient list
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            "tools/cohort",
+            method="POST",
+            json={
+                "text": text,
+                "provider": provider,
+                "meta": convert_and_respect_annotation_metadata(
+                    object_=meta, annotation=FhirClientConfig, direction="write"
+                ),
+            },
+            headers={
+                "content-type": "application/json",
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    CohortResponse,
+                    parse_obj_as(
+                        type_=CohortResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return AsyncHttpResponse(response=_response, data=_data)
+            if _response.status_code == 400:
+                raise BadRequestError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Optional[typing.Any],
+                        parse_obj_as(
+                            type_=typing.Optional[typing.Any],  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 401:
+                raise UnauthorizedError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Optional[typing.Any],
+                        parse_obj_as(
+                            type_=typing.Optional[typing.Any],  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 403:
+                raise ForbiddenError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Optional[typing.Any],
+                        parse_obj_as(
+                            type_=typing.Optional[typing.Any],  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 500:
+                raise InternalServerError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Optional[typing.Any],
+                        parse_obj_as(
+                            type_=typing.Optional[typing.Any],  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)