deeprails 1.2.0__py3-none-any.whl → 1.3.0__py3-none-any.whl

deeprails/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "deeprails"
-__version__ = "1.2.0"  # x-release-please-version
+__version__ = "1.3.0"  # x-release-please-version

deeprails/resources/defend.py

@@ -63,13 +63,13 @@ class DefendResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> DefendResponse:
         """
-        Create a new guardrail workflow with optional guardrail thresholds and
-        improvement actions.
+        Use this endpoint to create a new guardrail workflow with optional guardrail
+        thresholds and improvement actions
 
         Args:
           improvement_action: The action used to improve outputs that fail one or guardrail metrics for the
               workflow events. May be `regenerate`, `fixit`, or null which represents “do
-              nothing”. ReGen runs the user's exact input prompt with minor induced variance.
+              nothing”. Regenerate runs the user's input prompt with minor induced variance.
               Fixit attempts to directly address the shortcomings of the output using the
               guardrail failure rationale. Do nothing does not attempt any improvement.
 
@@ -136,7 +136,7 @@ class DefendResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> WorkflowEventResponse:
         """
-        Retrieve a specific event of a guardrail workflow.
+        Use this endpoint to retrieve a specific event of a guardrail workflow
 
         Args:
           extra_headers: Send extra headers
@@ -171,7 +171,7 @@ class DefendResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> DefendResponse:
         """
-        Retrieve the details for a specific guardrail workflow.
+        Use this endpoint to retrieve the details for a specific defend workflow
 
         Args:
           extra_headers: Send extra headers
@@ -209,7 +209,8 @@ class DefendResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> WorkflowEventResponse:
         """
-        Submit a model input and output pair to a workflow for evaluation.
+        Use this endpoint to submit a model input and output pair to a workflow for
+        evaluation
 
         Args:
           model_input: A dictionary of inputs sent to the LLM to generate output. This must contain a
@@ -261,7 +262,6 @@ class DefendResource(SyncAPIResource):
         *,
         description: str | Omit = omit,
         name: str | Omit = omit,
-        type: Literal["automatic", "custom"] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -270,15 +270,13 @@ class DefendResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> DefendResponse:
         """
-        Update an existing guardrail workflow.
+        Use this endpoint to update an existing guardrail workflow
 
         Args:
           description: Description for the workflow.
 
           name: Name of the workflow.
 
-          type: Type of thresholds to use for the workflow, either `automatic` or `custom`.
-
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -295,7 +293,6 @@ class DefendResource(SyncAPIResource):
                 {
                     "description": description,
                     "name": name,
-                    "type": type,
                 },
                 defend_update_workflow_params.DefendUpdateWorkflowParams,
             ),
@@ -344,13 +341,13 @@ class AsyncDefendResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> DefendResponse:
         """
-        Create a new guardrail workflow with optional guardrail thresholds and
-        improvement actions.
+        Use this endpoint to create a new guardrail workflow with optional guardrail
+        thresholds and improvement actions
 
         Args:
           improvement_action: The action used to improve outputs that fail one or guardrail metrics for the
               workflow events. May be `regenerate`, `fixit`, or null which represents “do
-              nothing”. ReGen runs the user's exact input prompt with minor induced variance.
+              nothing”. Regenerate runs the user's input prompt with minor induced variance.
               Fixit attempts to directly address the shortcomings of the output using the
               guardrail failure rationale. Do nothing does not attempt any improvement.
 
@@ -417,7 +414,7 @@ class AsyncDefendResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> WorkflowEventResponse:
         """
-        Retrieve a specific event of a guardrail workflow.
+        Use this endpoint to retrieve a specific event of a guardrail workflow
 
         Args:
           extra_headers: Send extra headers
@@ -452,7 +449,7 @@ class AsyncDefendResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> DefendResponse:
         """
-        Retrieve the details for a specific guardrail workflow.
+        Use this endpoint to retrieve the details for a specific defend workflow
 
         Args:
           extra_headers: Send extra headers
@@ -490,7 +487,8 @@ class AsyncDefendResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> WorkflowEventResponse:
         """
-        Submit a model input and output pair to a workflow for evaluation.
+        Use this endpoint to submit a model input and output pair to a workflow for
+        evaluation
 
         Args:
           model_input: A dictionary of inputs sent to the LLM to generate output. This must contain a
@@ -542,7 +540,6 @@ class AsyncDefendResource(AsyncAPIResource):
         *,
         description: str | Omit = omit,
         name: str | Omit = omit,
-        type: Literal["automatic", "custom"] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -551,15 +548,13 @@ class AsyncDefendResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> DefendResponse:
         """
