feat(api): update via SDK Studio

Author: stainless-app[bot]

.github/workflows/create-releases.yml

@@ -0,0 +1,38 @@
+name: Create releases
+on:
+  schedule:
+    - cron: '0 5 * * *' # every day at 5am UTC
+  push:
+    branches:
+      - main
+
+jobs:
+  release:
+    name: release
+    if: github.ref == 'refs/heads/main' && github.repository == 'isaacus-dev/isaacus-python'
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: stainless-api/trigger-release-please@v1
+        id: release
+        with:
+          repo: ${{ github.event.repository.full_name }}
+          stainless-api-key: ${{ secrets.STAINLESS_API_KEY }}
+
+      - name: Install Rye
+        if: ${{ steps.release.outputs.releases_created }}
+        run: |
+          curl -sSf https://rye.astral.sh/get | bash
+          echo "$HOME/.rye/shims" >> $GITHUB_PATH
+        env:
+          RYE_VERSION: '0.35.0'
+          RYE_INSTALL_OPTION: '--yes'
+
+      - name: Publish to PyPI
+        if: ${{ steps.release.outputs.releases_created }}
+        run: |
+          bash ./bin/publish-pypi
+        env:
+          PYPI_TOKEN: ${{ secrets.ISAACUS_PYPI_TOKEN || secrets.PYPI_TOKEN }}

.github/workflows/publish-pypi.yml

@@ -0,0 +1,27 @@
+# workflow for re-running publishing to PyPI in case it fails for some reason
+# you can run this workflow by navigating to https://www.github.com/isaacus-dev/isaacus-python/actions/workflows/publish-pypi.yml
+name: Publish PyPI
+on:
+  workflow_dispatch:
+
+jobs:
+  publish:
+    name: publish
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install Rye
+        run: |
+          curl -sSf https://rye.astral.sh/get | bash
+          echo "$HOME/.rye/shims" >> $GITHUB_PATH
+        env:
+          RYE_VERSION: '0.35.0'
+          RYE_INSTALL_OPTION: '--yes'
+
+      - name: Publish to PyPI
+        run: |
+          bash ./bin/publish-pypi
+        env:
+          PYPI_TOKEN: ${{ secrets.ISAACUS_PYPI_TOKEN || secrets.PYPI_TOKEN }}

.github/workflows/release-doctor.yml

@@ -0,0 +1,22 @@
+name: Release Doctor
+on:
+  pull_request:
+    branches:
+      - main
+  workflow_dispatch:
+
+jobs:
+  release_doctor:
+    name: release doctor
+    runs-on: ubuntu-latest
+    if: github.repository == 'isaacus-dev/isaacus-python' && (github.event_name == 'push' || github.event_name == 'workflow_dispatch' || startsWith(github.head_ref, 'release-please') || github.head_ref == 'next')
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Check release environment
+        run: |
+          bash ./bin/check-release-environment
+        env:
+          STAINLESS_API_KEY: ${{ secrets.STAINLESS_API_KEY }}
+          PYPI_TOKEN: ${{ secrets.ISAACUS_PYPI_TOKEN || secrets.PYPI_TOKEN }}

.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.0.1-alpha.0"
+}

.stats.yml

@@ -1,2 +1,2 @@
 configured_endpoints: 1
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/isaacus%2Fisaacus-d4d022b52b746c73bfcd08786a09a387060d83f28f09c2d663598ad41d7e8fc5.yml
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/isaacus%2Fisaacus-874c20d494cb37fc2f1c78b089cf16065bd2910c0fcb4dcc89cc55b73a3d6fc4.yml

CONTRIBUTING.md

@@ -63,7 +63,7 @@ If you’d like to use the repository from source, you can either install from g
 To install via git:
 
 ```sh
-$ pip install git+ssh://git@github.com/stainless-sdks/isaacus-python.git
+$ pip install git+ssh://git@github.com/isaacus-dev/isaacus-python.git
 ```
 
 Alternatively, you can build from source and install the wheel file:
@@ -121,7 +121,7 @@ the changes aren't made through the automated pipeline, you may want to make rel
 
 ### Publish with a GitHub workflow
 
