ragwell 0.1.0__tar.gz

ragwell-0.1.0/.gitignore

@@ -0,0 +1,22 @@
+# Python environments and generated files
+.venv/
+__pycache__/
+*.py[cod]
+*.egg-info/
+build/
+dist/
+
+# Development tool caches
+.mypy_cache/
+.pytest_cache/
+.ruff_cache/
+.coverage
+.coverage.*
+htmlcov/
+
+# Local credentials and editor/OS files
+.env
+.env.*
+.DS_Store
+.idea/
+.vscode/

ragwell-0.1.0/AGENTS.md

@@ -0,0 +1,23 @@
+# Ragwell Python SDK guidance
+
+- This standalone repository contains the development Ragwell Python SDK. Read
+  `README.md`, `CONTRIBUTING.md`, and `pyproject.toml` before editing.
+- Keep changes within the requested scope. Public behavior is maintained in the
+  handwritten clients/resources; never edit `src/ragwell/_generated` by hand.
+- Support Python 3.11+ syntax and the CPython 3.11–3.14 CI matrix. Keep public
+  boundaries explicitly typed and retain `src/ragwell/py.typed` in distributions.
+- Keep runtime dependencies minimal and development tools in the development
+  dependency group. Update `uv.lock` with dependency changes; do not hand-edit it.
+- Installation, imports, builds, and ordinary tests must be independent of backend
+  imports, private repositories, credentials, provider calls, and model downloads.
+- Wire schemas come from the reviewed vendored artifact under `contracts/`.
+  Regenerate through `scripts/generate.py` and preserve the recorded digest and
+  complete 26-operation sync/async mapping.
+- Add deterministic tests for real behavior. Preserve the wheel/sdist and clean
+  installed-package checks. Run the README checks and report unavailable checks
+  accurately.
+- Never inspect local `.env` values or include secrets, customer data, or private
+  infrastructure details in source, artifacts, logs, or documentation.
+- Keep documentation truthful about development, qualification, and publication
+  status. Preserve unrelated changes.
+  Commit, push, publish, and repository-setting changes require an explicit request.

ragwell-0.1.0/CHANGELOG.md

@@ -0,0 +1,25 @@
+# Changelog
+
+## 0.1.0 — 2026-09-22
+
+First developer beta. The release uses existing-project handles and scoped machine
+credentials; project and key administration remain outside the SDK.
+
+- Complete typed sync/async coverage of the 26 reviewed machine operations, with
+  existing-project handles and scoped bearer credentials.
+- Upload, resumed waiting, lazy pagination and verified export downloads, with
+  bounded deadlines/retries and stable idempotency identity.
+- Reliability corrections for end-to-end budgets, streamed response/download caps,
+  accepted-intake recovery identifiers and redacted protocol/transport failures.
+- Reviewed contract packaged in the wheel, installed-package identity verification,
+  complete local HTTP fixture qualification, and endpoint-only test ownership.
+- Normalize installed-package inventory paths across Windows and POSIX during
+  wheel verification, retaining modified-file and unexpected-file checks.
+- Opt-in beta lifecycle validation against an independently prepared account/project,
+  with private credentials, bounded synthetic usage and checkpointed cleanup reports.
+- API reference, lifecycle examples, compatibility/security guidance and local release
+  evidence. The Linux, macOS and Windows hosted matrix passes, private vulnerability
+  reporting is enabled, and publication uses protected OIDC publishers.
+
+Project creation/administration, key management, browser identity, billing and answer
+generation are outside this SDK's current scope.