-        Update an existing guardrail workflow.
+        Use this endpoint to update an existing guardrail workflow
 
         Args:
           description: Description for the workflow.
 
           name: Name of the workflow.
 
-          type: Type of thresholds to use for the workflow, either `automatic` or `custom`.
-
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -576,7 +571,6 @@ class AsyncDefendResource(AsyncAPIResource):
                 {
                     "description": description,
                     "name": name,
-                    "type": type,
                 },
                 defend_update_workflow_params.DefendUpdateWorkflowParams,
             ),

deeprails/resources/evaluate.py

@@ -133,7 +133,7 @@ class EvaluateResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> Evaluation:
         """
-        Retrieve the evaluation record for a given evaluation ID.
+        Use this endpoint to retrieve the evaluation record for a given evaluation ID
 
         Args:
           extra_headers: Send extra headers
@@ -264,7 +264,7 @@ class AsyncEvaluateResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> Evaluation:
         """
-        Retrieve the evaluation record for a given evaluation ID.
+        Use this endpoint to retrieve the evaluation record for a given evaluation ID
 
         Args:
           extra_headers: Send extra headers

deeprails/resources/monitor.py

@@ -59,7 +59,8 @@ class MonitorResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> APIResponse:
         """
-        Create a new monitor to evaluate model inputs and outputs using guardrails.
+        Use this endpoint to create a new monitor to evaluate model inputs and outputs
+        using guardrails
 
         Args:
           name: Name of the new monitor.
@@ -102,7 +103,8 @@ class MonitorResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> MonitorRetrieveResponse:
         """
-        Retrieve the details and evaluations associated with a specific monitor.
+        Use this endpoint to retrieve the details and evaluations associated with a
+        specific monitor
 
         Args:
           limit: Limit the returned events associated with this monitor. Defaults to 10.
@@ -144,7 +146,8 @@ class MonitorResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> APIResponse:
         """
-        Update the name, description, or status of an existing monitor.
+        Use this endpoint to update the name, description, or status of an existing
+        monitor
 
         Args:
           description: Description of the monitor.
@@ -207,7 +210,8 @@ class MonitorResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> MonitorSubmitEventResponse:
         """
-        Submit a model input and output pair to a monitor for evaluation.
+        Use this endpoint to submit a model input and output pair to a monitor for
+        evaluation
 
         Args:
           guardrail_metrics: An array of guardrail metrics that the model input and output pair will be
@@ -293,7 +297,8 @@ class AsyncMonitorResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> APIResponse:
         """
-        Create a new monitor to evaluate model inputs and outputs using guardrails.
+        Use this endpoint to create a new monitor to evaluate model inputs and outputs
+        using guardrails
 
         Args:
           name: Name of the new monitor.
@@ -336,7 +341,8 @@ class AsyncMonitorResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> MonitorRetrieveResponse:
         """
-        Retrieve the details and evaluations associated with a specific monitor.
+        Use this endpoint to retrieve the details and evaluations associated with a
+        specific monitor
 
         Args:
           limit: Limit the returned events associated with this monitor. Defaults to 10.
@@ -378,7 +384,8 @@ class AsyncMonitorResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> APIResponse:
         """
-        Update the name, description, or status of an existing monitor.
+        Use this endpoint to update the name, description, or status of an existing
+        monitor
 
         Args:
           description: Description of the monitor.
@@ -441,7 +448,8 @@ class AsyncMonitorResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> MonitorSubmitEventResponse:
         """
-        Submit a model input and output pair to a monitor for evaluation.
+        Use this endpoint to submit a model input and output pair to a monitor for
+        evaluation
 
         Args:
           guardrail_metrics: An array of guardrail metrics that the model input and output pair will be

deeprails/types/api_response.py

@@ -41,7 +41,6 @@ class APIResponse(BaseModel):
     """Represents whether the request was completed successfully."""
 
     data: Optional[Data] = None
-    """Response payload for creating or updating a monitor."""
 
     message: Optional[str] = None
     """The accompanying message for the request.

deeprails/types/defend_create_workflow_params.py

@@ -13,7 +13,7 @@ class DefendCreateWorkflowParams(TypedDict, total=False):
     """
     The action used to improve outputs that fail one or guardrail metrics for the
     workflow events. May be `regenerate`, `fixit`, or null which represents “do