-You can release to package managers by using [the `Publish PyPI` GitHub action](https://www.github.com/stainless-sdks/isaacus-python/actions/workflows/publish-pypi.yml). This requires a setup organization or repository secret to be set up.
+You can release to package managers by using [the `Publish PyPI` GitHub action](https://www.github.com/isaacus-dev/isaacus-python/actions/workflows/publish-pypi.yml). This requires a setup organization or repository secret to be set up.
 
 ### Publish manually
 

README.md

@@ -15,8 +15,8 @@ The REST API documentation can be found on [docs.isaacus.com](https://docs.isaac
 ## Installation
 
 ```sh
-# install from this staging repo
-pip install git+ssh://git@github.com/stainless-sdks/isaacus-python.git
+# install from the production repo
+pip install git+ssh://git@github.com/isaacus-dev/isaacus-python.git
 ```
 
 > [!NOTE]
@@ -27,36 +27,47 @@ pip install git+ssh://git@github.com/stainless-sdks/isaacus-python.git
 The full API of this library can be found in [api.md](api.md).
 
 ```python
+import os
 from isaacus import Isaacus
 
-client = Isaacus()
+client = Isaacus(
+    bearer_token=os.environ.get("ISAACUS_API_KEY"),  # This is the default and can be omitted
+)
 
-classify_universal = client.classify_universal.create(
-    model="model",
-    query="query",
-    text="text",
+universal_classification = client.classifications.universal.create(
+    model="kanon-uniclassifier",
+    query="This is a confidentiality clause.",
+    text="The Supplier agrees not to disclose to any person, other than the Customer, any Confidential Information relating to the Contract or the Goods and/or Services, without prior written approval from the Customer.",
 )
-print(classify_universal.chunks)
+print(universal_classification.chunks)
 ```
 
+While you can provide a `bearer_token` keyword argument,
+we recommend using [python-dotenv](https://pypi.org/project/python-dotenv/)
+to add `ISAACUS_API_KEY="My Bearer Token"` to your `.env` file
+so that your Bearer Token is not stored in source control.
+
 ## Async usage
 
 Simply import `AsyncIsaacus` instead of `Isaacus` and use `await` with each API call:
 
 ```python
+import os
 import asyncio
 from isaacus import AsyncIsaacus
 
-client = AsyncIsaacus()
+client = AsyncIsaacus(
+    bearer_token=os.environ.get("ISAACUS_API_KEY"),  # This is the default and can be omitted
+)
 
 
 async def main() -> None:
-    classify_universal = await client.classify_universal.create(
-        model="model",
-        query="query",
-        text="text",
+    universal_classification = await client.classifications.universal.create(
+        model="kanon-uniclassifier",
+        query="This is a confidentiality clause.",
+        text="The Supplier agrees not to disclose to any person, other than the Customer, any Confidential Information relating to the Contract or the Goods and/or Services, without prior written approval from the Customer.",
     )
-    print(classify_universal.chunks)
+    print(universal_classification.chunks)
 
 
 asyncio.run(main())
@@ -89,10 +100,10 @@ from isaacus import Isaacus
 client = Isaacus()
 
 try:
-    client.classify_universal.create(
-        model="model",
-        query="query",
-        text="text",
+    client.classifications.universal.create(
+        model="kanon-uniclassifier",
+        query="This is a confidentiality clause.",
+        text="The Supplier agrees not to disclose to any person, other than the Customer, any Confidential Information relating to the Contract or the Goods and/or Services, without prior written approval from the Customer.",
     )
 except isaacus.APIConnectionError as e:
     print("The server could not be reached")
@@ -136,10 +147,10 @@ client = Isaacus(
 )
 
 # Or, configure per-request:
-client.with_options(max_retries=5).classify_universal.create(
-    model="model",
-    query="query",
-    text="text",
+client.with_options(max_retries=5).classifications.universal.create(
+    model="kanon-uniclassifier",
+    query="This is a confidentiality clause.",
+    text="The Supplier agrees not to disclose to any person, other than the Customer, any Confidential Information relating to the Contract or the Goods and/or Services, without prior written approval from the Customer.",
 )
 ```
 
@@ -163,10 +174,10 @@ client = Isaacus(
 )
 
 # Override per-request:
-client.with_options(timeout=5.0).classify_universal.create(
-    model="model",
-    query="query",
-    text="text",
+client.with_options(timeout=5.0).classifications.universal.create(
+    model="kanon-uniclassifier",
+    query="This is a confidentiality clause.",
+    text="The Supplier agrees not to disclose to any person, other than the Customer, any Confidential Information relating to the Contract or the Goods and/or Services, without prior written approval from the Customer.",
 )
 ```
 
@@ -208,20 +219,20 @@ The "raw" Response object can be accessed by prefixing `.with_raw_response.` to
 from isaacus import Isaacus
 
 client = Isaacus()
-response = client.classify_universal.with_raw_response.create(
-    model="model",
-    query="query",
-    text="text",
+response = client.classifications.universal.with_raw_response.create(
+    model="kanon-uniclassifier",
+    query="This is a confidentiality clause.",
+    text="The Supplier agrees not to disclose to any person, other than the Customer, any Confidential Information relating to the Contract or the Goods and/or Services, without prior written approval from the Customer.",
 )
 print(response.headers.get('X-My-Header'))
 
-classify_universal = response.parse()  # get the object that `classify_universal.create()` would have returned
-print(classify_universal.chunks)
+universal = response.parse()  # get the object that `classifications.universal.create()` would have returned
+print(universal.chunks)
 ```
 
-These methods return an [`APIResponse`](https://github.com/stainless-sdks/isaacus-python/tree/main/src/isaacus/_response.py) object.
+These methods return an [`APIResponse`](https://github.com/isaacus-dev/isaacus-python/tree/main/src/isaacus/_response.py) object.
 
-The async client returns an [`AsyncAPIResponse`](https://github.com/stainless-sdks/isaacus-python/tree/main/src/isaacus/_response.py) with the same structure, the only difference being `await`able methods for reading the response content.
+The async client returns an [`AsyncAPIResponse`](https://github.com/isaacus-dev/isaacus-python/tree/main/src/isaacus/_response.py) with the same structure, the only difference being `await`able methods for reading the response content.
 
 #### `.with_streaming_response`
 
@@ -230,10 +241,10 @@ The above interface eagerly reads the full response body when you make the reque
 To stream the response body, use `.with_streaming_response` instead, which requires a context manager and only reads the response body once you call `.read()`, `.text()`, `.json()`, `.iter_bytes()`, `.iter_text()`, `.iter_lines()` or `.parse()`. In the async client, these are async methods.
 
 ```python
-with client.classify_universal.with_streaming_response.create(
-    model="model",
-    query="query",
-    text="text",
+with client.classifications.universal.with_streaming_response.create(
+    model="kanon-uniclassifier",
+    query="This is a confidentiality clause.",
+    text="The Supplier agrees not to disclose to any person, other than the Customer, any Confidential Information relating to the Contract or the Goods and/or Services, without prior written approval from the Customer.",
 ) as response:
     print(response.headers.get("X-My-Header"))
 
@@ -329,7 +340,7 @@ This package generally follows [SemVer](https://semver.org/spec/v2.0.0.html) con
 
 We take backwards-compatibility seriously and work hard to ensure you can rely on a smooth upgrade experience.
 
-We are keen for your feedback; please open an [issue](https://www.github.com/stainless-sdks/isaacus-python/issues) with questions, bugs, or suggestions.
+We are keen for your feedback; please open an [issue](https://www.github.com/isaacus-dev/isaacus-python/issues) with questions, bugs, or suggestions.
 
 ### Determining the installed version
 

SECURITY.md

@@ -20,7 +20,7 @@ or products provided by Isaacus please follow the respective company's security
 
 ### Isaacus Terms and Policies
 
-Please contact dev-feedback@isaacus.com for any questions or concerns regarding security of our services.
+Please contact security@isaacus.com for any questions or concerns regarding security of our services.
 
 ---
 

api.md

@@ -1,11 +1,13 @@
-# ClassifyUniversal
+# Classifications
+
+## Universal
 
 Types:
 
 ```python
-from isaacus.types import ClassifyUniversalCreateResponse
+from isaacus.types.classifications import UniversalClassification
 ```
 
 Methods:
 
-- <code title="post /classify/universal">client.classify_universal.<a href="./src/isaacus/resources/classify_universal.py">create</a>(\*\*<a href="src/isaacus/types/classify_universal_create_params.py">params</a>) -> <a href="./src/isaacus/types/classify_universal_create_response.py">ClassifyUniversalCreateResponse</a></code>
+- <code title="post /classifications/universal">client.classifications.universal.<a href="./src/isaacus/resources/classifications/universal.py">create</a>(\*\*<a href="src/isaacus/types/classifications/universal_create_params.py">params</a>) -> <a href="./src/isaacus/types/classifications/universal_classification.py">UniversalClassification</a></code>

bin/check-release-environment

@@ -0,0 +1,25 @@
+#!/usr/bin/env bash
+
+errors=()
+
+if [ -z "${STAINLESS_API_KEY}" ]; then
+  errors+=("The STAINLESS_API_KEY secret has not been set. Please contact Stainless for an API key & set it in your organization secrets on GitHub.")
+fi
+
+if [ -z "${PYPI_TOKEN}" ]; then
+  errors+=("The ISAACUS_PYPI_TOKEN secret has not been set. Please set it in either this repository's secrets or your organization secrets.")
+fi
+
+lenErrors=${#errors[@]}
+
+if [[ lenErrors -gt 0 ]]; then
+  echo -e "Found the following errors in the release environment:\n"
+
+  for error in "${errors[@]}"; do
+    echo -e "- $error\n"
+  done
+
+  exit 1
+fi
+
+echo "The environment is ready to push releases!"