ragwell-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,65 @@
+# Contributing
+
+This repository contains the development Ragwell Python SDK. Discuss new public SDK
+capabilities in an issue before implementing them, and keep each pull request focused. Include a short
+description of the change and the checks actually run. Use synthetic examples;
+never include credentials or customer documents in code, logs, issues, or tests.
+
+## Development workflow
+
+Follow the setup and checks in [README.md](README.md). Maintained code lives in
+`src/ragwell`; generated internals live in `src/ragwell/_generated`; contract,
+behavior, and packaging tests live in `tests`. Ruff handles formatting and linting,
+mypy checks types in strict mode against Python 3.11, and pytest runs the tests.
+Every contract update must retain the complete sync/async operation map and add
+deterministic wire/failure tests. Avoid placeholder tests.
+
+The reviewed contract is vendored under `contracts/`. Regenerate only through:
+
+```sh
+uv run --locked python scripts/generate.py
+uv run --locked python scripts/generate.py --check
+```
+
+Never edit generated output by hand. Review the source artifact digest, manifest,
+generator warnings, public mapping, and wire behavior together. The SDK must remain
+buildable without the backend checkout.
+
+Run `uv run --locked ruff format .` to format changes. Check the complete
+CPython 3.11–3.14 matrix in CI before merging. Ordinary tests must run without API
+access, credentials, model downloads, or private repositories.
+
+Development tools belong in `[dependency-groups].dev`, separate from runtime
+dependencies. Review and commit `pyproject.toml` and `uv.lock` together when changing
+dependencies. To update one tool within its declared range:
+
+```sh
+uv lock --upgrade-package ruff
+uv sync --locked
+```
+
+Run all checks after an update. Keep the uv version in `pyproject.toml`, CI, and the
+README aligned. The development lock does not constrain downstream consumers.
+Runtime dependency ranges belong in `[project].dependencies`; generation tools
+remain development-only.
+The build backend is also a development dependency so `python -m build
+--no-isolation` uses the locked build tools. Its default build makes the wheel from
+the source distribution, checking that the source archive is self-contained.
+
+Tool configuration follows the official [uv project guide](https://docs.astral.sh/uv/guides/projects/),
+[Python packaging guide](https://packaging.python.org/en/latest/tutorials/packaging-projects/),
+[mypy configuration](https://mypy.readthedocs.io/en/stable/config_file.html), and
+[pytest integration guidance](https://docs.pytest.org/en/stable/explanation/goodpractices.html).
+
+## Attribution and future releases
+
+The MIT notice uses `alexd775`, the verified repository owner's GitHub handle.
+A legal person or entity name has not been supplied; confirm any replacement
+attribution with the owner rather than guessing it. PyPI name availability and
+publisher ownership remain unverified. Publication and release automation require
+separate maintainer authorization after SDK implementation and qualification.
+
+Keep the [API reference](docs/api-reference.md), [compatibility policy](docs/compatibility.md)
+and [changelog](CHANGELOG.md) current when behavior changes. Execute examples as
+part of the offline suite. Follow [release preparation](docs/releasing.md) for
+artifact/security gates and [SECURITY.md](SECURITY.md) for confidential reports.

ragwell-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 alexd775
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

ragwell-0.1.0/PKG-INFO

@@ -0,0 +1,179 @@
+Metadata-Version: 2.5
+Name: ragwell
+Version: 0.1.0
+Summary: Typed Python SDK for the Ragwell managed retrieval API
+Project-URL: Repository, https://github.com/alexd775/ragwell-python
+Project-URL: Issues, https://github.com/alexd775/ragwell-python/issues
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Requires-Dist: attrs<26,>=22.2
+Requires-Dist: httpcore<1.1,>=1.0.9
+Requires-Dist: httpx<0.29,>=0.27.2
+Requires-Dist: python-dateutil<3,>=2.8.2
+Description-Content-Type: text/markdown
+
+# Ragwell Python SDK
+
+Typed synchronous and asynchronous Python clients for Ragwell, a managed service
+for document ingestion and retrieval with source citations.
+
+**Status: `0.1.0` developer beta.** The complete reviewed machine API is implemented
+and qualified from an installed wheel against an isolated local HTTP service. The
+SDK returns retrieval evidence and citations; it does not generate answers.
+
+## Requirements and installation
+
+Python 3.11 or newer is required. Install the `ragwell` distribution from PyPI:
+
+```sh
+python -m pip install ragwell
+```
+
+For local development:
+
+```sh
+uv sync --locked --python 3.11
+```
+
+Runtime use requires an existing project grant and API key. The SDK does not create
+projects, users, keys, or billing resources. Supply the endpoint and key explicitly
+or through `RAGWELL_BASE_URL` and `RAGWELL_API_KEY`; explicit arguments win. No beta
+hostname is built into the package and no `.env` file is loaded implicitly.
+
+## Synchronous quick start
+
+```python
+import os
+from pathlib import Path
+
+from ragwell import Ragwell
+from ragwell.types import SearchFilters
+
+with Ragwell() as client:
+    project = client.project(os.environ["RAGWELL_PROJECT_ID"])
+    ready = project.documents.upload_and_wait(
+        file=Path("guide.pdf"),
+        wait_timeout=300,
+    )
+    results = project.search(
+        query="What is the retention policy?",
+        filters=SearchFilters(document_ids=[ready.intake.document.id]),
+    )
+    for item in results.items:
+        print(item.rank, item.source_filename, item.parts)
+```
+
+## Asynchronous quick start
+
+```python
+import os
+
+from ragwell import AsyncRagwell
+
+
+async def retrieve(query: str):
+    async with AsyncRagwell() as client:
+        project = client.project(os.environ["RAGWELL_PROJECT_ID"])
+        return await project.search(query=query)
+```
+
+Initialize one async client at application startup, share it within its owning event
+loop, and close it at shutdown. Injected HTTPX clients are borrowed unless
+`owns_http_client=True`; SDK-created pools are owned and closed by the SDK.
+
+## Public resource layout
+
+`client.project(project_id)` is local and performs no preflight request. Both client
+styles expose the same 26 contract operations:
+
+- `client.upload_policy.get()`
+- `project.get()` and `project.embedding_connection.get()`
+- `project.uploads.create()`, `.get()`, `.upload_content()`, and `.finalize()`
+- `project.documents.list()`, `.get()`, `.replace_metadata()`, `.delete()`,
+  `.inspect()`, and `.activity()`
+- `project.documents.generations.list()`, `.chunks.list()`, and `.sources.get()`
+- `project.documents.exports.create()`, `.get()`, `.stream_part()`, and
+  `.download_part()`
+- `project.jobs.list()`, `.get()`, `.retry()`, and `.cancel()`
+- `project.deletions.get()` and `.retry()`
+- `project.search()`
+
+Convenience workflows add `documents.upload()`, `documents.upload_and_wait()`,
+`jobs.wait()`, `deletions.wait()`, `documents.exports.wait()`, and lazy `.iter()`
+methods for documents, jobs, generations, and chunks.
+
+Generated public types and enums are available from `ragwell.types`. They preserve
+UUIDs, aware timestamps, omission through `UNSET`, explicit null, complete source
+parts and scores, command acceptance versus current resource state, and additive
+response fields through `additional_properties`.
+
+## Reliability and ownership
+
+- HTTP 202 means accepted, never completed. Waiters have finite deadlines and never
+  cancel or retry remote work implicitly.
+- Job cursors are opaque and filter/project scoped. Iterators never parse or create
+  them, stop at null, and reject repeated cursors.
+- Safe reads receive at most two bounded retries. Replayed mutations keep one
+  idempotency key for the logical command. Search is never automatically replayed.
+- `command_in_progress` may retry within the deadline using `Retry-After`; quota,
+  authorization, validation, and revision/idempotency conflicts do not.
+- Upload helpers accept paths, bytes, and seekable binary streams, hash incrementally,
+  restore caller cursors, and never close caller-owned streams. Bytes/streams need
+  an explicit filename.
+- Export saves stream to an SDK-owned temporary file in the destination directory,
+  verifies manifest byte size and SHA-256, then replaces atomically. Overwrite is
+  opt-in.
+
+See [deadlines, bounds and recovery](docs/reliability.md) for timeout-zero behavior,
+transfer budgets, cancellation, decoded-body caps and accepted-intake recovery IDs.
+
+Errors derive from `RagwellError`. `ApiError` preserves safe status/code, field
+errors, quota detail, retry hints, operation ID, and server `X-Request-ID`. Transport,
+protocol, wait-timeout, terminal-operation, pagination, and integrity failures are
+distinct. Exceptions do not include keys, request bodies, queries, raw HTML, or
+document content.
+
+## Development and qualification
+
+```sh
+uv run --locked ruff format --check .
+uv run --locked ruff check .
+uv run --locked mypy
+uv run --locked python scripts/generate.py --check
+uv run --locked pytest
+uv run --locked python -m build --no-isolation
+```
+
+The vendored artifact is `2026-09-19.1`, machine SHA-256
+`8e05de4ae0f3aa76261e97ad07be1fc77756f317c3e2c20ab2be3efb2cb6db90`.
+See [contract provenance](contracts/README.md),
+[generation qualification](docs/generation.md), and
+[operation mapping](contracts/operations.json). Ordinary tests require no service,
+credentials, provider calls, private repository, or model downloads.
+
+The reviewed artifact is available in the public repository. Local installed-wheel HTTP qualification
+is recorded in [HTTP qualification](docs/http-qualification.md). The
+[release process](docs/releasing.md) records exact-artifact TestPyPI/PyPI controls.
+
+An optional [beta lifecycle validation](docs/beta-validation.md) checks the installed
+wheel against a dedicated existing beta project with a scoped key. It starts no
+services and is separate from the full fixture matrix and ordinary offline CI.
+
+Documentation: [API reference and scopes](docs/api-reference.md),
+[sync lifecycle example](examples/sync_lifecycle.py),
+[async lifecycle example](examples/async_lifecycle.py),
+[compatibility and support](docs/compatibility.md), [security policy](SECURITY.md),
+[changelog](CHANGELOG.md), and [release preparation](docs/releasing.md).
+
+## License
+
+[MIT](LICENSE).

ragwell-0.1.0/README.md

@@ -0,0 +1,156 @@
+# Ragwell Python SDK
+
+Typed synchronous and asynchronous Python clients for Ragwell, a managed service
+for document ingestion and retrieval with source citations.
+
+**Status: `0.1.0` developer beta.** The complete reviewed machine API is implemented
+and qualified from an installed wheel against an isolated local HTTP service. The
+SDK returns retrieval evidence and citations; it does not generate answers.
+
+## Requirements and installation
+
+Python 3.11 or newer is required. Install the `ragwell` distribution from PyPI:
+
+```sh
+python -m pip install ragwell
+```
+
+For local development:
+
+```sh
+uv sync --locked --python 3.11
+```
+
+Runtime use requires an existing project grant and API key. The SDK does not create
+projects, users, keys, or billing resources. Supply the endpoint and key explicitly
+or through `RAGWELL_BASE_URL` and `RAGWELL_API_KEY`; explicit arguments win. No beta
+hostname is built into the package and no `.env` file is loaded implicitly.
+
+## Synchronous quick start
+
+```python
+import os
+from pathlib import Path
+
+from ragwell import Ragwell
+from ragwell.types import SearchFilters
+
+with Ragwell() as client:
+    project = client.project(os.environ["RAGWELL_PROJECT_ID"])
+    ready = project.documents.upload_and_wait(
+        file=Path("guide.pdf"),
+        wait_timeout=300,
+    )
+    results = project.search(
+        query="What is the retention policy?",
+        filters=SearchFilters(document_ids=[ready.intake.document.id]),
+    )
+    for item in results.items:
+        print(item.rank, item.source_filename, item.parts)
+```
+
+## Asynchronous quick start
+
+```python
+import os
+
+from ragwell import AsyncRagwell
+
+
+async def retrieve(query: str):
+    async with AsyncRagwell() as client:
+        project = client.project(os.environ["RAGWELL_PROJECT_ID"])
+        return await project.search(query=query)
+```
+
+Initialize one async client at application startup, share it within its owning event
+loop, and close it at shutdown. Injected HTTPX clients are borrowed unless
+`owns_http_client=True`; SDK-created pools are owned and closed by the SDK.
+
+## Public resource layout
+
+`client.project(project_id)` is local and performs no preflight request. Both client
+styles expose the same 26 contract operations:
+
+- `client.upload_policy.get()`
+- `project.get()` and `project.embedding_connection.get()`
+- `project.uploads.create()`, `.get()`, `.upload_content()`, and `.finalize()`
+- `project.documents.list()`, `.get()`, `.replace_metadata()`, `.delete()`,
+  `.inspect()`, and `.activity()`
+- `project.documents.generations.list()`, `.chunks.list()`, and `.sources.get()`
+- `project.documents.exports.create()`, `.get()`, `.stream_part()`, and
+  `.download_part()`
+- `project.jobs.list()`, `.get()`, `.retry()`, and `.cancel()`
+- `project.deletions.get()` and `.retry()`
+- `project.search()`
+
+Convenience workflows add `documents.upload()`, `documents.upload_and_wait()`,
+`jobs.wait()`, `deletions.wait()`, `documents.exports.wait()`, and lazy `.iter()`
+methods for documents, jobs, generations, and chunks.
+
+Generated public types and enums are available from `ragwell.types`. They preserve
+UUIDs, aware timestamps, omission through `UNSET`, explicit null, complete source
+parts and scores, command acceptance versus current resource state, and additive
+response fields through `additional_properties`.
+
+## Reliability and ownership
+
+- HTTP 202 means accepted, never completed. Waiters have finite deadlines and never
+  cancel or retry remote work implicitly.
+- Job cursors are opaque and filter/project scoped. Iterators never parse or create
+  them, stop at null, and reject repeated cursors.
+- Safe reads receive at most two bounded retries. Replayed mutations keep one
+  idempotency key for the logical command. Search is never automatically replayed.
+- `command_in_progress` may retry within the deadline using `Retry-After`; quota,
+  authorization, validation, and revision/idempotency conflicts do not.
+- Upload helpers accept paths, bytes, and seekable binary streams, hash incrementally,
+  restore caller cursors, and never close caller-owned streams. Bytes/streams need
+  an explicit filename.
+- Export saves stream to an SDK-owned temporary file in the destination directory,
+  verifies manifest byte size and SHA-256, then replaces atomically. Overwrite is
+  opt-in.
+
+See [deadlines, bounds and recovery](docs/reliability.md) for timeout-zero behavior,
+transfer budgets, cancellation, decoded-body caps and accepted-intake recovery IDs.
+
+Errors derive from `RagwellError`. `ApiError` preserves safe status/code, field
+errors, quota detail, retry hints, operation ID, and server `X-Request-ID`. Transport,
+protocol, wait-timeout, terminal-operation, pagination, and integrity failures are
+distinct. Exceptions do not include keys, request bodies, queries, raw HTML, or
+document content.
+
+## Development and qualification
+
+```sh
+uv run --locked ruff format --check .
+uv run --locked ruff check .
+uv run --locked mypy
+uv run --locked python scripts/generate.py --check
+uv run --locked pytest
+uv run --locked python -m build --no-isolation
+```
+
+The vendored artifact is `2026-09-19.1`, machine SHA-256
+`8e05de4ae0f3aa76261e97ad07be1fc77756f317c3e2c20ab2be3efb2cb6db90`.
+See [contract provenance](contracts/README.md),
+[generation qualification](docs/generation.md), and
+[operation mapping](contracts/operations.json). Ordinary tests require no service,
+credentials, provider calls, private repository, or model downloads.
+
+The reviewed artifact is available in the public repository. Local installed-wheel HTTP qualification
+is recorded in [HTTP qualification](docs/http-qualification.md). The
+[release process](docs/releasing.md) records exact-artifact TestPyPI/PyPI controls.
+
+An optional [beta lifecycle validation](docs/beta-validation.md) checks the installed
+wheel against a dedicated existing beta project with a scoped key. It starts no
+services and is separate from the full fixture matrix and ordinary offline CI.
+
+Documentation: [API reference and scopes](docs/api-reference.md),
+[sync lifecycle example](examples/sync_lifecycle.py),
+[async lifecycle example](examples/async_lifecycle.py),
+[compatibility and support](docs/compatibility.md), [security policy](SECURITY.md),
+[changelog](CHANGELOG.md), and [release preparation](docs/releasing.md).
+
+## License
+
+[MIT](LICENSE).

ragwell-0.1.0/SECURITY.md

@@ -0,0 +1,30 @@
+# Security policy
+
+This policy covers the `0.1.0` developer beta and its release candidate. There is no
+guaranteed response-time SLA. Maintenance initially covers the current 0.x minor.
+
+## Reporting a vulnerability
+
+Do not put API keys, credentials, document/query contents, exploit details involving
+other tenants, or raw HTTP dumps in public GitHub issues.
+
+Use GitHub's private “Report a vulnerability” route for this repository. Private
+vulnerability reporting was verified enabled on 2026-09-22. Use public issues only
+for non-sensitive defects and questions.
+
+When a private route is available, include a minimal synthetic reproduction, affected
+SDK/API contract versions, impact, and safe request IDs. Avoid sending active keys
+or customer documents. Rotate a suspected exposed API key through normal account
+administration; the SDK cannot rotate or revoke keys.
+
+## Maintainer checks
+
+Keep dependency, secret and distribution scans with each release's evidence. Review
+runtime and development dependencies, preserve license notices, and scan source plus
+wheel/sdist contents. A passing advisory scan is a point-in-time check, not a claim
+that every defect or secret has been ruled out. Keep CI for forks credential-free.
+SDK/API endpoint tests must use dedicated synthetic projects and scoped keys.
+
+Use a reviewed immutable artifact, protected publisher and recorded provenance.
+Do not publish when the required CI, package ownership or reporting-channel gates
+are unresolved. See [release preparation](docs/releasing.md).

ragwell-0.1.0/contracts/2026-09-19.1/manifest.json

@@ -0,0 +1,140 @@
+{
+  "api_info_version": "0.1.0",
+  "artifact_version": "2026-09-19.1",
+  "canonical_sha256": "57a1f942f7ca8b89186753a20320588b57e2425663b8529b36037066c02328bb",
+  "compatibility_notes": "See contracts/machine/README.md. Artifact identity is its digest, not runtime version equality. Installed Python SDK qualification and public publication remain separate release gates.",
+  "machine_sha256": "8e05de4ae0f3aa76261e97ad07be1fc77756f317c3e2c20ab2be3efb2cb6db90",
+  "operation_count": 26,
+  "operations": [
+    {
+      "method": "GET",
+      "operation_id": "get_document_upload_policy_v1_document_upload_policy_get",
+      "path": "/v1/document-upload-policy"
+    },
+    {
+      "method": "GET",
+      "operation_id": "get_project_v1_projects__project_id__get",
+      "path": "/v1/projects/{project_id}"
+    },
+    {
+      "method": "GET",
+      "operation_id": "get_document_deletion_v1_projects__project_id__document_deletions__receipt_id__get",
+      "path": "/v1/projects/{project_id}/document-deletions/{receipt_id}"
+    },
+    {
+      "method": "POST",
+      "operation_id": "retry_document_deletion_v1_projects__project_id__document_deletions__receipt_id__retry_post",
+      "path": "/v1/projects/{project_id}/document-deletions/{receipt_id}/retry"
+    },
+    {
+      "method": "GET",
+      "operation_id": "list_documents_v1_projects__project_id__documents_get",
+      "path": "/v1/projects/{project_id}/documents"
+    },
+    {
+      "method": "DELETE",
+      "operation_id": "delete_document_v1_projects__project_id__documents__document_id__delete",
+      "path": "/v1/projects/{project_id}/documents/{document_id}"
+    },
+    {
+      "method": "GET",
+      "operation_id": "get_document_v1_projects__project_id__documents__document_id__get",
+      "path": "/v1/projects/{project_id}/documents/{document_id}"
+    },
+    {
+      "method": "GET",
+      "operation_id": "get_document_activity_v1_projects__project_id__documents__document_id__activity_get",
+      "path": "/v1/projects/{project_id}/documents/{document_id}/activity"
+    },
+    {
+      "method": "POST",
+      "operation_id": "create_document_export_v1_projects__project_id__documents__document_id__exports_post",
+      "path": "/v1/projects/{project_id}/documents/{document_id}/exports"
+    },
+    {
+      "method": "GET",
+      "operation_id": "get_document_export_v1_projects__project_id__documents__document_id__exports__export_id__get",
+      "path": "/v1/projects/{project_id}/documents/{document_id}/exports/{export_id}"
+    },
+    {
+      "method": "GET",
+      "operation_id": "download_document_export_part_v1_projects__project_id__documents__document_id__exports__export_id__parts__part_number__get",
+      "path": "/v1/projects/{project_id}/documents/{document_id}/exports/{export_id}/parts/{part_number}"
+    },
+    {
+      "method": "GET",
+      "operation_id": "list_document_generations_v1_projects__project_id__documents__document_id__generations_get",
+      "path": "/v1/projects/{project_id}/documents/{document_id}/generations"
+    },
+    {
+      "method": "GET",
+      "operation_id": "list_document_chunks_v1_projects__project_id__documents__document_id__generations__generation_id__chunks_get",
+      "path": "/v1/projects/{project_id}/documents/{document_id}/generations/{generation_id}/chunks"
+    },
+    {
+      "method": "GET",
+      "operation_id": "inspect_document_source_v1_projects__project_id__documents__document_id__generations__generation_id__sources__source_id__get",
+      "path": "/v1/projects/{project_id}/documents/{document_id}/generations/{generation_id}/sources/{source_id}"
+    },
+    {
+      "method": "GET",
+      "operation_id": "inspect_document_v1_projects__project_id__documents__document_id__inspection_get",
+      "path": "/v1/projects/{project_id}/documents/{document_id}/inspection"
+    },
+    {
+      "method": "PUT",
+      "operation_id": "replace_document_metadata_v1_projects__project_id__documents__document_id__metadata_put",
+      "path": "/v1/projects/{project_id}/documents/{document_id}/metadata"
+    },
+    {
+      "method": "GET",
+      "operation_id": "inspect_embedding_connection_v1_projects__project_id__embedding_connection_get",
+      "path": "/v1/projects/{project_id}/embedding-connection"
+    },
+    {
+      "method": "GET",
+      "operation_id": "list_jobs_v1_projects__project_id__jobs_get",
+      "path": "/v1/projects/{project_id}/jobs"
+    },
+    {
+      "method": "GET",
+      "operation_id": "get_job_v1_projects__project_id__jobs__job_id__get",
+      "path": "/v1/projects/{project_id}/jobs/{job_id}"
+    },
+    {
+      "method": "POST",
+      "operation_id": "cancel_job_v1_projects__project_id__jobs__job_id__cancel_post",
+      "path": "/v1/projects/{project_id}/jobs/{job_id}/cancel"
+    },
+    {
+      "method": "POST",
+      "operation_id": "retry_job_v1_projects__project_id__jobs__job_id__retry_post",
+      "path": "/v1/projects/{project_id}/jobs/{job_id}/retry"
+    },
+    {
+      "method": "POST",
+      "operation_id": "search_v1_projects__project_id__search_post",
+      "path": "/v1/projects/{project_id}/search"
+    },
+    {
+      "method": "POST",
+      "operation_id": "create_upload_v1_projects__project_id__uploads_post",
+      "path": "/v1/projects/{project_id}/uploads"
+    },
+    {
+      "method": "GET",
+      "operation_id": "get_upload_state",
+      "path": "/v1/projects/{project_id}/uploads/{upload_id}"
+    },
+    {
+      "method": "PUT",
+      "operation_id": "upload_content_v1_projects__project_id__uploads__upload_id__content_put",
+      "path": "/v1/projects/{project_id}/uploads/{upload_id}/content"
+    },
+    {
+      "method": "POST",
+      "operation_id": "finalize_upload_v1_projects__project_id__uploads__upload_id__finalize_post",
+      "path": "/v1/projects/{project_id}/uploads/{upload_id}/finalize"
+    }
+  ]
+}