-    nothing”. ReGen runs the user's exact input prompt with minor induced variance.
+    nothing”. Regenerate runs the user's input prompt with minor induced variance.
     Fixit attempts to directly address the shortcomings of the output using the
     guardrail failure rationale. Do nothing does not attempt any improvement.
     """

deeprails/types/defend_response.py

@@ -26,7 +26,7 @@ class DefendResponse(BaseModel):
     """
     The action used to improve outputs that fail one or more guardrail metrics for
     the workflow events. May be `regenerate`, `fixit`, or null which represents “do
-    nothing”. ReGen runs the user's exact input prompt with minor induced variance.
+    nothing”. Regenerate runs the user's input prompt with minor induced variance.
     Fixit attempts to directly address the shortcomings of the output using the
     guardrail failure rationale. Do nothing does not attempt any improvement.
     """

deeprails/types/defend_update_workflow_params.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing_extensions import Literal, TypedDict
+from typing_extensions import TypedDict
 
 __all__ = ["DefendUpdateWorkflowParams"]
 
@@ -13,6 +13,3 @@ class DefendUpdateWorkflowParams(TypedDict, total=False):
 
     name: str
     """Name of the workflow."""
-
-    type: Literal["automatic", "custom"]
-    """Type of thresholds to use for the workflow, either `automatic` or `custom`."""

deeprails/types/monitor_retrieve_response.py

@@ -72,7 +72,6 @@ class MonitorRetrieveResponse(BaseModel):
     """Represents whether the request was completed successfully."""
 
     data: Optional[Data] = None
-    """Detailed response payload for retrieving a monitor and its evaluations."""
 
     message: Optional[str] = None
     """The accompanying message for the request.

deeprails/types/monitor_submit_event_response.py

@@ -27,7 +27,6 @@ class MonitorSubmitEventResponse(BaseModel):
     """Represents whether the request was completed successfully."""
 
     data: Optional[Data] = None
-    """Response payload for monitor event operations."""
 
     message: Optional[str] = None
     """The accompanying message for the request.

{deeprails-1.2.0.dist-info → deeprails-1.3.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: deeprails
-Version: 1.2.0
+Version: 1.3.0
 Summary: The official Python library for the deeprails API
 Project-URL: Homepage, https://docs.deeprails.com/
 Project-URL: Repository, https://github.com/deeprails/deeprails-sdk-python
@@ -44,7 +44,7 @@ and offers both synchronous and asynchronous clients powered by [httpx](https://
 
 ## Documentation
 
-The full API of this library can be found in [api.md](https://github.com/deeprails/deeprails-sdk-python/tree/main/api.md).
+The REST API documentation can be found on [docs.deeprails.com](https://docs.deeprails.com). The full API of this library can be found in [api.md](https://github.com/deeprails/deeprails-sdk-python/tree/main/api.md).
 
 ## Installation
 
@@ -68,7 +68,7 @@ client = Deeprails(
 defend_response = client.defend.create_workflow(
     improvement_action="fixit",
     metrics={
-        "completeness": 0.85,
+        "completeness": 0.8,
         "instruction_adherence": 0.75,
     },
     name="Push Alert Workflow",
@@ -100,7 +100,7 @@ async def main() -> None:
     defend_response = await client.defend.create_workflow(
         improvement_action="fixit",
         metrics={
-            "completeness": 0.85,
+            "completeness": 0.8,
             "instruction_adherence": 0.75,
         },
         name="Push Alert Workflow",
@@ -141,7 +141,7 @@ async def main() -> None:
         defend_response = await client.defend.create_workflow(
             improvement_action="fixit",
             metrics={
-                "completeness": 0.85,
+                "completeness": 0.8,
                 "instruction_adherence": 0.75,
             },
             name="Push Alert Workflow",
@@ -201,7 +201,7 @@ try:
     client.defend.create_workflow(
         improvement_action="fixit",
         metrics={
-            "completeness": 0.85,
+            "completeness": 0.8,
             "instruction_adherence": 0.75,
         },
         name="Push Alert Workflow",
@@ -252,7 +252,7 @@ client = Deeprails(
 client.with_options(max_retries=5).defend.create_workflow(
     improvement_action="fixit",
     metrics={
-        "completeness": 0.85,
+        "completeness": 0.8,
         "instruction_adherence": 0.75,
     },
     name="Push Alert Workflow",
@@ -283,7 +283,7 @@ client = Deeprails(
 client.with_options(timeout=5.0).defend.create_workflow(
     improvement_action="fixit",
     metrics={
-        "completeness": 0.85,
+        "completeness": 0.8,
         "instruction_adherence": 0.75,
     },
     name="Push Alert Workflow",
@@ -332,7 +332,7 @@ client = Deeprails()
 response = client.defend.with_raw_response.create_workflow(
     improvement_action="fixit",
     metrics={
-        "completeness": 0.85,
+        "completeness": 0.8,
         "instruction_adherence": 0.75,
     },
     name="Push Alert Workflow",
@@ -358,7 +358,7 @@ To stream the response body, use `.with_streaming_response` instead, which requi
 with client.defend.with_streaming_response.create_workflow(
     improvement_action="fixit",
     metrics={
-        "completeness": 0.85,
+        "completeness": 0.8,
         "instruction_adherence": 0.75,
     },
     name="Push Alert Workflow",

{deeprails-1.2.0.dist-info → deeprails-1.3.0.dist-info}/RECORD

@@ -11,7 +11,7 @@ deeprails/_resource.py,sha256=7RXX5KZr4j0TIE66vnduHp7p9Yf9X0FyDDECuvRHARg,1118
 deeprails/_response.py,sha256=yj0HJDU91WPpiczwi6CBOLAl_bqf4I_I96vWMAwx6Fg,28806
 deeprails/_streaming.py,sha256=hCp5bK9dyw2TyrVL69m-6qGC-QtGYwhXmFzITCWPgAs,10112
 deeprails/_types.py,sha256=XR3mad9NsGqZsjrd1VVJ657-4O4kwyw9Qzg4M3i6Vh0,7239
-deeprails/_version.py,sha256=ycCjEYhPunIKim4afldP-ef4yOvdCWtPOs4FpSmFHy4,161
+deeprails/_version.py,sha256=UBtYgrLutf4L77e2ehcHfFtHcPj8ogYpr0Ivh-3zYyI,161
 deeprails/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 deeprails/_utils/__init__.py,sha256=7fch0GT9zpNnErbciSpUNa-SjTxxjY6kxHxKMOM4AGs,2305
 deeprails/_utils/_compat.py,sha256=D8gtAvjJQrDWt9upS0XaG9Rr5l1QhiAx_I_1utT_tt0,1195
@@ -27,25 +27,25 @@ deeprails/_utils/_typing.py,sha256=N_5PPuFNsaygbtA_npZd98SVN1LQQvFTKL6bkWPBZGU,4
 deeprails/_utils/_utils.py,sha256=0dDqauUbVZEXV0NVl7Bwu904Wwo5eyFCZpQThhFNhyA,12253
 deeprails/lib/.keep,sha256=wuNrz-5SXo3jJaJOJgz4vFHM41YH_g20F5cRQo0vLes,224
 deeprails/resources/__init__.py,sha256=ha0jL9Et8fHzPdkTa7ecihYapOC4I6O-PHf2X9igprE,1491
-deeprails/resources/defend.py,sha256=ehqqzx7XjNNSxbggdbZ-VQsYmRQb5Qc6_zTznKvi4zs,27704
-deeprails/resources/evaluate.py,sha256=6GklcmsdDegocTbyVw25Y0i3Op6E-rbz_ikIcZnhXNY,12867
-deeprails/resources/monitor.py,sha256=2RW0eXSs48T1zjyIg6SD6poIgUq6Ndzktcc7JQz9sWg,22191
+deeprails/resources/defend.py,sha256=bSF5DI4OSdV_MHBjY_s7hTiSuhffiloDlJnTf-w1VHk,27538
+deeprails/resources/evaluate.py,sha256=_jAPyR1ULkz8yrU3nOtwJstdRIoCuwDiT1leAYPQCUY,12907
+deeprails/resources/monitor.py,sha256=hF-aLOS2whKsE-EVdNIj6hPY-YGKpo8xWoAwwCq4B34,22415
 deeprails/types/__init__.py,sha256=tLO-5DMMKt-F4qQYht3F-RFgLbthP-8a36853IhNoGI,1267
-deeprails/types/api_response.py,sha256=jIiEJsQQdRgw-HkwRiHYYe1YI6DtPlgeCxNTY9kgqT8,1295
-deeprails/types/defend_create_workflow_params.py,sha256=_N1cKVmNjRIlo9UkbkaJtamfDDHR-G5gQ2KkyAjIAJk,2077
-deeprails/types/defend_response.py,sha256=GjoxHYJ4kq4BR-F1T3KYez8rcnNZFa0xkrsCQ_owlj0,1618
+deeprails/types/api_response.py,sha256=eHEQeL677tvm1RK0A_S03EAoprQbJzmHspiKrtjKRt4,1232
+deeprails/types/defend_create_workflow_params.py,sha256=EWYlSeoojWf8pp7VawZh8IbShHWsd0iZfdKq6qlh8OA,2076
+deeprails/types/defend_response.py,sha256=u508zff61fbo7DqotbJLEoYzYg2VUDWbFScx8Ec8EGA,1617
 deeprails/types/defend_submit_event_params.py,sha256=51Z7rviuE-wvU4otESmB6mIkZyRD5VGLARpMV6m4ITI,1386
-deeprails/types/defend_update_workflow_params.py,sha256=XSwPZd8QmHGQeYitO5rXzZ0U_pkR_w6tIYVr_vZnc1Y,510
+deeprails/types/defend_update_workflow_params.py,sha256=QH2k7EDMLub3mW1lPV5SUoKDHW_T2arSo-RGHLterwo,373
 deeprails/types/evaluate_create_params.py,sha256=8P3jDuSgGRfGSdgq50Zq9J709ZltRZw29hI8R3MoS84,1828
 deeprails/types/evaluation.py,sha256=cLFQtazZyAEOVGkGqQ_VUmCFE8WMS2pBzUPLQ9MioOA,3787
 deeprails/types/monitor_create_params.py,sha256=kTSj-PhuzpT-HPDTQJemRWfd8w32foUMH9FQZj8symk,384
 deeprails/types/monitor_retrieve_params.py,sha256=PEsRmbd-81z4pJvhfi4JbrQWNzmeiLkoNsTUoPZ6kFY,352
-deeprails/types/monitor_retrieve_response.py,sha256=OFCgBIoZ-nopKBuVz78ogubk73qJH2tZK3w4QGdj58k,2327
+deeprails/types/monitor_retrieve_response.py,sha256=BZp7-6PFVdqYU5ZDhbr1Eao3kU132zTm9idgoaA65Gg,2245
 deeprails/types/monitor_submit_event_params.py,sha256=q8Mq24McRr1WdXQ8L1YunKqLBb9-u91J2MLmhUCdaIw,1991
-deeprails/types/monitor_submit_event_response.py,sha256=LYWEZ24b0AHCImUjK6kXRJmq0kukpigtVTXoAzeHbdc,924
+deeprails/types/monitor_submit_event_response.py,sha256=qlraxIJaclNSR_JOizMPj9gOiz-0x7lIChSX3DmFllM,867
 deeprails/types/monitor_update_params.py,sha256=gJyFFxT_u_iWABknuKnLpPl9r-VPfCcGtOAmh6sPwUw,550
 deeprails/types/workflow_event_response.py,sha256=mIzOCnYJg4TDSq_tG_0WfA0_Gmc9-0q-befyookfUFM,867
-deeprails-1.2.0.dist-info/METADATA,sha256=_JnZNFI7JgNQ00Y5Boi8qgtdfElyBNUvdUDSQzrZVTI,11778
-deeprails-1.2.0.dist-info/WHEEL,sha256=C2FUgwZgiLbznR-k0b_5k3Ai_1aASOXDss3lzCUsUug,87
-deeprails-1.2.0.dist-info/licenses/LICENSE,sha256=rFTxPcYE516UQLju2SCY1r2pSDDfodL0-ZvxF_fgueg,11339
-deeprails-1.2.0.dist-info/RECORD,,
+deeprails-1.3.0.dist-info/METADATA,sha256=d5a673E4yKIF1v5_HExzyx_hCLb7S3e4MSFmqJUQVVQ,11863
+deeprails-1.3.0.dist-info/WHEEL,sha256=C2FUgwZgiLbznR-k0b_5k3Ai_1aASOXDss3lzCUsUug,87
+deeprails-1.3.0.dist-info/licenses/LICENSE,sha256=rFTxPcYE516UQLju2SCY1r2pSDDfodL0-ZvxF_fgueg,11339
+deeprails-1.3.0.dist-info/RECORD,,