The open-source agent harness - the runtime layer that turns an LLM into a working agent.
feat: add Fern-generated Python SDK alongside TypeScript (#710)
Bhavesh Patel824204676ae4
diff --git a/.changeset/20260912205155-regenerate-sdk-from-openapi.md b/.changeset/20260912205155-regenerate-sdk-from-openapi.mdnew file mode 100644index 000000000..efd8ff00f--- /dev/null+++ b/.changeset/20260912205155-regenerate-sdk-from-openapi.md@@ -0,0 +1,5 @@+---+"@truefoundry/trueforge-sdk": patch+---++Regenerate SDK from updated OpenAPI spec.diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.mdindex b52f30d6a..15271217f 100644--- a/.github/PULL_REQUEST_TEMPLATE.md+++ b/.github/PULL_REQUEST_TEMPLATE.md@@ -17,5 +17,5 @@ Closes #<add-issue-number-here>- [ ] I have read the [contributing guidelines](https://github.com/truefoundry/trueforge/blob/main/CONTRIBUTING.md)- [ ] `pnpm build`, `pnpm test`, `pnpm typecheck`, `pnpm lint:ci`, and `pnpm format:check` pass locally- [ ] Tests added/updated where it makes sense-- [ ] No hand-edits to generated code (`packages/trueforge-sdk`, `.github/fern/openapi/openapi.json`, `docs/openapi.json`) — fork PRs omit SDK regen; maintainers regenerate after merge+- [ ] No hand-edits to generated code (`packages/trueforge-sdk`, `python/trueforge_sdk`, `.github/fern/openapi/openapi.json`, `docs/openapi.json`) — fork PRs omit SDK regen; maintainers regenerate after merge- [ ] Docs / `.env.example` updated if configuration or behavior changeddiff --git a/.github/fern/generators.yml b/.github/fern/generators.ymlindex 2829cb8b7..63bde8ded 100644--- a/.github/fern/generators.yml+++ b/.github/fern/generators.yml@@ -4,7 +4,7 @@readme:apiName: TrueForgeintroduction: >- TypeScript client for the TrueForge Agent Harness Server: a self-hosted+ API client for the TrueForge Agent Harness Server: a self-hostedruntime that executes agent turns and streams them over Server-Sent Events.@@ -100,3 +100,29 @@ groups:streamType: webuseDefaultRequestParameterValues: truesmart-casing: true+ # `local-file-system` allows no `github` block, so the workflow commits the result itself.+ python-sdk:+ generators:+ - name: fernapi/fern-python-sdk+ version: 5.29.0+ output:+ location: local-file-system+ path: ../../python/trueforge_sdk+ config:+ # Import name; PyPI install trueforge-sdk resolves via PEP 503.+ package_name: trueforge_sdk+ optional_auth: true+ stream_abstraction: true+ use_request_defaults: all+ inline_path_params: true+ pydantic_config:+ enum_type: forward_compatible_python_enums+ frozen: false+ skip_validation: true+ client:+ class_name: BaseTrueForge+ filename: base_client.py+ exported_class_name: TrueForge+ exported_filename: client.py+ pyproject_python_version: '>=3.10'+ smart-casing: truediff --git a/.github/workflows/generate-sdk.yaml b/.github/workflows/generate-sdk.yamlindex 7efa814e8..0afde503b 100644--- a/.github/workflows/generate-sdk.yaml+++ b/.github/workflows/generate-sdk.yaml@@ -1,6 +1,6 @@name: Generate SDK-# Regenerates the OpenAPI document and the SDK, and commits both to the branch.+# Regenerates the OpenAPI document and the SDKs, and commits them to the branch.# Fork PRs cannot receive that commit; main regenerates after merge.on:# Manual regen on main if the post-merge push job missed or failed.@@ -14,6 +14,7 @@ on:- 'packages/trueforge-core/src/**'- '.github/fern/**'- '.github/workflows/generate-sdk.yaml'+ - 'scripts/generate-sdk.sh'pull_request:types: [opened, synchronize, reopened]paths:@@ -22,6 +23,7 @@ on:- 'packages/trueforge-core/src/**'- '.github/fern/**'- '.github/workflows/generate-sdk.yaml'+ - 'scripts/generate-sdk.sh'concurrency:group: generate-sdk-${{ github.head_ref || github.ref_name }}@@ -32,7 +34,7 @@ permissions:jobs:generate:- name: Generate OpenAPI and TypeScript SDK+ name: Generate OpenAPI and SDKsruns-on: ubuntu-latesttimeout-minutes: 30# A pull_request path filter matches the whole PR, not just the new commit,@@ -110,7 +112,7 @@ jobs:elif ! git rev-parse --verify --quiet "${BASE_SHA}^{commit}" >/dev/null; then# A branch's first push reports an all-zero base commit.reason="there is no base commit to compare against"- elif ! git diff --quiet "$BASE_SHA" HEAD -- .github/fern/generators.yml .github/fern/fern.config.json; then+ elif ! git diff --quiet "$BASE_SHA" HEAD -- .github/fern/generators.yml .github/fern/fern.config.json scripts/generate-sdk.sh; thenreason="the generator config changed"fi@@ -124,7 +126,7 @@ jobs:# Same entrypoint as local `pnpm sdk:generate` (re-runs openapi:write; idempotent).# App-token success = we can push; forks skip Fern so a flake cannot block the PR.- - name: Generate OpenAPI document and TypeScript SDK+ - name: Generate OpenAPI document and SDKsif: steps.decide.outputs.needed == 'true' && steps.app-token.outcome == 'success'run: pnpm sdk:generate@@ -141,8 +143,8 @@ jobs:# --porcelain, not `git diff`, so new files count too.# docs/openapi.json is a second copy of the same document (Mintlify); keep it# in the same commit as .github/fern/openapi or the docs site drifts.- if [ -z "$(git status --porcelain -- .github/fern/openapi docs/openapi.json packages/trueforge-sdk pnpm-lock.yaml)" ]; then- echo "OpenAPI document and SDK are already up to date."+ if [ -z "$(git status --porcelain -- .github/fern/openapi docs/openapi.json packages/trueforge-sdk python/trueforge_sdk pnpm-lock.yaml)" ]; then+ echo "OpenAPI document and SDKs are already up to date."exit 0fi@@ -152,12 +154,13 @@ jobs:# Bot-authored sdk diffs need a changeset; the PR author never touches this commit.# Skip packages/trueforge-sdk/.fern — Fern metadata only, not a consumer-facing change.# changeset:sdk-regen is a no-op if the sdk is already named in a pending file.+ # Python is not Changesets-published yet; do not add it here.if [ -n "$(git status --porcelain -- packages/trueforge-sdk ':!packages/trueforge-sdk/.fern')" ]; thenpnpm changeset:sdk-regenfi- git add .github/fern/openapi docs/openapi.json packages/trueforge-sdk pnpm-lock.yaml .changeset- git commit -m "Regenerate OpenAPI document and TypeScript SDK"+ git add .github/fern/openapi docs/openapi.json packages/trueforge-sdk python/trueforge_sdk pnpm-lock.yaml .changeset+ git commit -m "Regenerate OpenAPI document and SDKs"git push origin "HEAD:refs/heads/$BRANCH"- name: Report skipped commit on fork@@ -168,7 +171,7 @@ jobs:echo "### Fork pull request"echoecho "OpenAPI/SDK commits are skipped on forks (GitHub Apps cannot push to the head repo)."- echo "Do not hand-edit \`packages/trueforge-sdk\` or the OpenAPI documents."+ echo "Do not hand-edit \`packages/trueforge-sdk\`, \`python/trueforge_sdk\`, or the OpenAPI documents."echo "After merge, **Generate SDK** on \`main\` regenerates both (or run it manually from Actions)."} >> "$GITHUB_STEP_SUMMARY"echo "::notice::Fork PR: OpenAPI/SDK will be regenerated on main after merge. Do not hand-edit generated files."diff --git a/.prettierignore b/.prettierignoreindex a1a6038a6..9ac097918 100644--- a/.prettierignore+++ b/.prettierignore@@ -3,6 +3,7 @@ dist/.changeset/# Fern-generated: formatted by the generator, not by this repo's config.packages/trueforge-sdk/+python/trueforge_sdk/.github/fern/openapi/# Ignore generated openapi.json in docsdocs/openapi.jsondiff --git a/AGENTS.md b/AGENTS.mdindex c78027176..3b5b1ddf3 100644--- a/AGENTS.md+++ b/AGENTS.md@@ -13,7 +13,7 @@- A change that makes code unused MUST remove that dead code in the same change; it MUST NOT leave stale exports, files, documentation, duplicates, or “just in case” shims.- Every nested `AGENTS.md` MUST have a sibling `CLAUDE.md` containing only `@AGENTS.md`, so Cursor and Claude Code load the same scoped rules.- OpenAPI specs under `.github/fern/openapi/openapi.json` and `docs/openapi.json` are autogenerated in CI and MUST NOT be edited manually (both copies MUST stay identical)-- Code under `packages/trueforge-sdk` is autogenerated in CI and MUST NOT be edited manually+- Code under `packages/trueforge-sdk` and `python/trueforge_sdk` is autogenerated in CI and MUST NOT be edited manually- Tests MUST live under a package-top-level `test` or `tests` directory that mirrors the `src` layout; they MUST NOT be inlined under `src`.- Functions with more than one parameter of the same type MUST take a single options object (e.g. `f({ a, b }: { a: string; b: string })`); they MUST NOT use multiple positional parameters of that repeated type (e.g. `f(a: string, b: string)`).- Zod unions MUST use `z.discriminatedUnion` whenever every member carries a shared literal discriminator field; `z.union` is only permitted when no such common discriminator exists.diff --git a/CONTRIBUTING.md b/CONTRIBUTING.mdindex 1a5309636..ed46cedcc 100644--- a/CONTRIBUTING.md+++ b/CONTRIBUTING.md@@ -71,6 +71,7 @@ This is a pnpm workspace:| `@truefoundry/trueforge-core` | `@truefoundry/trueforge-core` | [`packages/trueforge-core`](packages/trueforge-core) | Library: agent core, sessions, and streaming || `@truefoundry/trueforge-ui` | `@truefoundry/trueforge-ui` | [`packages/trueforge-ui`](packages/trueforge-ui) | Embeddable agent chat UI SDK || `@truefoundry/trueforge-sdk` | `@truefoundry/trueforge-sdk` | [`packages/trueforge-sdk`](packages/trueforge-sdk) | Generated TypeScript API client |+| `trueforge_sdk` | `trueforge-sdk` (PyPI) | [`python/trueforge_sdk`](python/trueforge_sdk) | Generated Python API client || `frontend` | - | [`packages/frontend`](packages/frontend) | Chat UI app (bundled into the server) |## Setup@@ -218,7 +219,7 @@ Open [http://localhost:8791](http://localhost:8791). Credentials come from `pack## Generated code - do not edit by hand-- [`packages/trueforge-sdk`](packages/trueforge-sdk), [`.github/fern/openapi/openapi.json`](.github/fern/openapi/openapi.json), and [`docs/openapi.json`](docs/openapi.json) are generated and committed. Edit route handlers under `packages/trueforge/src/routes/` instead; CI regenerates the outputs. To regenerate locally (Docker required): `pnpm sdk:generate`.+- [`packages/trueforge-sdk`](packages/trueforge-sdk), [`python/trueforge_sdk`](python/trueforge_sdk), [`.github/fern/openapi/openapi.json`](.github/fern/openapi/openapi.json), and [`docs/openapi.json`](docs/openapi.json) are generated and committed. Edit route handlers under `packages/trueforge/src/routes/` instead; CI regenerates the outputs. To regenerate locally (Docker required): `pnpm sdk:generate`.- Catalog YAML files under `packages/trueforge/catalog/` are inlined at build time by `build:gen` scripts.## Server entry pointsdiff --git a/packages/trueforge-sdk/README.md b/packages/trueforge-sdk/README.mdindex ebde28230..100d4a33f 100644--- a/packages/trueforge-sdk/README.md+++ b/packages/trueforge-sdk/README.md@@ -3,7 +3,7 @@[](https://buildwithfern.com?utm_source=github&utm_medium=github&utm_campaign=readme&utm_source=Truefoundry%2FTypeScript)[](https://www.npmjs.com/package/@truefoundry/trueforge-sdk)-TypeScript client for the TrueForge Agent Harness Server: a self-hosted runtime that executes agent turns and streams them over Server-Sent Events.+API client for the TrueForge Agent Harness Server: a self-hosted runtime that executes agent turns and streams them over Server-Sent Events.When auth is enabled on the server, pass an ID token via the optional `token` client option (`Authorization: Bearer`).diff --git a/python/trueforge_sdk/.fern/metadata.json b/python/trueforge_sdk/.fern/metadata.jsonnew file mode 100644index 000000000..585bc5d93--- /dev/null+++ b/python/trueforge_sdk/.fern/metadata.json@@ -0,0 +1,29 @@+{+ "cliVersion": "5.106.1",+ "generatorName": "fernapi/fern-python-sdk",+ "generatorVersion": "5.29.0",+ "generatorConfig": {+ "package_name": "trueforge_sdk",+ "optional_auth": true,+ "stream_abstraction": true,+ "use_request_defaults": "all",+ "inline_path_params": true,+ "pydantic_config": {+ "enum_type": "forward_compatible_python_enums",+ "frozen": false,+ "skip_validation": true+ },+ "client": {+ "class_name": "BaseTrueForge",+ "filename": "base_client.py",+ "exported_class_name": "TrueForge",+ "exported_filename": "client.py"+ },+ "pyproject_python_version": ">=3.10"+ },+ "originGitCommit": "8c203b7efd260ec945828754b39ab77a85d65b1b",+ "originGitCommitIsDirty": false,+ "invokedBy": "ci",+ "requestedVersion": "0.2.0-rc.5",+ "ciProvider": "github"+}\ No newline at end of filediff --git a/python/trueforge_sdk/CONTRIBUTING.md b/python/trueforge_sdk/CONTRIBUTING.mdnew file mode 100644index 000000000..af948ce72--- /dev/null+++ b/python/trueforge_sdk/CONTRIBUTING.md@@ -0,0 +1,125 @@+# Contributing++Thanks for your interest in contributing to this SDK! This document provides guidelines for contributing to the project.++## Getting Started++### Prerequisites++- Python 3.9++- pip+- poetry++### Installation++Install the project dependencies:++```bash+poetry install+```++### Building++Build the project:++```bash+poetry build+```++### Testing++Run the test suite:++```bash+poetry run pytest+```++### Linting and Formatting++Check code style:++```bash+poetry run ruff check .+poetry run ruff format .+```++### Type Checking++Run the type checker:++```bash+poetry run mypy .+```++## About Generated Code++**Important**: Most files in this SDK are automatically generated by [Fern](https://buildwithfern.com) from the API definition. Direct modifications to generated files will be overwritten the next time the SDK is generated.++### Generated Files++The following directories contain generated code:+- `src/` - API client classes and types+- Most Python files in the project++### How to Customize++If you need to customize the SDK, you have two options:++#### Option 1: Use `.fernignore`++For custom code that should persist across SDK regenerations:++1. Create a `.fernignore` file in the project root+2. Add file patterns for files you want to preserve (similar to `.gitignore` syntax)+3. Add your custom code to those files++Files listed in `.fernignore` will not be overwritten when the SDK is regenerated.++For more information, see the [Fern documentation on custom code](https://buildwithfern.com/learn/sdks/overview/custom-code).++#### Option 2: Contribute to the Generator++If you want to change how code is generated for all users of this SDK:++1. The Python SDK generator lives in the [Fern repository](https://github.com/fern-api/fern)+2. Generator code is located at `generators/python-v2/`+3. Follow the [Fern contributing guidelines](https://github.com/fern-api/fern/blob/main/CONTRIBUTING.md)+4. Submit a pull request with your changes to the generator++This approach is best for:+- Bug fixes in generated code+- New features that would benefit all users+- Improvements to code generation patterns++## Making Changes++### Workflow++1. Create a new branch for your changes+2. Make your modifications+3. Run tests to ensure nothing breaks: `poetry run pytest`+4. Run linting and formatting: `poetry run ruff check .` and `poetry run ruff format .`+5. Run type checking: `poetry run mypy .`+6. Build the project: `poetry build`+7. Commit your changes with a clear commit message+8. Push your branch and create a pull request++### Commit Messages++Write clear, descriptive commit messages that explain what changed and why.++### Code Style++This project uses automated code formatting and linting. Run `poetry run ruff format .` and `poetry run ruff check .` before committing to ensure your code meets the project's style guidelines.++## Questions or Issues?++If you have questions or run into issues:++1. Check the [Fern documentation](https://buildwithfern.com)+2. Search existing [GitHub issues](https://github.com/fern-api/fern/issues)+3. Open a new issue if your question hasn't been addressed++## License++By contributing to this project, you agree that your contributions will be licensed under the same license as the project.diff --git a/python/trueforge_sdk/README.md b/python/trueforge_sdk/README.mdnew file mode 100644index 000000000..ec8d61927--- /dev/null+++ b/python/trueforge_sdk/README.md@@ -0,0 +1,226 @@+# TrueForge Python Library++[](https://buildwithfern.com?utm_source=github&utm_medium=github&utm_campaign=readme&utm_source=Truefoundry%2FPython)+[](https://pypi.python.org/pypi/trueforge_sdk)++API client for the TrueForge Agent Harness Server: a self-hosted runtime that executes agent turns and streams them over Server-Sent Events.++When auth is enabled on the server, pass an ID token via the optional `token` client option (`Authorization: Bearer`).+++## Table of Contents++- [Documentation](#documentation)+- [Installation](#installation)+- [Reference](#reference)+- [Usage](#usage)+- [Async Client](#async-client)+- [Exception Handling](#exception-handling)+- [Streaming](#streaming)+- [Pagination](#pagination)+- [Advanced](#advanced)+ - [Access Raw Response Data](#access-raw-response-data)+ - [Retries](#retries)+ - [Timeouts](#timeouts)+ - [Custom Client](#custom-client)+- [Contributing](#contributing)++## Documentation++API reference documentation is available [here](https://trueforge.dev/api/use-agent).++## Installation++```sh+pip install trueforge_sdk+```++## Reference++A full reference for this library is available [here](./reference.md).++## Usage++Instantiate and use the client with the following:++```python+from trueforge_sdk import TrueForge++client = TrueForge(+ token="<token>",+ base_url="https://yourhost.com/path/to/api",+)++client.sessions.create_turn_stream(+ session_id="session_id",+)+```++## Async Client++The SDK also exports an `async` client so that you can make non-blocking calls to our API. Note that if you are constructing an Async httpx client class to pass into this client, use `httpx.AsyncClient()` instead of `httpx.Client()` (e.g. for the `httpx_client` parameter of this client).++```python+import asyncio++from trueforge_sdk import AsyncTrueForge++client = AsyncTrueForge(+ token="<token>",+ base_url="https://yourhost.com/path/to/api",+)+++async def main() -> None:+ async for chunk in client.sessions.create_turn_stream(...):+ print(chunk)+++asyncio.run(main())+```++## Exception Handling++When the API returns a non-success status code (4xx or 5xx response), a subclass of the following error+will be thrown.++```python+from trueforge_sdk.core.api_error import ApiError++try:+ client.sessions.create_turn_stream(...)+except ApiError as e:+ print(e.status_code)+ print(e.body)+```++## Streaming++The SDK supports streaming responses, as well, the response will be a generator that you can loop over.++```python+from trueforge_sdk import TrueForge++client = TrueForge(+ token="<token>",+ base_url="https://yourhost.com/path/to/api",+)++client.sessions.create_turn_stream(+ session_id="session_id",+)+```++## Pagination++Paginated requests will return a `SyncPager` or `AsyncPager`, which can be used as generators for the underlying object.++```python+from trueforge_sdk import TrueForge++client = TrueForge(+ token="<token>",+ base_url="https://yourhost.com/path/to/api",+)++client.agents.list()+```++```python+# You can also iterate through pages and access the typed response per page+pager = client.agents.list(...)+for page in pager.iter_pages():+ print(page.response) # access the typed response for each page+ for item in page:+ print(item)+```++## Advanced++### Access Raw Response Data++The SDK provides access to raw response data, including headers, through the `.with_raw_response` property.+The `.with_raw_response` property returns a "raw" client that can be used to access the `.headers` and `.data` attributes.++```python+from trueforge_sdk import TrueForge++client = TrueForge(...)+response = client.sessions.with_raw_response.create_turn_stream(...)+print(response.headers) # access the response headers+print(response.status_code) # access the response status code+print(response.data) # access the underlying object+```++### Retries++The SDK is instrumented with automatic retries with exponential backoff. A request will be retried as long+as the request is deemed retryable and the number of retry attempts has not grown larger than the configured+retry limit (default: 2).++Which status codes are retried depends on the `retryStatusCodes` generator configuration:++**`legacy`** (current default): retries on+- [408](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/408) (Timeout)+- [409](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/409) (Conflict)+- [429](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/429) (Too Many Requests)+- [5XX](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status#server_error_responses) (All server errors, including 500)++**`recommended`**: retries on+- [408](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/408) (Timeout)+- [409](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/409) (Conflict)+- [429](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/429) (Too Many Requests)+- [502](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/502) (Bad Gateway)+- [503](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/503) (Service Unavailable)+- [504](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/504) (Gateway Timeout)++Use the `max_retries` request option to configure this behavior.++```python+client.sessions.create_turn_stream(..., request_options={+ "max_retries": 1+})+```++### Timeouts++The SDK defaults to a 60 second timeout. You can configure this with a timeout option at the client or request level.++```python+from trueforge_sdk import TrueForge++client = TrueForge(..., timeout=20.0)++# Override timeout for a specific method+client.sessions.create_turn_stream(..., request_options={+ "timeout": 1+})+```++### Custom Client++You can override the `httpx` client to customize it for your use-case. Some common use-cases include support for proxies+and transports.++```python+import httpx+from trueforge_sdk import TrueForge++client = TrueForge(+ ...,+ httpx_client=httpx.Client(+ proxy="http://my.test.proxy.example.com",+ transport=httpx.HTTPTransport(local_address="0.0.0.0"),+ ),+)+```++## Contributing++While we value open-source contributions to this SDK, this library is generated programmatically.+Additions made directly to this library would have to be moved over to our generation code,+otherwise they would be overwritten upon the next generated release. Feel free to open a PR as+a proof of concept, but know that we will not be able to merge it as-is. We suggest opening+an issue first to discuss with us!++On the other hand, contributions to the README are always very welcome!diff --git a/python/trueforge_sdk/pyproject.toml b/python/trueforge_sdk/pyproject.tomlnew file mode 100644index 000000000..fbf80442d--- /dev/null+++ b/python/trueforge_sdk/pyproject.toml@@ -0,0 +1,94 @@+[project]+name = "trueforge_sdk"+dynamic = ["version"]++[tool.poetry]+name = "trueforge_sdk"+version = "0.2.0-rc.5"+description = ""+readme = "README.md"+authors = []+keywords = []++classifiers = [+ "Intended Audience :: Developers",+ "Programming Language :: Python",+ "Programming Language :: Python :: 3",+ "Programming Language :: Python :: 3.10",+ "Programming Language :: Python :: 3.11",+ "Programming Language :: Python :: 3.12",+ "Programming Language :: Python :: 3.13",+ "Programming Language :: Python :: 3.14",+ "Programming Language :: Python :: 3.15",+ "Operating System :: OS Independent",+ "Operating System :: POSIX",+ "Operating System :: MacOS",+ "Operating System :: POSIX :: Linux",+ "Operating System :: Microsoft :: Windows",+ "Topic :: Software Development :: Libraries :: Python Modules",+ "Typing :: Typed"+]+packages = [+ { include = "trueforge_sdk", from = "src"}+]++[tool.poetry.dependencies]+python = ">=3.10"+aiohttp = { version = ">=3.14.1,<4", optional = true, python = ">=3.10"}+httpx = ">=0.21.2"+httpx-aiohttp = { version = "^0.1.8", optional = true, python = ">=3.10"}+pydantic = ">= 1.9.2"+pydantic-core = ">=2.18.2,<3.0.0"+typing_extensions = ">= 4.0.0"++[tool.poetry.group.dev.dependencies]+mypy = "==1.13.0"+pytest = "^9.0.3"+pytest-asyncio = "^1.0.0"+pytest-xdist = "^3.6.1"+python-dateutil = "^2.9.0"+types-python-dateutil = "^2.9.0.20240316"+urllib3 = ">=2.6.3,<3.0.0"+ruff = "==0.11.5"++[tool.pytest.ini_options]+testpaths = [ "tests" ]+asyncio_mode = "auto"+norecursedirs = [ "src" ]+markers = [+ "aiohttp: tests that require httpx_aiohttp to be installed",+]++[tool.mypy]+plugins = ["pydantic.mypy"]++[tool.ruff]+line-length = 120++[tool.ruff.lint]+select = [+ "E", # pycodestyle errors+ "F", # pyflakes+ "I", # isort+]+ignore = [+ "E402", # Module level import not at top of file+ "E501", # Line too long+ "E711", # Comparison to `None` should be `cond is not None`+ "E712", # Avoid equality comparisons to `True`; use `if ...:` checks+ "E721", # Use `is` and `is not` for type comparisons, or `isinstance()` for insinstance checks+ "E722", # Do not use bare `except`+ "E731", # Do not assign a `lambda` expression, use a `def`+ "F821", # Undefined name+ "F841" # Local variable ... is assigned to but never used+]++[tool.ruff.lint.isort]+section-order = ["future", "standard-library", "third-party", "first-party"]++[build-system]+requires = ["poetry-core"]+build-backend = "poetry.core.masonry.api"++[tool.poetry.extras]+aiohttp=["aiohttp", "httpx-aiohttp"]diff --git a/python/trueforge_sdk/reference.md b/python/trueforge_sdk/reference.mdnew file mode 100644index 000000000..0f8caedb6--- /dev/null+++ b/python/trueforge_sdk/reference.md@@ -0,0 +1,4684 @@+# Reference+## Internal+<details><summary><code>client.internal.<a href="src/trueforge_sdk/internal/client.py">list_permissions</a>(...) -> ListPermissionsResponse</code></summary>+<dl>+<dd>++#### 📝 Description++<dl>+<dd>++<dl>+<dd>++Return granted actions for each requested agent, schedule, or session id.+</dd>+</dl>+</dd>+</dl>++#### 🔌 Usage++<dl>+<dd>++<dl>+<dd>++```python+from trueforge_sdk import TrueForge, PermissionResourceType++client = TrueForge(+ token="<token>",+ base_url="https://yourhost.com/path/to/api",+)++client.internal.list_permissions(+ resource_ids=[+ "resource_ids"+ ],+ resource_type=PermissionResourceType.AGENT,+)++```+</dd>+</dl>+</dd>+</dl>++#### ⚙️ Parameters++<dl>+<dd>++<dl>+<dd>++**resource_ids:** `typing.List[str]` — Resource ids of `resource_type` to evaluate for the caller.++</dd>+</dl>++<dl>+<dd>++**resource_type:** `PermissionResourceType`++</dd>+</dl>++<dl>+<dd>++**request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration.++</dd>+</dl>+</dd>+</dl>+++</dd>+</dl>+</details>++## Agents+<details><summary><code>client.agents.<a href="src/trueforge_sdk/agents/client.py">list</a>(...) -> ListAgentsResponse</code></summary>+<dl>+<dd>++#### 📝 Description++<dl>+<dd>++<dl>+<dd>++List configured agents for the tenant, ordered by name. Optional `agent_name` filters by substring.+</dd>+</dl>+</dd>+</dl>++#### 🔌 Usage++<dl>+<dd>++<dl>+<dd>++```python+from trueforge_sdk import TrueForge++client = TrueForge(+ token="<token>",+ base_url="https://yourhost.com/path/to/api",+)++client.agents.list()++```+</dd>+</dl>+</dd>+</dl>++#### ⚙️ Parameters++<dl>+<dd>++<dl>+<dd>++**limit:** `typing.Optional[int]` — Page size. Defaults to 50, max 100.++</dd>+</dl>++<dl>+<dd>++**page_token:** `typing.Optional[str]` — Opaque token from a previous response `next_page_token`.++</dd>+</dl>++<dl>+<dd>++**agent_name:** `typing.Optional[str]` — Case-insensitive substring match on agent name.++</dd>+</dl>++<dl>+<dd>++**request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration.++</dd>+</dl>+</dd>+</dl>+++</dd>+</dl>+</details>++<details><summary><code>client.agents.<a href="src/trueforge_sdk/agents/client.py">create</a>(...) -> GetAgentResponse</code></summary>+<dl>+<dd>++#### 📝 Description++<dl>+<dd>++<dl>+<dd>++Creates an agent and allocates an immutable id. Fails if `name` is already taken. Name cannot be changed later.+</dd>+</dl>+</dd>+</dl>++#### 🔌 Usage++<dl>+<dd>++<dl>+<dd>++```python+from trueforge_sdk import TrueForge, AgentSpec, Model++client = TrueForge(+ token="<token>",+ base_url="https://yourhost.com/path/to/api",+)++client.agents.create(+ description="description",+ manifest=AgentSpec(+ model=Model(+ name="name",+ ),+ ),+ name="name",+)++```+</dd>+</dl>+</dd>+</dl>++#### ⚙️ Parameters++<dl>+<dd>++<dl>+<dd>++**description:** `str`++</dd>+</dl>++<dl>+<dd>++**manifest:** `AgentSpec`++</dd>+</dl>++<dl>+<dd>++**name:** `ResourceName`++</dd>+</dl>++<dl>+<dd>++**request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration.++</dd>+</dl>+</dd>+</dl>+++</dd>+</dl>+</details>++<details><summary><code>client.agents.<a href="src/trueforge_sdk/agents/client.py">get</a>(...) -> GetAgentResponse</code></summary>+<dl>+<dd>++#### 📝 Description++<dl>+<dd>++<dl>+<dd>++Fetch a configured agent by immutable id.+</dd>+</dl>+</dd>+</dl>++#### 🔌 Usage++<dl>+<dd>++<dl>+<dd>++```python+from trueforge_sdk import TrueForge++client = TrueForge(+ token="<token>",+ base_url="https://yourhost.com/path/to/api",+)++client.agents.get(+ agent_id="agent_id",+)++```+</dd>+</dl>+</dd>+</dl>++#### ⚙️ Parameters++<dl>+<dd>++<dl>+<dd>++**agent_id:** `str` — Immutable agent identifier.++</dd>+</dl>++<dl>+<dd>++**request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration.++</dd>+</dl>+</dd>+</dl>+++</dd>+</dl>+</details>++<details><summary><code>client.agents.<a href="src/trueforge_sdk/agents/client.py">update</a>(...) -> GetAgentResponse</code></summary>+<dl>+<dd>++#### 📝 Description++<dl>+<dd>++<dl>+<dd>++Update an existing agent by immutable id.+</dd>+</dl>+</dd>+</dl>++#### 🔌 Usage++<dl>+<dd>++<dl>+<dd>++```python+from trueforge_sdk import TrueForge, AgentSpec, Model++client = TrueForge(+ token="<token>",+ base_url="https://yourhost.com/path/to/api",+)++client.agents.update(+ agent_id="agent_id",+ manifest=AgentSpec(+ model=Model(+ name="name",+ ),+ ),+)++```+</dd>+</dl>+</dd>+</dl>++#### ⚙️ Parameters++<dl>+<dd>++<dl>+<dd>++**agent_id:** `str` — Immutable agent identifier.++</dd>+</dl>++<dl>+<dd>++**manifest:** `AgentSpec`++</dd>+</dl>++<dl>+<dd>++**description:** `typing.Optional[str]`++</dd>+</dl>++<dl>+<dd>++**request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration.++</dd>+</dl>+</dd>+</dl>+++</dd>+</dl>+</details>++<details><summary><code>client.agents.<a href="src/trueforge_sdk/agents/client.py">delete</a>(...) -> DeleteAgentResponse</code></summary>+<dl>+<dd>++#### 📝 Description++<dl>+<dd>++<dl>+<dd>++Delete a configured agent by immutable id.+</dd>+</dl>+</dd>+</dl>++#### 🔌 Usage++<dl>+<dd>++<dl>+<dd>++```python+from trueforge_sdk import TrueForge++client = TrueForge(+ token="<token>",+ base_url="https://yourhost.com/path/to/api",+)++client.agents.delete(+ agent_id="agent_id",+)++```+</dd>+</dl>+</dd>+</dl>++#### ⚙️ Parameters++<dl>+<dd>++<dl>+<dd>++**agent_id:** `str` — Immutable agent identifier.++</dd>+</dl>++<dl>+<dd>++**request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration.++</dd>+</dl>+</dd>+</dl>+++</dd>+</dl>+</details>++## Auth+<details><summary><code>client.auth.<a href="src/trueforge_sdk/auth/client.py">me</a>() -> GetMeResponse</code></summary>+<dl>+<dd>++#### 📝 Description++<dl>+<dd>++<dl>+<dd>++Returns the authenticated caller identity (`type`, `tenant_id`, `subject`, `roles`) wrapped as `{ data }`. `type` is `oidc-connected` when browser OIDC is enabled, otherwise `default`. When auth is enabled this requires a valid `id_token` cookie or `Authorization: Bearer` token (401 otherwise). When auth is disabled, returns the standalone default identity.+</dd>+</dl>+</dd>+</dl>++#### 🔌 Usage++<dl>+<dd>++<dl>+<dd>++```python+from trueforge_sdk import TrueForge++client = TrueForge(+ token="<token>",+ base_url="https://yourhost.com/path/to/api",+)++client.auth.me()++```+</dd>+</dl>+</dd>+</dl>++#### ⚙️ Parameters++<dl>+<dd>++<dl>+<dd>++**request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration.++</dd>+</dl>+</dd>+</dl>+++</dd>+</dl>+</details>++## Server+<details><summary><code>client.server.<a href="src/trueforge_sdk/server/client.py">get_capabilities</a>() -> GetCapabilitiesResponse</code></summary>+<dl>+<dd>++#### 📝 Description++<dl>+<dd>++<dl>+<dd>++Report optional runtime capabilities available for this tenant.+</dd>+</dl>+</dd>+</dl>++#### 🔌 Usage++<dl>+<dd>++<dl>+<dd>++```python+from trueforge_sdk import TrueForge++client = TrueForge(+ token="<token>",+ base_url="https://yourhost.com/path/to/api",+)++client.server.get_capabilities()++```+</dd>+</dl>+</dd>+</dl>++#### ⚙️ Parameters++<dl>+<dd>++<dl>+<dd>++**request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration.++</dd>+</dl>+</dd>+</dl>+++</dd>+</dl>+</details>++## MCP Servers+<details><summary><code>client.mcp_servers.<a href="src/trueforge_sdk/mcp_servers/client.py">list</a>() -> ListAvailableMcpServersResponse</code></summary>+<dl>+<dd>++#### 📝 Description++<dl>+<dd>++<dl>+<dd>++Configured MCP servers as a slim name/url list for the composer.+</dd>+</dl>+</dd>+</dl>++#### 🔌 Usage++<dl>+<dd>++<dl>+<dd>++```python+from trueforge_sdk import TrueForge++client = TrueForge(+ token="<token>",+ base_url="https://yourhost.com/path/to/api",+)++client.mcp_servers.list()++```+</dd>+</dl>+</dd>+</dl>++#### ⚙️ Parameters++<dl>+<dd>++<dl>+<dd>++**request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration.++</dd>+</dl>+</dd>+</dl>+++</dd>+</dl>+</details>++<details><summary><code>client.mcp_servers.<a href="src/trueforge_sdk/mcp_servers/client.py">get</a>(...) -> GetAvailableMcpServerResponse</code></summary>+<dl>+<dd>++#### 📝 Description++<dl>+<dd>++<dl>+<dd>++A single MCP server as the slim chat projection, with live per-user auth_status.+</dd>+</dl>+</dd>+</dl>++#### 🔌 Usage++<dl>+<dd>++<dl>+<dd>++```python+from trueforge_sdk import TrueForge++client = TrueForge(+ token="<token>",+ base_url="https://yourhost.com/path/to/api",+)++client.mcp_servers.get(+ name="name",+)++```+</dd>+</dl>+</dd>+</dl>++#### ⚙️ Parameters++<dl>+<dd>++<dl>+<dd>++**name:** `str` — MCP server name.++</dd>+</dl>++<dl>+<dd>++**request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration.++</dd>+</dl>+</dd>+</dl>+++</dd>+</dl>+</details>++<details><summary><code>client.mcp_servers.<a href="src/trueforge_sdk/mcp_servers/client.py">authorize</a>(...) -> McpAuthStatus</code></summary>+<dl>+<dd>++#### 📝 Description++<dl>+<dd>++<dl>+<dd>++Returns current auth status. When OAuth is required, includes an authorization URL. Optional return_to is the post-consent landing path.+</dd>+</dl>+</dd>+</dl>++#### 🔌 Usage++<dl>+<dd>++<dl>+<dd>++```python+from trueforge_sdk import TrueForge++client = TrueForge(+ token="<token>",+ base_url="https://yourhost.com/path/to/api",+)++client.mcp_servers.authorize(+ name="name",+)++```+</dd>+</dl>+</dd>+</dl>++#### ⚙️ Parameters++<dl>+<dd>++<dl>+<dd>++**name:** `str` — MCP server name.++</dd>+</dl>++<dl>+<dd>++**return_to:** `typing.Optional[str]` — Same-origin path to land in the browser after consent.++</dd>+</dl>++<dl>+<dd>++**request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration.++</dd>+</dl>+</dd>+</dl>+++</dd>+</dl>+</details>++<details><summary><code>client.mcp_servers.<a href="src/trueforge_sdk/mcp_servers/client.py">delete_authorization</a>(...) -> GetMcpServerResponse</code></summary>+<dl>+<dd>++#### 📝 Description++<dl>+<dd>++<dl>+<dd>++Disconnects OAuth for the MCP server when applicable and returns the updated server with auth_status. No-op when the server does not use stored OAuth tokens.+</dd>+</dl>+</dd>+</dl>++#### 🔌 Usage++<dl>+<dd>++<dl>+<dd>++```python+from trueforge_sdk import TrueForge++client = TrueForge(+ token="<token>",+ base_url="https://yourhost.com/path/to/api",+)++client.mcp_servers.delete_authorization(+ name="name",+)++```+</dd>+</dl>+</dd>+</dl>++#### ⚙️ Parameters++<dl>+<dd>++<dl>+<dd>++**name:** `str` — MCP server name.++</dd>+</dl>++<dl>+<dd>++**request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration.++</dd>+</dl>+</dd>+</dl>+++</dd>+</dl>+</details>++<details><summary><code>client.mcp_servers.<a href="src/trueforge_sdk/mcp_servers/client.py">list_tools</a>(...) -> ListMcpServerToolsResponse</code></summary>+<dl>+<dd>++#### 📝 Description++<dl>+<dd>++<dl>+<dd>++All tools exposed by the given MCP server (non-paginated), as returned by the MCP `tools/list` call.+</dd>+</dl>+</dd>+</dl>++#### 🔌 Usage++<dl>+<dd>++<dl>+<dd>++```python+from trueforge_sdk import TrueForge++client = TrueForge(+ token="<token>",+ base_url="https://yourhost.com/path/to/api",+)++client.mcp_servers.list_tools(+ name="name",+)++```+</dd>+</dl>+</dd>+</dl>++#### ⚙️ Parameters++<dl>+<dd>++<dl>+<dd>++**name:** `str` — MCP server name.++</dd>+</dl>++<dl>+<dd>++**request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration.++</dd>+</dl>+</dd>+</dl>+++</dd>+</dl>+</details>++## Models+<details><summary><code>client.models.<a href="src/trueforge_sdk/models/client.py">list</a>() -> ListAvailableModelsResponse</code></summary>+<dl>+<dd>++#### 📝 Description++<dl>+<dd>++<dl>+<dd>++Configured models as a slim FQN list for the composer.+</dd>+</dl>+</dd>+</dl>++#### 🔌 Usage++<dl>+<dd>++<dl>+<dd>++```python+from trueforge_sdk import TrueForge++client = TrueForge(+ token="<token>",+ base_url="https://yourhost.com/path/to/api",+)++client.models.list()++```+</dd>+</dl>+</dd>+</dl>++#### ⚙️ Parameters++<dl>+<dd>++<dl>+<dd>++**request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration.++</dd>+</dl>+</dd>+</dl>+++</dd>+</dl>+</details>++## Schedules+<details><summary><code>client.schedules.<a href="src/trueforge_sdk/schedules/client.py">list</a>(...) -> ListSchedulesResponse</code></summary>+<dl>+<dd>++#### 📝 Description++<dl>+<dd>++<dl>+<dd>++List schedules for the tenant, newest first.+</dd>+</dl>+</dd>+</dl>++#### 🔌 Usage++<dl>+<dd>++<dl>+<dd>++```python+from trueforge_sdk import TrueForge++client = TrueForge(+ token="<token>",+ base_url="https://yourhost.com/path/to/api",+)++client.schedules.list()++```+</dd>+</dl>+</dd>+</dl>++#### ⚙️ Parameters++<dl>+<dd>++<dl>+<dd>++**limit:** `typing.Optional[int]` — Page size. Defaults to 25++</dd>+</dl>++<dl>+<dd>++**page_token:** `typing.Optional[str]` — Opaque token from a previous response `next_page_token`.++</dd>+</dl>++<dl>+<dd>++**agent_names:** `typing.Optional[str]` — Filter by one or more agent names (comma-separated). When set, at least one name is required.++</dd>+</dl>++<dl>+<dd>++**created_by_me:** `typing.Optional[bool]` — When true, only schedules created by the authenticated subject.++</dd>+</dl>++<dl>+<dd>++**request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration.++</dd>+</dl>+</dd>+</dl>+++</dd>+</dl>+</details>++<details><summary><code>client.schedules.<a href="src/trueforge_sdk/schedules/client.py">create</a>(...) -> GetScheduleResponse</code></summary>+<dl>+<dd>++#### 📝 Description++<dl>+<dd>++<dl>+<dd>++Create a schedule for an existing agent (by name) and add its first pending run when active.+</dd>+</dl>+</dd>+</dl>++#### 🔌 Usage++<dl>+<dd>++<dl>+<dd>++```python+from trueforge_sdk import TrueForge, ScheduleManifest++client = TrueForge(+ token="<token>",+ base_url="https://yourhost.com/path/to/api",+)++client.schedules.create(+ agent_name="agent_name",+ manifest=ScheduleManifest(+ cron="cron",+ task="task",+ ),+ name="name",+)++```+</dd>+</dl>+</dd>+</dl>++#### ⚙️ Parameters++<dl>+<dd>++<dl>+<dd>++**agent_name:** `ResourceName`++</dd>+</dl>++<dl>+<dd>++**manifest:** `ScheduleManifest`++</dd>+</dl>++<dl>+<dd>++**name:** `ResourceName`++</dd>+</dl>++<dl>+<dd>++**request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration.++</dd>+</dl>+</dd>+</dl>+++</dd>+</dl>+</details>++<details><summary><code>client.schedules.<a href="src/trueforge_sdk/schedules/client.py">create_run</a>(...) -> CreateScheduleRunResponse</code></summary>+<dl>+<dd>++#### 📝 Description++<dl>+<dd>++<dl>+<dd>++Start a schedule run immediately using the schedule task. Does not replace or advance the cron pending run.+</dd>+</dl>+</dd>+</dl>++#### 🔌 Usage++<dl>+<dd>++<dl>+<dd>++```python+from trueforge_sdk import TrueForge++client = TrueForge(+ token="<token>",+ base_url="https://yourhost.com/path/to/api",+)++client.schedules.create_run(+ schedule_id="schedule_id",+)++```+</dd>+</dl>+</dd>+</dl>++#### ⚙️ Parameters++<dl>+<dd>++<dl>+<dd>++**schedule_id:** `str` — Immutable schedule identifier.++</dd>+</dl>++<dl>+<dd>++**request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration.++</dd>+</dl>+</dd>+</dl>+++</dd>+</dl>+</details>++<details><summary><code>client.schedules.<a href="src/trueforge_sdk/schedules/client.py">get</a>(...) -> GetScheduleResponse</code></summary>+<dl>+<dd>++#### 📝 Description++<dl>+<dd>++<dl>+<dd>++Get a schedule by id.+</dd>+</dl>+</dd>+</dl>++#### 🔌 Usage++<dl>+<dd>++<dl>+<dd>++```python+from trueforge_sdk import TrueForge++client = TrueForge(+ token="<token>",+ base_url="https://yourhost.com/path/to/api",+)++client.schedules.get(+ schedule_id="schedule_id",+)++```+</dd>+</dl>+</dd>+</dl>++#### ⚙️ Parameters++<dl>+<dd>++<dl>+<dd>++**schedule_id:** `str` — Immutable schedule identifier.++</dd>+</dl>++<dl>+<dd>++**request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration.++</dd>+</dl>+</dd>+</dl>+++</dd>+</dl>+</details>++<details><summary><code>client.schedules.<a href="src/trueforge_sdk/schedules/client.py">update</a>(...) -> GetScheduleResponse</code></summary>+<dl>+<dd>++#### 📝 Description++<dl>+<dd>++<dl>+<dd>++Replace name and manifest; replaces or drops the pending run when status/cron/timezone change.+</dd>+</dl>+</dd>+</dl>++#### 🔌 Usage++<dl>+<dd>++<dl>+<dd>++```python+from trueforge_sdk import TrueForge, ScheduleManifest++client = TrueForge(+ token="<token>",+ base_url="https://yourhost.com/path/to/api",+)++client.schedules.update(+ schedule_id="schedule_id",+ manifest=ScheduleManifest(+ cron="cron",+ task="task",+ ),+ name="name",+)++```+</dd>+</dl>+</dd>+</dl>++#### ⚙️ Parameters++<dl>+<dd>++<dl>+<dd>++**schedule_id:** `str` — Immutable schedule identifier.++</dd>+</dl>++<dl>+<dd>++**manifest:** `ScheduleManifest`++</dd>+</dl>++<dl>+<dd>++**name:** `ResourceName`++</dd>+</dl>++<dl>+<dd>++**request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration.++</dd>+</dl>+</dd>+</dl>+++</dd>+</dl>+</details>++<details><summary><code>client.schedules.<a href="src/trueforge_sdk/schedules/client.py">delete</a>(...) -> DeleteScheduleResponse</code></summary>+<dl>+<dd>++#### 📝 Description++<dl>+<dd>++<dl>+<dd>++Delete a schedule and its runs. Idempotent.+</dd>+</dl>+</dd>+</dl>++#### 🔌 Usage++<dl>+<dd>++<dl>+<dd>++```python+from trueforge_sdk import TrueForge++client = TrueForge(+ token="<token>",+ base_url="https://yourhost.com/path/to/api",+)++client.schedules.delete(+ schedule_id="schedule_id",+)++```+</dd>+</dl>+</dd>+</dl>++#### ⚙️ Parameters++<dl>+<dd>++<dl>+<dd>++**schedule_id:** `str` — Immutable schedule identifier.++</dd>+</dl>++<dl>+<dd>++**request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration.++</dd>+</dl>+</dd>+</dl>+++</dd>+</dl>+</details>++<details><summary><code>client.schedules.<a href="src/trueforge_sdk/schedules/client.py">list_runs</a>(...) -> ListScheduleRunsResponse</code></summary>+<dl>+<dd>++#### 📝 Description++<dl>+<dd>++<dl>+<dd>++List runs of a schedule, newest `scheduled_for` first. Available to its creator or a manager of its agent.+</dd>+</dl>+</dd>+</dl>++#### 🔌 Usage++<dl>+<dd>++<dl>+<dd>++```python+from trueforge_sdk import TrueForge++client = TrueForge(+ token="<token>",+ base_url="https://yourhost.com/path/to/api",+)++client.schedules.list_runs(+ schedule_id="schedule_id",+)++```+</dd>+</dl>+</dd>+</dl>++#### ⚙️ Parameters++<dl>+<dd>++<dl>+<dd>++**schedule_id:** `str` — Immutable schedule identifier.++</dd>+</dl>++<dl>+<dd>++**limit:** `typing.Optional[int]` — Page size. Defaults to 25++</dd>+</dl>++<dl>+<dd>++**page_token:** `typing.Optional[str]` — Opaque token from a previous response `next_page_token`.++</dd>+</dl>++<dl>+<dd>++**request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration.++</dd>+</dl>+</dd>+</dl>+++</dd>+</dl>+</details>++## Sessions+<details><summary><code>client.sessions.<a href="src/trueforge_sdk/sessions/client.py">list</a>(...) -> ListSessionsResponse</code></summary>+<dl>+<dd>++#### 📝 Description++<dl>+<dd>++<dl>+<dd>++List the sessions (newest first by default).+</dd>+</dl>+</dd>+</dl>++#### 🔌 Usage++<dl>+<dd>++<dl>+<dd>++```python+from trueforge_sdk import TrueForge++client = TrueForge(+ token="<token>",+ base_url="https://yourhost.com/path/to/api",+)++client.sessions.list()++```+</dd>+</dl>+</dd>+</dl>++#### ⚙️ Parameters++<dl>+<dd>++<dl>+<dd>++**limit:** `typing.Optional[int]` — Page size. Defaults to 25, max 25.++</dd>+</dl>++<dl>+<dd>++**order:** `typing.Optional[ListSessionsOrder]` — Sort sessions by `updated_at`. Defaults to "desc".++</dd>+</dl>++<dl>+<dd>++**page_token:** `typing.Optional[str]` — Opaque keyset cursor from a previous response `next_page_token`.++</dd>+</dl>++<dl>+<dd>++**start_timestamp:** `typing.Optional[datetime.datetime]` — Inclusive lower bound on `created_at` (ISO-8601 / RFC 3339).++</dd>+</dl>++<dl>+<dd>++**end_timestamp:** `typing.Optional[datetime.datetime]` — Inclusive upper bound on `created_at` (ISO-8601 / RFC 3339).++</dd>+</dl>++<dl>+<dd>++**agent_id:** `typing.Optional[str]` — When set, only sessions bound to this agent id are returned.++</dd>+</dl>++<dl>+<dd>++**created_by_me:** `typing.Optional[bool]` — When true, only sessions created by the authenticated subject.++</dd>+</dl>++<dl>+<dd>++**metadata:** `typing.Optional[SessionMetadata]` — Exact metadata pairs as metadata[key]=value. Sessions must contain all pairs.++</dd>+</dl>++<dl>+<dd>++**source_type:** `typing.Optional[SessionSourceType]` — When set, returns only sessions created by this source type.++</dd>+</dl>++<dl>+<dd>++**source_id:** `typing.Optional[str]` — When set, returns only sessions from this specific source. Requires source_type.++</dd>+</dl>++<dl>+<dd>++**request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration.++</dd>+</dl>+</dd>+</dl>+++</dd>+</dl>+</details>++<details><summary><code>client.sessions.<a href="src/trueforge_sdk/sessions/client.py">create</a>(...) -> GetSessionResponse</code></summary>+<dl>+<dd>++#### 📝 Description++<dl>+<dd>++<dl>+<dd>++Create a session with `agent` as either `{ name }` (named registry binding) or `{ spec: AgentSpec }` (inline). Named sessions snapshot the agent name at create and resolve the live agent on each turn. Responses use `{ type: "reference", name, id }` or `{ type: "inline", spec }`.+</dd>+</dl>+</dd>+</dl>++#### 🔌 Usage++<dl>+<dd>++<dl>+<dd>++```python+from trueforge_sdk import TrueForge, SessionAgentNameRef++client = TrueForge(+ token="<token>",+ base_url="https://yourhost.com/path/to/api",+)++client.sessions.create(+ agent=SessionAgentNameRef(+ name="name",+ ),+)++```+</dd>+</dl>+</dd>+</dl>++#### ⚙️ Parameters++<dl>+<dd>++<dl>+<dd>++**agent:** `CreateSessionAgent`++</dd>+</dl>++<dl>+<dd>++**metadata:** `typing.Optional[SessionMetadata]`++</dd>+</dl>++<dl>+<dd>++**request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration.++</dd>+</dl>+</dd>+</dl>+++</dd>+</dl>+</details>++<details><summary><code>client.sessions.<a href="src/trueforge_sdk/sessions/client.py">get</a>(...) -> GetSessionResponse</code></summary>+<dl>+<dd>++#### 📝 Description++<dl>+<dd>++<dl>+<dd>++Fetch a session by ID. Only the session creator may fetch it.+</dd>+</dl>+</dd>+</dl>++#### 🔌 Usage++<dl>+<dd>++<dl>+<dd>++```python+from trueforge_sdk import TrueForge++client = TrueForge(+ token="<token>",+ base_url="https://yourhost.com/path/to/api",+)++client.sessions.get(+ session_id="session_id",+)++```+</dd>+</dl>+</dd>+</dl>++#### ⚙️ Parameters++<dl>+<dd>++<dl>+<dd>++**session_id:** `str` — Session identifier.++</dd>+</dl>++<dl>+<dd>++**request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration.++</dd>+</dl>+</dd>+</dl>+++</dd>+</dl>+</details>++<details><summary><code>client.sessions.<a href="src/trueforge_sdk/sessions/client.py">delete</a>(...)</code></summary>+<dl>+<dd>++#### 📝 Description++<dl>+<dd>++<dl>+<dd>++Delete a session and all related turns, events, and internal state. Only the session creator may delete it. Idempotent if already gone.+</dd>+</dl>+</dd>+</dl>++#### 🔌 Usage++<dl>+<dd>++<dl>+<dd>++```python+from trueforge_sdk import TrueForge++client = TrueForge(+ token="<token>",+ base_url="https://yourhost.com/path/to/api",+)++client.sessions.delete(+ session_id="session_id",+)++```+</dd>+</dl>+</dd>+</dl>++#### ⚙️ Parameters++<dl>+<dd>++<dl>+<dd>++**session_id:** `str` — Session identifier.++</dd>+</dl>++<dl>+<dd>++**request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration.++</dd>+</dl>+</dd>+</dl>+++</dd>+</dl>+</details>++<details><summary><code>client.sessions.<a href="src/trueforge_sdk/sessions/client.py">update</a>(...) -> GetSessionResponse</code></summary>+<dl>+<dd>++#### 📝 Description++<dl>+<dd>++<dl>+<dd>++Update a session by replacing `agent` with `{ spec: AgentSpec }`. Named (reference) sessions reject agent updates. An empty body is a valid no-op that refreshes `updated_at`. Only the session creator may update it.+</dd>+</dl>+</dd>+</dl>++#### 🔌 Usage++<dl>+<dd>++<dl>+<dd>++```python+from trueforge_sdk import TrueForge++client = TrueForge(+ token="<token>",+ base_url="https://yourhost.com/path/to/api",+)++client.sessions.update(+ session_id="session_id",+)++```+</dd>+</dl>+</dd>+</dl>++#### ⚙️ Parameters++<dl>+<dd>++<dl>+<dd>++**session_id:** `str` — Session identifier.++</dd>+</dl>++<dl>+<dd>++**agent:** `typing.Optional[SessionAgentSpecBody]`++</dd>+</dl>++<dl>+<dd>++**metadata:** `typing.Optional[SessionMetadata]`++</dd>+</dl>++<dl>+<dd>++**request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration.++</dd>+</dl>+</dd>+</dl>+++</dd>+</dl>+</details>++<details><summary><code>client.sessions.<a href="src/trueforge_sdk/sessions/client.py">cancel</a>(...) -> CancelSessionResponse</code></summary>+<dl>+<dd>++#### 📝 Description++<dl>+<dd>++<dl>+<dd>++Cancel the running last turn for a session. Only the session creator may cancel.+</dd>+</dl>+</dd>+</dl>++#### 🔌 Usage++<dl>+<dd>++<dl>+<dd>++```python+from trueforge_sdk import TrueForge++client = TrueForge(+ token="<token>",+ base_url="https://yourhost.com/path/to/api",+)++client.sessions.cancel(+ session_id="session_id",+)++```+</dd>+</dl>+</dd>+</dl>++#### ⚙️ Parameters++<dl>+<dd>++<dl>+<dd>++**session_id:** `str` — Session identifier.++</dd>+</dl>++<dl>+<dd>++**request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration.++</dd>+</dl>+</dd>+</dl>+++</dd>+</dl>+</details>++<details><summary><code>client.sessions.<a href="src/trueforge_sdk/sessions/client.py">list_events</a>(...) -> ListSessionEventsResponse</code></summary>+<dl>+<dd>++#### 📝 Description++<dl>+<dd>++<dl>+<dd>++List session events as `{ turn_id, event }` across the active turn branch (newest first), including persisted events from a running tip. Each turn contributes turn.created, content events (model.message, tool.call, …), and turn.done when terminal; streaming deltas are not included. Use `page_token` to paginate backward toward older events while retaining the original branch anchor. Only the session creator may list events.+</dd>+</dl>+</dd>+</dl>++#### 🔌 Usage++<dl>+<dd>++<dl>+<dd>++```python+from trueforge_sdk import TrueForge++client = TrueForge(+ token="<token>",+ base_url="https://yourhost.com/path/to/api",+)++client.sessions.list_events(+ session_id="session_id",+)++```+</dd>+</dl>+</dd>+</dl>++#### ⚙️ Parameters++<dl>+<dd>++<dl>+<dd>++**session_id:** `str` — Session identifier.++</dd>+</dl>++<dl>+<dd>++**page_token:** `typing.Optional[str]` — Pagination cursor from `pagination.next_page_token`. It retains the branch anchor turn and returns older events toward the session start.++</dd>+</dl>++<dl>+<dd>++**last_turn_id:** `typing.Optional[str]` — Newest turn in the listing window (initial load only; ignored when `page_token` is set). Lists that turn and its ancestors, newest events first. Omit to use the session last turn.++</dd>+</dl>++<dl>+<dd>++**limit:** `typing.Optional[int]` — Page size. Defaults to 100, max 100.++</dd>+</dl>++<dl>+<dd>++**request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration.++</dd>+</dl>+</dd>+</dl>+++</dd>+</dl>+</details>++<details><summary><code>client.sessions.<a href="src/trueforge_sdk/sessions/client.py">list_turns</a>(...) -> ListTurnsResponse</code></summary>+<dl>+<dd>++#### 📝 Description++<dl>+<dd>++<dl>+<dd>++List turns for a session (newest first by default), token-paginated. Only the session creator may list turns.+</dd>+</dl>+</dd>+</dl>++#### 🔌 Usage++<dl>+<dd>++<dl>+<dd>++```python+from trueforge_sdk import TrueForge++client = TrueForge(+ token="<token>",+ base_url="https://yourhost.com/path/to/api",+)++client.sessions.list_turns(+ session_id="session_id",+)++```+</dd>+</dl>+</dd>+</dl>++#### ⚙️ Parameters++<dl>+<dd>++<dl>+<dd>++**session_id:** `str` — Session identifier.++</dd>+</dl>++<dl>+<dd>++**limit:** `typing.Optional[int]` — Page size. Defaults to 25, max 25.++</dd>+</dl>++<dl>+<dd>++**page_token:** `typing.Optional[str]` — Opaque token from a previous response `next_page_token`.++</dd>+</dl>++<dl>+<dd>++**request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration.++</dd>+</dl>+</dd>+</dl>+++</dd>+</dl>+</details>++<details><summary><code>client.sessions.<a href="src/trueforge_sdk/sessions/client.py">create_turn_stream</a>(...) -> typing.Iterator[bytes]</code></summary>+<dl>+<dd>++#### 📝 Description++<dl>+<dd>++<dl>+<dd>++Create a turn within a session and execute it.+Only the session creator may create turns.+When `stream` is true (default), respond with a Server-Sent Events stream of turn events.+When `stream` is false, return the turn immediately with `state.status: "running"` while execution continues in the background; use get turn or subscribe to observe completion.+Use `previous_turn_id` to chain to the session's last turn (defaults to `auto`); use `none` for a new root.+</dd>+</dl>+</dd>+</dl>++#### 🔌 Usage++<dl>+<dd>++<dl>+<dd>++```python+from trueforge_sdk import TrueForge++client = TrueForge(+ token="<token>",+ base_url="https://yourhost.com/path/to/api",+)++client.sessions.create_turn_stream(+ session_id="session_id",+)++```+</dd>+</dl>+</dd>+</dl>++#### ⚙️ Parameters++<dl>+<dd>++<dl>+<dd>++**session_id:** `str` — Session identifier.++</dd>+</dl>++<dl>+<dd>++**stream:** `typing.Literal` — When true (default), stream turn events as SSE. When false, return the running turn immediately.++</dd>+</dl>++<dl>+<dd>++**input:** `typing.Optional[typing.List[TurnInputItem]]` — Turn input items: user messages and/or approval/tool-response resumes. Do not mix user messages with approval or tool-response items.++</dd>+</dl>++<dl>+<dd>++**previous_turn_id:** `typing.Optional[PreviousTurnIdInput]`++</dd>+</dl>++<dl>+<dd>++**request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration.++</dd>+</dl>+</dd>+</dl>+++</dd>+</dl>+</details>++<details><summary><code>client.sessions.<a href="src/trueforge_sdk/sessions/client.py">create_turn</a>(...) -> GetTurnResponse</code></summary>+<dl>+<dd>++#### 📝 Description++<dl>+<dd>++<dl>+<dd>++Create a turn within a session and execute it.+Only the session creator may create turns.+When `stream` is true (default), respond with a Server-Sent Events stream of turn events.+When `stream` is false, return the turn immediately with `state.status: "running"` while execution continues in the background; use get turn or subscribe to observe completion.+Use `previous_turn_id` to chain to the session's last turn (defaults to `auto`); use `none` for a new root.+</dd>+</dl>+</dd>+</dl>++#### 🔌 Usage++<dl>+<dd>++<dl>+<dd>++```python+from trueforge_sdk import TrueForge++client = TrueForge(+ token="<token>",+ base_url="https://yourhost.com/path/to/api",+)++client.sessions.create_turn_stream(+ session_id="session_id",+)++```+</dd>+</dl>+</dd>+</dl>++#### ⚙️ Parameters++<dl>+<dd>++<dl>+<dd>++**session_id:** `str` — Session identifier.++</dd>+</dl>++<dl>+<dd>++**stream:** `typing.Literal` — When true (default), stream turn events as SSE. When false, return the running turn immediately.++</dd>+</dl>++<dl>+<dd>++**input:** `typing.Optional[typing.List[TurnInputItem]]` — Turn input items: user messages and/or approval/tool-response resumes. Do not mix user messages with approval or tool-response items.++</dd>+</dl>++<dl>+<dd>++**previous_turn_id:** `typing.Optional[PreviousTurnIdInput]`++</dd>+</dl>++<dl>+<dd>++**request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration.++</dd>+</dl>+</dd>+</dl>+++</dd>+</dl>+</details>++<details><summary><code>client.sessions.<a href="src/trueforge_sdk/sessions/client.py">get_turn</a>(...) -> GetTurnResponse</code></summary>+<dl>+<dd>++#### 📝 Description++<dl>+<dd>++<dl>+<dd>++Fetch a single turn by ID. Only the session creator may fetch it.+</dd>+</dl>+</dd>+</dl>++#### 🔌 Usage++<dl>+<dd>++<dl>+<dd>++```python+from trueforge_sdk import TrueForge++client = TrueForge(+ token="<token>",+ base_url="https://yourhost.com/path/to/api",+)++client.sessions.get_turn(+ session_id="session_id",+ turn_id="turn_id",+)++```+</dd>+</dl>+</dd>+</dl>++#### ⚙️ Parameters++<dl>+<dd>++<dl>+<dd>++**session_id:** `str` — Session identifier.++</dd>+</dl>++<dl>+<dd>++**turn_id:** `str` — Turn identifier.++</dd>+</dl>++<dl>+<dd>++**request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration.++</dd>+</dl>+</dd>+</dl>+++</dd>+</dl>+</details>++<details><summary><code>client.sessions.<a href="src/trueforge_sdk/sessions/client.py">download_sandbox_file</a>(...) -> typing.Iterator[bytes]</code></summary>+<dl>+<dd>++#### 📝 Description++<dl>+<dd>++<dl>+<dd>++Download a file from the sandbox this turn ran in. Paths come from the assistant's `sandbox_artifacts` block. Only the session creator may download.+</dd>+</dl>+</dd>+</dl>++#### 🔌 Usage++<dl>+<dd>++<dl>+<dd>++```python+from trueforge_sdk import TrueForge++client = TrueForge(+ token="<token>",+ base_url="https://yourhost.com/path/to/api",+)++client.sessions.download_sandbox_file(+ session_id="session_id",+ turn_id="turn_id",+ path="x",+)++```+</dd>+</dl>+</dd>+</dl>++#### ⚙️ Parameters++<dl>+<dd>++<dl>+<dd>++**session_id:** `str` — Session identifier.++</dd>+</dl>++<dl>+<dd>++**turn_id:** `str` — Turn identifier.++</dd>+</dl>++<dl>+<dd>++**path:** `str` — Absolute or sandbox-working-directory-relative file path, as listed in the assistant's `sandbox_artifacts` block.++</dd>+</dl>++<dl>+<dd>++**request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration.++</dd>+</dl>+</dd>+</dl>+++</dd>+</dl>+</details>++<details><summary><code>client.sessions.<a href="src/trueforge_sdk/sessions/client.py">list_turn_events</a>(...) -> ListTurnEventsResponse</code></summary>+<dl>+<dd>++#### 📝 Description++<dl>+<dd>++<dl>+<dd>++Paginated persisted events for a turn (insertion order by default). Only the session creator may list events.+</dd>+</dl>+</dd>+</dl>++#### 🔌 Usage++<dl>+<dd>++<dl>+<dd>++```python+from trueforge_sdk import TrueForge++client = TrueForge(+ token="<token>",+ base_url="https://yourhost.com/path/to/api",+)++client.sessions.list_turn_events(+ session_id="session_id",+ turn_id="turn_id",+)++```+</dd>+</dl>+</dd>+</dl>++#### ⚙️ Parameters++<dl>+<dd>++<dl>+<dd>++**session_id:** `str` — Session identifier.++</dd>+</dl>++<dl>+<dd>++**turn_id:** `str` — Turn identifier.++</dd>+</dl>++<dl>+<dd>++**limit:** `typing.Optional[int]` — Page size. Defaults to 100, max 100.++</dd>+</dl>++<dl>+<dd>++**page_token:** `typing.Optional[str]` — Opaque token from a previous response `next_page_token`.++</dd>+</dl>++<dl>+<dd>++**order:** `typing.Optional[ListTurnEventsOrder]` — Sort events by insertion order. Defaults to "asc".++</dd>+</dl>++<dl>+<dd>++**request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration.++</dd>+</dl>+</dd>+</dl>+++</dd>+</dl>+</details>++<details><summary><code>client.sessions.<a href="src/trueforge_sdk/sessions/client.py">subscribe_to_turn</a>(...) -> typing.Iterator[bytes]</code></summary>+<dl>+<dd>++#### 📝 Description++<dl>+<dd>++<dl>+<dd>++Subscribe to the live SSE stream for a turn. Only the session creator may subscribe. Pass `after_sequence_number` to resume after a disconnect (exclusive — events after this sequence number are replayed).+</dd>+</dl>+</dd>+</dl>++#### 🔌 Usage++<dl>+<dd>++<dl>+<dd>++```python+from trueforge_sdk import TrueForge++client = TrueForge(+ token="<token>",+ base_url="https://yourhost.com/path/to/api",+)++client.sessions.subscribe_to_turn(+ session_id="session_id",+ turn_id="turn_id",+)++```+</dd>+</dl>+</dd>+</dl>++#### ⚙️ Parameters++<dl>+<dd>++<dl>+<dd>++**session_id:** `str` — Session identifier.++</dd>+</dl>++<dl>+<dd>++**turn_id:** `str` — Turn identifier.++</dd>+</dl>++<dl>+<dd>++**after_sequence_number:** `typing.Optional[int]` — Exclusive resume cursor: replay only events with a sequence number greater than this value. Omit to start from the beginning of the live buffer.++</dd>+</dl>++<dl>+<dd>++**request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration.++</dd>+</dl>+</dd>+</dl>+++</dd>+</dl>+</details>++## Skills+<details><summary><code>client.skills.<a href="src/trueforge_sdk/skills/client.py">list</a>() -> ListAvailableSkillsResponse</code></summary>+<dl>+<dd>++#### 📝 Description++<dl>+<dd>++<dl>+<dd>++Configured skills as a slim name/description list for the composer.+</dd>+</dl>+</dd>+</dl>++#### 🔌 Usage++<dl>+<dd>++<dl>+<dd>++```python+from trueforge_sdk import TrueForge++client = TrueForge(+ token="<token>",+ base_url="https://yourhost.com/path/to/api",+)++client.skills.list()++```+</dd>+</dl>+</dd>+</dl>++#### ⚙️ Parameters++<dl>+<dd>++<dl>+<dd>++**request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration.++</dd>+</dl>+</dd>+</dl>+++</dd>+</dl>+</details>++<details><summary><code>client.skills.<a href="src/trueforge_sdk/skills/client.py">list_versions</a>(...) -> ListSkillVersionsResponse</code></summary>+<dl>+<dd>++#### 📝 Description++<dl>+<dd>++<dl>+<dd>++Versions for one skill.+</dd>+</dl>+</dd>+</dl>++#### 🔌 Usage++<dl>+<dd>++<dl>+<dd>++```python+from trueforge_sdk import TrueForge++client = TrueForge(+ token="<token>",+ base_url="https://yourhost.com/path/to/api",+)++client.skills.list_versions(+ name="name",+)++```+</dd>+</dl>+</dd>+</dl>++#### ⚙️ Parameters++<dl>+<dd>++<dl>+<dd>++**name:** `str` — Skill name.++</dd>+</dl>++<dl>+<dd>++**request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration.++</dd>+</dl>+</dd>+</dl>+++</dd>+</dl>+</details>++## Catalogs McpServers+<details><summary><code>client.catalogs.mcp_servers.<a href="src/trueforge_sdk/catalogs/mcp_servers/client.py">list</a>() -> GetMcpServerCatalogResponse</code></summary>+<dl>+<dd>++#### 📝 Description++<dl>+<dd>++<dl>+<dd>++Shipped MCP server presets (discovery-only). Copy into PUT /settings/mcp-servers to configure.+</dd>+</dl>+</dd>+</dl>++#### 🔌 Usage++<dl>+<dd>++<dl>+<dd>++```python+from trueforge_sdk import TrueForge++client = TrueForge(+ token="<token>",+ base_url="https://yourhost.com/path/to/api",+)++client.catalogs.mcp_servers.list()++```+</dd>+</dl>+</dd>+</dl>++#### ⚙️ Parameters++<dl>+<dd>++<dl>+<dd>++**request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration.++</dd>+</dl>+</dd>+</dl>+++</dd>+</dl>+</details>++## Catalogs ModelProviders+<details><summary><code>client.catalogs.model_providers.<a href="src/trueforge_sdk/catalogs/model_providers/client.py">list</a>() -> GetModelProviderCatalogResponse</code></summary>+<dl>+<dd>++#### 📝 Description++<dl>+<dd>++<dl>+<dd>++Shipped model-provider presets (discovery-only). Copy into PUT /settings/model-providers to configure. Includes a `custom` sentinel with `supported_reasoning_efforts`.+</dd>+</dl>+</dd>+</dl>++#### 🔌 Usage++<dl>+<dd>++<dl>+<dd>++```python+from trueforge_sdk import TrueForge++client = TrueForge(+ token="<token>",+ base_url="https://yourhost.com/path/to/api",+)++client.catalogs.model_providers.list()++```+</dd>+</dl>+</dd>+</dl>++#### ⚙️ Parameters++<dl>+<dd>++<dl>+<dd>++**request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration.++</dd>+</dl>+</dd>+</dl>+++</dd>+</dl>+</details>++## Catalogs SandboxProviders+<details><summary><code>client.catalogs.sandbox_providers.<a href="src/trueforge_sdk/catalogs/sandbox_providers/client.py">list</a>() -> GetSandboxProviderCatalogResponse</code></summary>+<dl>+<dd>++#### 📝 Description++<dl>+<dd>++<dl>+<dd>++Shipped sandbox-provider presets (discovery-only). Copy into PUT /settings/sandbox-providers to configure.+</dd>+</dl>+</dd>+</dl>++#### 🔌 Usage++<dl>+<dd>++<dl>+<dd>++```python+from trueforge_sdk import TrueForge++client = TrueForge(+ token="<token>",+ base_url="https://yourhost.com/path/to/api",+)++client.catalogs.sandbox_providers.list()++```+</dd>+</dl>+</dd>+</dl>++#### ⚙️ Parameters++<dl>+<dd>++<dl>+<dd>++**request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration.++</dd>+</dl>+</dd>+</dl>+++</dd>+</dl>+</details>++## Catalogs Skills+<details><summary><code>client.catalogs.skills.<a href="src/trueforge_sdk/catalogs/skills/client.py">list</a>() -> GetSkillCatalogResponse</code></summary>+<dl>+<dd>++#### 📝 Description++<dl>+<dd>++<dl>+<dd>++Shipped skill presets (discovery-only). Copy into PUT /settings/skills to configure.+</dd>+</dl>+</dd>+</dl>++#### 🔌 Usage++<dl>+<dd>++<dl>+<dd>++```python+from trueforge_sdk import TrueForge++client = TrueForge(+ token="<token>",+ base_url="https://yourhost.com/path/to/api",+)++client.catalogs.skills.list()++```+</dd>+</dl>+</dd>+</dl>++#### ⚙️ Parameters++<dl>+<dd>++<dl>+<dd>++**request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration.++</dd>+</dl>+</dd>+</dl>+++</dd>+</dl>+</details>++## Internal Metrics+<details><summary><code>client.internal.metrics.<a href="src/trueforge_sdk/internal/metrics/client.py">list_charts</a>() -> GetSessionMetricsChartResponse</code></summary>+<dl>+<dd>++#### 📝 Description++<dl>+<dd>++<dl>+<dd>++List available session metric charts.+</dd>+</dl>+</dd>+</dl>++#### 🔌 Usage++<dl>+<dd>++<dl>+<dd>++```python+from trueforge_sdk import TrueForge++client = TrueForge(+ token="<token>",+ base_url="https://yourhost.com/path/to/api",+)++client.internal.metrics.list_charts()++```+</dd>+</dl>+</dd>+</dl>++#### ⚙️ Parameters++<dl>+<dd>++<dl>+<dd>++**request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration.++</dd>+</dl>+</dd>+</dl>+++</dd>+</dl>+</details>++<details><summary><code>client.internal.metrics.<a href="src/trueforge_sdk/internal/metrics/client.py">get_chart_data</a>(...) -> GetSessionMetricsChartDataResponse</code></summary>+<dl>+<dd>++#### 📝 Description++<dl>+<dd>++<dl>+<dd>++Return one chart for the caller's sessions on a named agent over an inclusive creation-time window. Uses hourly buckets for windows up to 24 hours and daily UTC buckets otherwise.+</dd>+</dl>+</dd>+</dl>++#### 🔌 Usage++<dl>+<dd>++<dl>+<dd>++```python+from trueforge_sdk import TrueForge, SessionMetricsChartName+import datetime++client = TrueForge(+ token="<token>",+ base_url="https://yourhost.com/path/to/api",+)++client.internal.metrics.get_chart_data(+ agent_id="agent_id",+ start_timestamp=datetime.datetime.fromisoformat("2024-01-15T09:30:00+00:00"),+ end_timestamp=datetime.datetime.fromisoformat("2024-01-15T09:30:00+00:00"),+ chart_name=SessionMetricsChartName.SESSIONS_OVER_TIME,+)++```+</dd>+</dl>+</dd>+</dl>++#### ⚙️ Parameters++<dl>+<dd>++<dl>+<dd>++**agent_id:** `str` — Named agent identifier.++</dd>+</dl>++<dl>+<dd>++**start_timestamp:** `datetime.datetime` — Inclusive lower bound on session `created_at`.++</dd>+</dl>++<dl>+<dd>++**end_timestamp:** `datetime.datetime` — Inclusive upper bound on session `created_at`.++</dd>+</dl>++<dl>+<dd>++**chart_name:** `SessionMetricsChartName` — Session metrics chart to return.++</dd>+</dl>++<dl>+<dd>++**request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration.++</dd>+</dl>+</dd>+</dl>+++</dd>+</dl>+</details>++<details><summary><code>client.internal.metrics.<a href="src/trueforge_sdk/internal/metrics/client.py">get_meters</a>(...) -> GetSessionMetricsMeterResponse</code></summary>+<dl>+<dd>++#### 📝 Description++<dl>+<dd>++<dl>+<dd>++Aggregate the caller's session meters for a named agent over an inclusive creation-time window.+</dd>+</dl>+</dd>+</dl>++#### 🔌 Usage++<dl>+<dd>++<dl>+<dd>++```python+from trueforge_sdk import TrueForge+import datetime++client = TrueForge(+ token="<token>",+ base_url="https://yourhost.com/path/to/api",+)++client.internal.metrics.get_meters(+ agent_id="agent_id",+ start_timestamp=datetime.datetime.fromisoformat("2024-01-15T09:30:00+00:00"),+ end_timestamp=datetime.datetime.fromisoformat("2024-01-15T09:30:00+00:00"),+)++```+</dd>+</dl>+</dd>+</dl>++#### ⚙️ Parameters++<dl>+<dd>++<dl>+<dd>++**agent_id:** `str` — Named agent identifier.++</dd>+</dl>++<dl>+<dd>++**start_timestamp:** `datetime.datetime` — Inclusive lower bound on session `created_at`.++</dd>+</dl>++<dl>+<dd>++**end_timestamp:** `datetime.datetime` — Inclusive upper bound on session `created_at`.++</dd>+</dl>++<dl>+<dd>++**request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration.++</dd>+</dl>+</dd>+</dl>+++</dd>+</dl>+</details>++## Internal Schedules+<details><summary><code>client.internal.schedules.<a href="src/trueforge_sdk/internal/schedules/client.py">execute_run</a>(...)</code></summary>+<dl>+<dd>++#### 📝 Description++<dl>+<dd>++<dl>+<dd>++Execute a persisted schedule run using its saved schedule and agent.+</dd>+</dl>+</dd>+</dl>++#### 🔌 Usage++<dl>+<dd>++<dl>+<dd>++```python+from trueforge_sdk import TrueForge++client = TrueForge(+ token="<token>",+ base_url="https://yourhost.com/path/to/api",+)++client.internal.schedules.execute_run(+ schedule_run_id="schedule_run_id",+)++```+</dd>+</dl>+</dd>+</dl>++#### ⚙️ Parameters++<dl>+<dd>++<dl>+<dd>++**schedule_run_id:** `str` — Immutable schedule run identifier.++</dd>+</dl>++<dl>+<dd>++**request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration.++</dd>+</dl>+</dd>+</dl>+++</dd>+</dl>+</details>++## Internal Sessions+<details><summary><code>client.internal.sessions.<a href="src/trueforge_sdk/internal/sessions/client.py">get_or_create_by_external_id</a>(...) -> GetSessionResponse</code></summary>+<dl>+<dd>++#### 📝 Description++<dl>+<dd>++<dl>+<dd>++Idempotent get-or-create: returns the existing session for this `external_id`, or creates one+</dd>+</dl>+</dd>+</dl>++#### 🔌 Usage++<dl>+<dd>++<dl>+<dd>++```python+from trueforge_sdk import TrueForge, SessionAgentNameRef++client = TrueForge(+ token="<token>",+ base_url="https://yourhost.com/path/to/api",+)++client.internal.sessions.get_or_create_by_external_id(+ agent=SessionAgentNameRef(+ name="name",+ ),+ external_id="external_id",+)++```+</dd>+</dl>+</dd>+</dl>++#### ⚙️ Parameters++<dl>+<dd>++<dl>+<dd>++**agent:** `CreateSessionAgent`++</dd>+</dl>++<dl>+<dd>++**external_id:** `str` — Caller-supplied id unique within the tenant.++</dd>+</dl>++<dl>+<dd>++**source:** `typing.Optional[SessionSourceSchedule]`++</dd>+</dl>++<dl>+<dd>++**request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration.++</dd>+</dl>+</dd>+</dl>+++</dd>+</dl>+</details>++## Internal Agents+<details><summary><code>client.internal.agents.<a href="src/trueforge_sdk/internal/agents/client.py">get_code_snippets</a>(...) -> GetAgentCodeSnippetsResponse</code></summary>+<dl>+<dd>++#### 📝 Description++<dl>+<dd>++<dl>+<dd>++TypeScript TrueForge SDK samples (stream and non-stream) for creating a session and turn against this agent.+</dd>+</dl>+</dd>+</dl>++#### 🔌 Usage++<dl>+<dd>++<dl>+<dd>++```python+from trueforge_sdk import TrueForge++client = TrueForge(+ token="<token>",+ base_url="https://yourhost.com/path/to/api",+)++client.internal.agents.get_code_snippets(+ agent_id="agent_id",+)++```+</dd>+</dl>+</dd>+</dl>++#### ⚙️ Parameters++<dl>+<dd>++<dl>+<dd>++**agent_id:** `str` — Immutable agent identifier.++</dd>+</dl>++<dl>+<dd>++**base_url:** `typing.Optional[str]` — Public SDK base URL from the browser. When omitted, derived from the request origin and PUBLIC_BASE_URL.++</dd>+</dl>++<dl>+<dd>++**request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration.++</dd>+</dl>+</dd>+</dl>+++</dd>+</dl>+</details>++## Settings McpServers+<details><summary><code>client.settings.mcp_servers.<a href="src/trueforge_sdk/settings/mcp_servers/client.py">list</a>() -> ListMcpServersResponse</code></summary>+<dl>+<dd>++#### 📝 Description++<dl>+<dd>++<dl>+<dd>++Configured MCP servers with auth_status. Header secrets are redacted.+</dd>+</dl>+</dd>+</dl>++#### 🔌 Usage++<dl>+<dd>++<dl>+<dd>++```python+from trueforge_sdk import TrueForge++client = TrueForge(+ token="<token>",+ base_url="https://yourhost.com/path/to/api",+)++client.settings.mcp_servers.list()++```+</dd>+</dl>+</dd>+</dl>++#### ⚙️ Parameters++<dl>+<dd>++<dl>+<dd>++**request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration.++</dd>+</dl>+</dd>+</dl>+++</dd>+</dl>+</details>++<details><summary><code>client.settings.mcp_servers.<a href="src/trueforge_sdk/settings/mcp_servers/client.py">create</a>(...) -> GetMcpServerResponse</code></summary>+<dl>+<dd>++#### 📝 Description++<dl>+<dd>++<dl>+<dd>++Creates an MCP server by `name`. Fails if `name` is already taken. Runs DCR registration when `auth.type` is `dcr`. Header secrets: real value required; redacted with no stored value returns 400.+</dd>+</dl>+</dd>+</dl>++#### 🔌 Usage++<dl>+<dd>++<dl>+<dd>++```python+from trueforge_sdk import TrueForge, RemoteMcpServerManifest++client = TrueForge(+ token="<token>",+ base_url="https://yourhost.com/path/to/api",+)++client.settings.mcp_servers.create(+ manifest=RemoteMcpServerManifest(+ description="description",+ name="name",+ type="remote",+ url="url",+ ),+)++```+</dd>+</dl>+</dd>+</dl>++#### ⚙️ Parameters++<dl>+<dd>++<dl>+<dd>++**manifest:** `McpServerManifest`++</dd>+</dl>++<dl>+<dd>++**request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration.++</dd>+</dl>+</dd>+</dl>+++</dd>+</dl>+</details>++<details><summary><code>client.settings.mcp_servers.<a href="src/trueforge_sdk/settings/mcp_servers/client.py">create_or_update</a>(...) -> GetMcpServerResponse</code></summary>+<dl>+<dd>++#### 📝 Description++<dl>+<dd>++<dl>+<dd>++Create or replace by `name`. Header secrets: real value sets/rotates; redacted keeps existing (400 if none).+</dd>+</dl>+</dd>+</dl>++#### 🔌 Usage++<dl>+<dd>++<dl>+<dd>++```python+from trueforge_sdk import TrueForge, RemoteMcpServerManifest++client = TrueForge(+ token="<token>",+ base_url="https://yourhost.com/path/to/api",+)++client.settings.mcp_servers.create_or_update(+ manifest=RemoteMcpServerManifest(+ description="description",+ name="name",+ type="remote",+ url="url",+ ),+)++```+</dd>+</dl>+</dd>+</dl>++#### ⚙️ Parameters++<dl>+<dd>++<dl>+<dd>++**manifest:** `McpServerManifest`++</dd>+</dl>++<dl>+<dd>++**request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration.++</dd>+</dl>+</dd>+</dl>+++</dd>+</dl>+</details>++<details><summary><code>client.settings.mcp_servers.<a href="src/trueforge_sdk/settings/mcp_servers/client.py">get</a>(...) -> GetMcpServerResponse</code></summary>+<dl>+<dd>++#### 📝 Description++<dl>+<dd>++<dl>+<dd>++A single MCP server by name, with nested live auth_status (settings / admin projection). Header auth values are redacted.+</dd>+</dl>+</dd>+</dl>++#### 🔌 Usage++<dl>+<dd>++<dl>+<dd>++```python+from trueforge_sdk import TrueForge++client = TrueForge(+ token="<token>",+ base_url="https://yourhost.com/path/to/api",+)++client.settings.mcp_servers.get(+ name="name",+)++```+</dd>+</dl>+</dd>+</dl>++#### ⚙️ Parameters++<dl>+<dd>++<dl>+<dd>++**name:** `str` — MCP server name.++</dd>+</dl>++<dl>+<dd>++**request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration.++</dd>+</dl>+</dd>+</dl>+++</dd>+</dl>+</details>++## Settings ModelProviders+<details><summary><code>client.settings.model_providers.<a href="src/trueforge_sdk/settings/model_providers/client.py">list</a>() -> ListModelProvidersResponse</code></summary>+<dl>+<dd>++#### 📝 Description++<dl>+<dd>++<dl>+<dd>++All configured providers with nested manifests.+</dd>+</dl>+</dd>+</dl>++#### 🔌 Usage++<dl>+<dd>++<dl>+<dd>++```python+from trueforge_sdk import TrueForge++client = TrueForge(+ token="<token>",+ base_url="https://yourhost.com/path/to/api",+)++client.settings.model_providers.list()++```+</dd>+</dl>+</dd>+</dl>++#### ⚙️ Parameters++<dl>+<dd>++<dl>+<dd>++**request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration.++</dd>+</dl>+</dd>+</dl>+++</dd>+</dl>+</details>++<details><summary><code>client.settings.model_providers.<a href="src/trueforge_sdk/settings/model_providers/client.py">create</a>(...) -> GetModelProviderResponse</code></summary>+<dl>+<dd>++#### 📝 Description++<dl>+<dd>++<dl>+<dd>++Creates a provider (models included). Fails if `name` is already taken. Well-known types use `type` as `name` (one each); `custom` is named by the caller. `auth.api_key`: real value required; redacted with no stored secret returns 400.+</dd>+</dl>+</dd>+</dl>++#### 🔌 Usage++<dl>+<dd>++<dl>+<dd>++```python+from trueforge_sdk import TrueForge, AlibabaModelProvider, ModelProviderAuth, ConfiguredModel, ModelProperties++client = TrueForge(+ token="<token>",+ base_url="https://yourhost.com/path/to/api",+)++client.settings.model_providers.create(+ manifest=AlibabaModelProvider(+ auth=ModelProviderAuth(+ api_key="api_key",+ ),+ models=[+ ConfiguredModel(+ model_id="model_id",+ name="name",+ properties=ModelProperties(),+ )+ ],+ type="alibaba",+ ),+)++```+</dd>+</dl>+</dd>+</dl>++#### ⚙️ Parameters++<dl>+<dd>++<dl>+<dd>++**manifest:** `ModelProviderManifest`++</dd>+</dl>++<dl>+<dd>++**request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration.++</dd>+</dl>+</dd>+</dl>+++</dd>+</dl>+</details>++<details><summary><code>client.settings.model_providers.<a href="src/trueforge_sdk/settings/model_providers/client.py">create_or_update</a>(...) -> GetModelProviderResponse</code></summary>+<dl>+<dd>++#### 📝 Description++<dl>+<dd>++<dl>+<dd>++Create or replace a provider (models included). Well-known types use `type` as `name` (one each); `custom` is named by the caller. `auth.api_key`: real value sets/rotates; redacted keeps existing (400 if none).+</dd>+</dl>+</dd>+</dl>++#### 🔌 Usage++<dl>+<dd>++<dl>+<dd>++```python+from trueforge_sdk import TrueForge, AlibabaModelProvider, ModelProviderAuth, ConfiguredModel, ModelProperties++client = TrueForge(+ token="<token>",+ base_url="https://yourhost.com/path/to/api",+)++client.settings.model_providers.create_or_update(+ manifest=AlibabaModelProvider(+ auth=ModelProviderAuth(+ api_key="api_key",+ ),+ models=[+ ConfiguredModel(+ model_id="model_id",+ name="name",+ properties=ModelProperties(),+ )+ ],+ type="alibaba",+ ),+)++```+</dd>+</dl>+</dd>+</dl>++#### ⚙️ Parameters++<dl>+<dd>++<dl>+<dd>++**manifest:** `ModelProviderManifest`++</dd>+</dl>++<dl>+<dd>++**request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration.++</dd>+</dl>+</dd>+</dl>+++</dd>+</dl>+</details>++## Settings SandboxProviders+<details><summary><code>client.settings.sandbox_providers.<a href="src/trueforge_sdk/settings/sandbox_providers/client.py">get</a>() -> GetSandboxProviderResponse</code></summary>+<dl>+<dd>++#### 📝 Description++<dl>+<dd>++<dl>+<dd>++The single configured sandbox provider for this tenant. `auth.api_key` is redacted.+</dd>+</dl>+</dd>+</dl>++#### 🔌 Usage++<dl>+<dd>++<dl>+<dd>++```python+from trueforge_sdk import TrueForge++client = TrueForge(+ token="<token>",+ base_url="https://yourhost.com/path/to/api",+)++client.settings.sandbox_providers.get()++```+</dd>+</dl>+</dd>+</dl>++#### ⚙️ Parameters++<dl>+<dd>++<dl>+<dd>++**request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration.++</dd>+</dl>+</dd>+</dl>+++</dd>+</dl>+</details>++<details><summary><code>client.settings.sandbox_providers.<a href="src/trueforge_sdk/settings/sandbox_providers/client.py">create_or_update</a>(...) -> GetSandboxProviderResponse</code></summary>+<dl>+<dd>++#### 📝 Description++<dl>+<dd>++<dl>+<dd>++Upserts the single sandbox provider for this tenant: creates it or replaces its entire configuration. `auth.api_key`: real value sets/rotates; redacted keeps existing (400 if none).+</dd>+</dl>+</dd>+</dl>++#### 🔌 Usage++<dl>+<dd>++<dl>+<dd>++```python+from trueforge_sdk import TrueForge, SandboxProviderManifest, DaytonaSandboxProviderAuth++client = TrueForge(+ token="<token>",+ base_url="https://yourhost.com/path/to/api",+)++client.settings.sandbox_providers.create_or_update(+ manifest=SandboxProviderManifest(+ auth=DaytonaSandboxProviderAuth(+ api_key="api_key",+ ),+ auto_archive_interval_in_minutes=1,+ auto_delete_interval_in_minutes=1,+ auto_stop_interval_in_minutes=1,+ exec_timeout_ms=1,+ type="daytona",+ ),+)++```+</dd>+</dl>+</dd>+</dl>++#### ⚙️ Parameters++<dl>+<dd>++<dl>+<dd>++**manifest:** `SandboxProviderManifest`++</dd>+</dl>++<dl>+<dd>++**request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration.++</dd>+</dl>+</dd>+</dl>+++</dd>+</dl>+</details>++## Settings Skills+<details><summary><code>client.settings.skills.<a href="src/trueforge_sdk/settings/skills/client.py">list</a>() -> ListSkillsResponse</code></summary>+<dl>+<dd>++#### 📝 Description++<dl>+<dd>++<dl>+<dd>++All configured skills with nested manifests (settings / admin projection).+</dd>+</dl>+</dd>+</dl>++#### 🔌 Usage++<dl>+<dd>++<dl>+<dd>++```python+from trueforge_sdk import TrueForge++client = TrueForge(+ token="<token>",+ base_url="https://yourhost.com/path/to/api",+)++client.settings.skills.list()++```+</dd>+</dl>+</dd>+</dl>++#### ⚙️ Parameters++<dl>+<dd>++<dl>+<dd>++**request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration.++</dd>+</dl>+</dd>+</dl>+++</dd>+</dl>+</details>++<details><summary><code>client.settings.skills.<a href="src/trueforge_sdk/settings/skills/client.py">create</a>(...) -> GetSkillResponse</code></summary>+<dl>+<dd>++#### 📝 Description++<dl>+<dd>++<dl>+<dd>++Creates a skill keyed by `name`. Fails if `name` is already taken.+</dd>+</dl>+</dd>+</dl>++#### 🔌 Usage++<dl>+<dd>++<dl>+<dd>++```python+from trueforge_sdk import TrueForge, GitSkill++client = TrueForge(+ token="<token>",+ base_url="https://yourhost.com/path/to/api",+)++client.settings.skills.create(+ manifest=GitSkill(+ description="description",+ name="name",+ ref="ref",+ type="git",+ url="url",+ ),+)++```+</dd>+</dl>+</dd>+</dl>++#### ⚙️ Parameters++<dl>+<dd>++<dl>+<dd>++**manifest:** `SkillManifest`++</dd>+</dl>++<dl>+<dd>++**request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration.++</dd>+</dl>+</dd>+</dl>+++</dd>+</dl>+</details>++<details><summary><code>client.settings.skills.<a href="src/trueforge_sdk/settings/skills/client.py">create_or_update</a>(...) -> GetSkillResponse</code></summary>+<dl>+<dd>++#### 📝 Description++<dl>+<dd>++<dl>+<dd>++Full upsert keyed by `name`: creates the skill or replaces its entire manifest.+</dd>+</dl>+</dd>+</dl>++#### 🔌 Usage++<dl>+<dd>++<dl>+<dd>++```python+from trueforge_sdk import TrueForge, GitSkill++client = TrueForge(+ token="<token>",+ base_url="https://yourhost.com/path/to/api",+)++client.settings.skills.create_or_update(+ manifest=GitSkill(+ description="description",+ name="name",+ ref="ref",+ type="git",+ url="url",+ ),+)++```+</dd>+</dl>+</dd>+</dl>++#### ⚙️ Parameters++<dl>+<dd>++<dl>+<dd>++**manifest:** `SkillManifest`++</dd>+</dl>++<dl>+<dd>++**request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration.++</dd>+</dl>+</dd>+</dl>+++</dd>+</dl>+</details>+diff --git a/python/trueforge_sdk/requirements.txt b/python/trueforge_sdk/requirements.txtnew file mode 100644index 000000000..443b1af40--- /dev/null+++ b/python/trueforge_sdk/requirements.txt@@ -0,0 +1,4 @@+httpx>=0.21.2+pydantic>= 1.9.2+pydantic-core>=2.18.2,<3.0.0+typing_extensions>= 4.0.0diff --git a/python/trueforge_sdk/src/trueforge_sdk/__init__.py b/python/trueforge_sdk/src/trueforge_sdk/__init__.pynew file mode 100644index 000000000..47d8597df--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/__init__.py@@ -0,0 +1,798 @@+# This file was auto-generated by Fern from our API Definition.++# isort: skip_file++import typing+from importlib import import_module++if typing.TYPE_CHECKING:+ from .types import (+ ActionRequiredEvent,+ Agent,+ AgentCodeSnippet,+ AgentCodeSnippetSampleCode,+ AgentCodeSnippets,+ AgentInfo,+ AgentParent,+ AgentSpec,+ AlibabaModelProvider,+ AnthropicModelProvider,+ ApprovalAllow,+ ApprovalDecision,+ ApprovalDeny,+ AskUserQuestionsConfig,+ AvailableMcpServer,+ AvailableModel,+ AvailableModelProvider,+ AvailableSkill,+ BaseMcpAuthRequiredEvent,+ BaseThreadDoneEvent,+ CancelSessionResponse,+ CapabilitiesData,+ CatalogCustomModelProvider,+ CatalogMcpServer,+ CatalogMcpServerType,+ CatalogModel,+ CatalogModelProvider,+ CatalogSandboxProvider,+ CatalogSkill,+ CatalogSkillType,+ CatalogWellKnownModelProvider,+ CatalogWellKnownModelProviderType,+ ChatCompletionChunkDeltaToolCall,+ ChatCompletionChunkDeltaToolCallFunction,+ ChatCompletionContentPartRefusal,+ ChatCompletionContentPartText,+ ChatCompletionMessageToolCall,+ ChatCompletionMessageToolCallFunction,+ CompactionConfig,+ ConfiguredMcpServer,+ ConfiguredModel,+ ConfiguredModelProvider,+ ConfiguredSandboxProvider,+ ConfiguredSkill,+ ContextManagementConfig,+ CreateScheduleRunResponse,+ CreateSessionAgent,+ CreatedBySubject,+ CronExpression,+ CustomModelProvider,+ DaytonaSandboxProviderAuth,+ DeleteAgentResponse,+ DeleteScheduleResponse,+ DynamicSubAgentsConfig,+ ExtendedChunkDeltaToolCall,+ FileContent,+ FinishReason,+ FireworksModelProvider,+ GenerativeUiConfig,+ GetAgentCodeSnippetsResponse,+ GetAgentResponse,+ GetAvailableMcpServerResponse,+ GetCapabilitiesResponse,+ GetMcpServerCatalogResponse,+ GetMcpServerResponse,+ GetMeResponse,+ GetMeSubject,+ GetModelProviderCatalogResponse,+ GetModelProviderResponse,+ GetSandboxProviderCatalogResponse,+ GetSandboxProviderResponse,+ GetScheduleResponse,+ GetSessionMetricsChartDataResponse,+ GetSessionMetricsChartResponse,+ GetSessionMetricsMeterResponse,+ GetSessionResponse,+ GetSkillCatalogResponse,+ GetSkillResponse,+ GetTurnResponse,+ GitSkill,+ GoogleGeminiModelProvider,+ InitialUserMessage,+ InputTokensCompactionTrigger,+ LargeToolResponseConfig,+ ListAgentsResponse,+ ListAvailableMcpServersResponse,+ ListAvailableModelsResponse,+ ListAvailableSkillsResponse,+ ListMcpServerToolsResponse,+ ListMcpServersResponse,+ ListModelProvidersResponse,+ ListPermissionsResponse,+ ListScheduleRunsResponse,+ ListSchedulesResponse,+ ListSessionEventsResponse,+ ListSessionsOrder,+ ListSessionsResponse,+ ListSkillVersionsResponse,+ ListSkillsResponse,+ ListTurnEventsOrder,+ ListTurnEventsResponse,+ ListTurnsResponse,+ McpAuthRequiredEvent,+ McpAuthStatus,+ McpAuthStatusStatus,+ McpInitializeEvent,+ McpServer,+ McpServerApprovalToolSelector,+ McpServerAuthInfo,+ McpServerAuthPublic,+ McpServerAuthPublicOne,+ McpServerAuthPublicZero,+ McpServerDcrAuth,+ McpServerHeaderAuth,+ McpServerInitInfo,+ McpServerInitInfoTransportType,+ McpServerManifest,+ McpServerManifestAuth,+ McpServerToolSelector,+ McpToolInfo,+ Me,+ MeSessionType,+ MetricsUnit,+ Model,+ ModelMessageDeltaEvent,+ ModelMessageEvent,+ ModelMessageEventContent,+ ModelMessageEventContentOneItem,+ ModelMessageUsage,+ ModelMessageUsageInputTokensBreakdown,+ ModelParams,+ ModelProperties,+ ModelProviderAuth,+ ModelProviderManifest,+ MoonshotModelProvider,+ OpenAiModelProvider,+ PermissionResourceType,+ PreviousTurnIdInput,+ RawToolCall,+ ReasoningEffort,+ RemoteMcpServerManifest,+ RequestErrorResponse,+ RequestErrorResponseError,+ ResourceName,+ ResourcePermission,+ ResponseFormat,+ ResponseFormatJsonObject,+ ResponseFormatJsonSchema,+ ResponseFormatJsonSchemaJsonSchema,+ ResponseFormatText,+ RuntimeConfig,+ SandboxBuildStatus,+ SandboxCapability,+ SandboxConfig,+ SandboxCreatedEvent,+ SandboxProviderManifest,+ Schedule,+ ScheduleManifest,+ ScheduleRun,+ ScheduleRunStatus,+ ScheduleStatus,+ Session,+ SessionAgent,+ SessionAgentInline,+ SessionAgentNameRef,+ SessionAgentReference,+ SessionAgentSpecBody,+ SessionEvent,+ SessionEventItem,+ SessionMetadata,+ SessionMetrics,+ SessionMetricsChart,+ SessionMetricsChartDataResponse,+ SessionMetricsChartName,+ SessionMetricsChartResponse,+ SessionMetricsGraph,+ SessionMetricsGraphLine,+ SessionMetricsMeter,+ SessionMetricsMeterName,+ SessionMetricsMeterResponse,+ SessionMetricsPoint,+ SessionSource,+ SessionSourceSchedule,+ SessionSourceType,+ SettingsCapability,+ Skill,+ SkillCapability,+ SkillManifest,+ SkillVersion,+ TextContent,+ ThreadCreatedEvent,+ ThreadDoneEvent,+ ThreadState,+ ThreadStateDone,+ ThreadStateError,+ Timezone,+ TogetherAiModelProvider,+ TokenPagination,+ ToolApprovalRequiredEvent,+ ToolCall,+ ToolCallRef,+ ToolInfo,+ ToolResponseEvent,+ ToolResponseRequiredEvent,+ TrueFoundryMcpServerManifest,+ TrueFoundryModelProvider,+ TrueFoundryRegistrySkill,+ TrueFoundrySystemToolInfo,+ Turn,+ TurnCreatedEvent,+ TurnDoneEvent,+ TurnDoneEventState,+ TurnInputItem,+ TurnMetrics,+ TurnState,+ TurnStateCancelled,+ TurnStateCancelledMetrics,+ TurnStateCancelledReason,+ TurnStateDone,+ TurnStateError,+ TurnStateErrorMetrics,+ TurnStateRunning,+ TurnStreamingEvent,+ UserMessage,+ UserMessageContent,+ UserMessageContentItem,+ UserToolApprovalEvent,+ UserToolResponseEvent,+ ZaiModelProvider,+ )+ from .errors import (+ BadGatewayError,+ BadRequestError,+ ConflictError,+ ContentTooLargeError,+ FailedDependencyError,+ ForbiddenError,+ GoneError,+ InternalServerError,+ NotFoundError,+ PreconditionFailedError,+ UnauthorizedError,+ UnprocessableEntityError,+ )+ from . import agents, auth, catalogs, internal, mcp_servers, models, schedules, server, sessions, settings, skills+ from ._default_clients import DefaultAioHttpClient, DefaultAsyncHttpxClient+ from .client import AsyncTrueForge, TrueForge+ from .version import __version__+_dynamic_imports: typing.Dict[str, str] = {+ "ActionRequiredEvent": ".types",+ "Agent": ".types",+ "AgentCodeSnippet": ".types",+ "AgentCodeSnippetSampleCode": ".types",+ "AgentCodeSnippets": ".types",+ "AgentInfo": ".types",+ "AgentParent": ".types",+ "AgentSpec": ".types",+ "AlibabaModelProvider": ".types",+ "AnthropicModelProvider": ".types",+ "ApprovalAllow": ".types",+ "ApprovalDecision": ".types",+ "ApprovalDeny": ".types",+ "AskUserQuestionsConfig": ".types",+ "AsyncTrueForge": ".client",+ "AvailableMcpServer": ".types",+ "AvailableModel": ".types",+ "AvailableModelProvider": ".types",+ "AvailableSkill": ".types",+ "BadGatewayError": ".errors",+ "BadRequestError": ".errors",+ "BaseMcpAuthRequiredEvent": ".types",+ "BaseThreadDoneEvent": ".types",+ "CancelSessionResponse": ".types",+ "CapabilitiesData": ".types",+ "CatalogCustomModelProvider": ".types",+ "CatalogMcpServer": ".types",+ "CatalogMcpServerType": ".types",+ "CatalogModel": ".types",+ "CatalogModelProvider": ".types",+ "CatalogSandboxProvider": ".types",+ "CatalogSkill": ".types",+ "CatalogSkillType": ".types",+ "CatalogWellKnownModelProvider": ".types",+ "CatalogWellKnownModelProviderType": ".types",+ "ChatCompletionChunkDeltaToolCall": ".types",+ "ChatCompletionChunkDeltaToolCallFunction": ".types",+ "ChatCompletionContentPartRefusal": ".types",+ "ChatCompletionContentPartText": ".types",+ "ChatCompletionMessageToolCall": ".types",+ "ChatCompletionMessageToolCallFunction": ".types",+ "CompactionConfig": ".types",+ "ConfiguredMcpServer": ".types",+ "ConfiguredModel": ".types",+ "ConfiguredModelProvider": ".types",+ "ConfiguredSandboxProvider": ".types",+ "ConfiguredSkill": ".types",+ "ConflictError": ".errors",+ "ContentTooLargeError": ".errors",+ "ContextManagementConfig": ".types",+ "CreateScheduleRunResponse": ".types",+ "CreateSessionAgent": ".types",+ "CreatedBySubject": ".types",+ "CronExpression": ".types",+ "CustomModelProvider": ".types",+ "DaytonaSandboxProviderAuth": ".types",+ "DefaultAioHttpClient": "._default_clients",+ "DefaultAsyncHttpxClient": "._default_clients",+ "DeleteAgentResponse": ".types",+ "DeleteScheduleResponse": ".types",+ "DynamicSubAgentsConfig": ".types",+ "ExtendedChunkDeltaToolCall": ".types",+ "FailedDependencyError": ".errors",+ "FileContent": ".types",+ "FinishReason": ".types",+ "FireworksModelProvider": ".types",+ "ForbiddenError": ".errors",+ "GenerativeUiConfig": ".types",+ "GetAgentCodeSnippetsResponse": ".types",+ "GetAgentResponse": ".types",+ "GetAvailableMcpServerResponse": ".types",+ "GetCapabilitiesResponse": ".types",+ "GetMcpServerCatalogResponse": ".types",+ "GetMcpServerResponse": ".types",+ "GetMeResponse": ".types",+ "GetMeSubject": ".types",+ "GetModelProviderCatalogResponse": ".types",+ "GetModelProviderResponse": ".types",+ "GetSandboxProviderCatalogResponse": ".types",+ "GetSandboxProviderResponse": ".types",+ "GetScheduleResponse": ".types",+ "GetSessionMetricsChartDataResponse": ".types",+ "GetSessionMetricsChartResponse": ".types",+ "GetSessionMetricsMeterResponse": ".types",+ "GetSessionResponse": ".types",+ "GetSkillCatalogResponse": ".types",+ "GetSkillResponse": ".types",+ "GetTurnResponse": ".types",+ "GitSkill": ".types",+ "GoneError": ".errors",+ "GoogleGeminiModelProvider": ".types",+ "InitialUserMessage": ".types",+ "InputTokensCompactionTrigger": ".types",+ "InternalServerError": ".errors",+ "LargeToolResponseConfig": ".types",+ "ListAgentsResponse": ".types",+ "ListAvailableMcpServersResponse": ".types",+ "ListAvailableModelsResponse": ".types",+ "ListAvailableSkillsResponse": ".types",+ "ListMcpServerToolsResponse": ".types",+ "ListMcpServersResponse": ".types",+ "ListModelProvidersResponse": ".types",+ "ListPermissionsResponse": ".types",+ "ListScheduleRunsResponse": ".types",+ "ListSchedulesResponse": ".types",+ "ListSessionEventsResponse": ".types",+ "ListSessionsOrder": ".types",+ "ListSessionsResponse": ".types",+ "ListSkillVersionsResponse": ".types",+ "ListSkillsResponse": ".types",+ "ListTurnEventsOrder": ".types",+ "ListTurnEventsResponse": ".types",+ "ListTurnsResponse": ".types",+ "McpAuthRequiredEvent": ".types",+ "McpAuthStatus": ".types",+ "McpAuthStatusStatus": ".types",+ "McpInitializeEvent": ".types",+ "McpServer": ".types",+ "McpServerApprovalToolSelector": ".types",+ "McpServerAuthInfo": ".types",+ "McpServerAuthPublic": ".types",+ "McpServerAuthPublicOne": ".types",+ "McpServerAuthPublicZero": ".types",+ "McpServerDcrAuth": ".types",+ "McpServerHeaderAuth": ".types",+ "McpServerInitInfo": ".types",+ "McpServerInitInfoTransportType": ".types",+ "McpServerManifest": ".types",+ "McpServerManifestAuth": ".types",+ "McpServerToolSelector": ".types",+ "McpToolInfo": ".types",+ "Me": ".types",+ "MeSessionType": ".types",+ "MetricsUnit": ".types",+ "Model": ".types",+ "ModelMessageDeltaEvent": ".types",+ "ModelMessageEvent": ".types",+ "ModelMessageEventContent": ".types",+ "ModelMessageEventContentOneItem": ".types",+ "ModelMessageUsage": ".types",+ "ModelMessageUsageInputTokensBreakdown": ".types",+ "ModelParams": ".types",+ "ModelProperties": ".types",+ "ModelProviderAuth": ".types",+ "ModelProviderManifest": ".types",+ "MoonshotModelProvider": ".types",+ "NotFoundError": ".errors",+ "OpenAiModelProvider": ".types",+ "PermissionResourceType": ".types",+ "PreconditionFailedError": ".errors",+ "PreviousTurnIdInput": ".types",+ "RawToolCall": ".types",+ "ReasoningEffort": ".types",+ "RemoteMcpServerManifest": ".types",+ "RequestErrorResponse": ".types",+ "RequestErrorResponseError": ".types",+ "ResourceName": ".types",+ "ResourcePermission": ".types",+ "ResponseFormat": ".types",+ "ResponseFormatJsonObject": ".types",+ "ResponseFormatJsonSchema": ".types",+ "ResponseFormatJsonSchemaJsonSchema": ".types",+ "ResponseFormatText": ".types",+ "RuntimeConfig": ".types",+ "SandboxBuildStatus": ".types",+ "SandboxCapability": ".types",+ "SandboxConfig": ".types",+ "SandboxCreatedEvent": ".types",+ "SandboxProviderManifest": ".types",+ "Schedule": ".types",+ "ScheduleManifest": ".types",+ "ScheduleRun": ".types",+ "ScheduleRunStatus": ".types",+ "ScheduleStatus": ".types",+ "Session": ".types",+ "SessionAgent": ".types",+ "SessionAgentInline": ".types",+ "SessionAgentNameRef": ".types",+ "SessionAgentReference": ".types",+ "SessionAgentSpecBody": ".types",+ "SessionEvent": ".types",+ "SessionEventItem": ".types",+ "SessionMetadata": ".types",+ "SessionMetrics": ".types",+ "SessionMetricsChart": ".types",+ "SessionMetricsChartDataResponse": ".types",+ "SessionMetricsChartName": ".types",+ "SessionMetricsChartResponse": ".types",+ "SessionMetricsGraph": ".types",+ "SessionMetricsGraphLine": ".types",+ "SessionMetricsMeter": ".types",+ "SessionMetricsMeterName": ".types",+ "SessionMetricsMeterResponse": ".types",+ "SessionMetricsPoint": ".types",+ "SessionSource": ".types",+ "SessionSourceSchedule": ".types",+ "SessionSourceType": ".types",+ "SettingsCapability": ".types",+ "Skill": ".types",+ "SkillCapability": ".types",+ "SkillManifest": ".types",+ "SkillVersion": ".types",+ "TextContent": ".types",+ "ThreadCreatedEvent": ".types",+ "ThreadDoneEvent": ".types",+ "ThreadState": ".types",+ "ThreadStateDone": ".types",+ "ThreadStateError": ".types",+ "Timezone": ".types",+ "TogetherAiModelProvider": ".types",+ "TokenPagination": ".types",+ "ToolApprovalRequiredEvent": ".types",+ "ToolCall": ".types",+ "ToolCallRef": ".types",+ "ToolInfo": ".types",+ "ToolResponseEvent": ".types",+ "ToolResponseRequiredEvent": ".types",+ "TrueForge": ".client",+ "TrueFoundryMcpServerManifest": ".types",+ "TrueFoundryModelProvider": ".types",+ "TrueFoundryRegistrySkill": ".types",+ "TrueFoundrySystemToolInfo": ".types",+ "Turn": ".types",+ "TurnCreatedEvent": ".types",+ "TurnDoneEvent": ".types",+ "TurnDoneEventState": ".types",+ "TurnInputItem": ".types",+ "TurnMetrics": ".types",+ "TurnState": ".types",+ "TurnStateCancelled": ".types",+ "TurnStateCancelledMetrics": ".types",+ "TurnStateCancelledReason": ".types",+ "TurnStateDone": ".types",+ "TurnStateError": ".types",+ "TurnStateErrorMetrics": ".types",+ "TurnStateRunning": ".types",+ "TurnStreamingEvent": ".types",+ "UnauthorizedError": ".errors",+ "UnprocessableEntityError": ".errors",+ "UserMessage": ".types",+ "UserMessageContent": ".types",+ "UserMessageContentItem": ".types",+ "UserToolApprovalEvent": ".types",+ "UserToolResponseEvent": ".types",+ "ZaiModelProvider": ".types",+ "__version__": ".version",+ "agents": ".agents",+ "auth": ".auth",+ "catalogs": ".catalogs",+ "internal": ".internal",+ "mcp_servers": ".mcp_servers",+ "models": ".models",+ "schedules": ".schedules",+ "server": ".server",+ "sessions": ".sessions",+ "settings": ".settings",+ "skills": ".skills",+}+++def __getattr__(attr_name: str) -> typing.Any:+ module_name = _dynamic_imports.get(attr_name)+ if module_name is None:+ raise AttributeError(f"No {attr_name} found in _dynamic_imports for module name -> {__name__}")+ try:+ module = import_module(module_name, __package__)+ if module_name == f".{attr_name}":+ return module+ else:+ return getattr(module, attr_name)+ except ImportError as e:+ raise ImportError(f"Failed to import {attr_name} from {module_name}: {e}") from e+ except AttributeError as e:+ raise AttributeError(f"Failed to get {attr_name} from {module_name}: {e}") from e+++def __dir__():+ lazy_attrs = list(_dynamic_imports.keys())+ return sorted(lazy_attrs)+++__all__ = [+ "ActionRequiredEvent",+ "Agent",+ "AgentCodeSnippet",+ "AgentCodeSnippetSampleCode",+ "AgentCodeSnippets",+ "AgentInfo",+ "AgentParent",+ "AgentSpec",+ "AlibabaModelProvider",+ "AnthropicModelProvider",+ "ApprovalAllow",+ "ApprovalDecision",+ "ApprovalDeny",+ "AskUserQuestionsConfig",+ "AsyncTrueForge",+ "AvailableMcpServer",+ "AvailableModel",+ "AvailableModelProvider",+ "AvailableSkill",+ "BadGatewayError",+ "BadRequestError",+ "BaseMcpAuthRequiredEvent",+ "BaseThreadDoneEvent",+ "CancelSessionResponse",+ "CapabilitiesData",+ "CatalogCustomModelProvider",+ "CatalogMcpServer",+ "CatalogMcpServerType",+ "CatalogModel",+ "CatalogModelProvider",+ "CatalogSandboxProvider",+ "CatalogSkill",+ "CatalogSkillType",+ "CatalogWellKnownModelProvider",+ "CatalogWellKnownModelProviderType",+ "ChatCompletionChunkDeltaToolCall",+ "ChatCompletionChunkDeltaToolCallFunction",+ "ChatCompletionContentPartRefusal",+ "ChatCompletionContentPartText",+ "ChatCompletionMessageToolCall",+ "ChatCompletionMessageToolCallFunction",+ "CompactionConfig",+ "ConfiguredMcpServer",+ "ConfiguredModel",+ "ConfiguredModelProvider",+ "ConfiguredSandboxProvider",+ "ConfiguredSkill",+ "ConflictError",+ "ContentTooLargeError",+ "ContextManagementConfig",+ "CreateScheduleRunResponse",+ "CreateSessionAgent",+ "CreatedBySubject",+ "CronExpression",+ "CustomModelProvider",+ "DaytonaSandboxProviderAuth",+ "DefaultAioHttpClient",+ "DefaultAsyncHttpxClient",+ "DeleteAgentResponse",+ "DeleteScheduleResponse",+ "DynamicSubAgentsConfig",+ "ExtendedChunkDeltaToolCall",+ "FailedDependencyError",+ "FileContent",+ "FinishReason",+ "FireworksModelProvider",+ "ForbiddenError",+ "GenerativeUiConfig",+ "GetAgentCodeSnippetsResponse",+ "GetAgentResponse",+ "GetAvailableMcpServerResponse",+ "GetCapabilitiesResponse",+ "GetMcpServerCatalogResponse",+ "GetMcpServerResponse",+ "GetMeResponse",+ "GetMeSubject",+ "GetModelProviderCatalogResponse",+ "GetModelProviderResponse",+ "GetSandboxProviderCatalogResponse",+ "GetSandboxProviderResponse",+ "GetScheduleResponse",+ "GetSessionMetricsChartDataResponse",+ "GetSessionMetricsChartResponse",+ "GetSessionMetricsMeterResponse",+ "GetSessionResponse",+ "GetSkillCatalogResponse",+ "GetSkillResponse",+ "GetTurnResponse",+ "GitSkill",+ "GoneError",+ "GoogleGeminiModelProvider",+ "InitialUserMessage",+ "InputTokensCompactionTrigger",+ "InternalServerError",+ "LargeToolResponseConfig",+ "ListAgentsResponse",+ "ListAvailableMcpServersResponse",+ "ListAvailableModelsResponse",+ "ListAvailableSkillsResponse",+ "ListMcpServerToolsResponse",+ "ListMcpServersResponse",+ "ListModelProvidersResponse",+ "ListPermissionsResponse",+ "ListScheduleRunsResponse",+ "ListSchedulesResponse",+ "ListSessionEventsResponse",+ "ListSessionsOrder",+ "ListSessionsResponse",+ "ListSkillVersionsResponse",+ "ListSkillsResponse",+ "ListTurnEventsOrder",+ "ListTurnEventsResponse",+ "ListTurnsResponse",+ "McpAuthRequiredEvent",+ "McpAuthStatus",+ "McpAuthStatusStatus",+ "McpInitializeEvent",+ "McpServer",+ "McpServerApprovalToolSelector",+ "McpServerAuthInfo",+ "McpServerAuthPublic",+ "McpServerAuthPublicOne",+ "McpServerAuthPublicZero",+ "McpServerDcrAuth",+ "McpServerHeaderAuth",+ "McpServerInitInfo",+ "McpServerInitInfoTransportType",+ "McpServerManifest",+ "McpServerManifestAuth",+ "McpServerToolSelector",+ "McpToolInfo",+ "Me",+ "MeSessionType",+ "MetricsUnit",+ "Model",+ "ModelMessageDeltaEvent",+ "ModelMessageEvent",+ "ModelMessageEventContent",+ "ModelMessageEventContentOneItem",+ "ModelMessageUsage",+ "ModelMessageUsageInputTokensBreakdown",+ "ModelParams",+ "ModelProperties",+ "ModelProviderAuth",+ "ModelProviderManifest",+ "MoonshotModelProvider",+ "NotFoundError",+ "OpenAiModelProvider",+ "PermissionResourceType",+ "PreconditionFailedError",+ "PreviousTurnIdInput",+ "RawToolCall",+ "ReasoningEffort",+ "RemoteMcpServerManifest",+ "RequestErrorResponse",+ "RequestErrorResponseError",+ "ResourceName",+ "ResourcePermission",+ "ResponseFormat",+ "ResponseFormatJsonObject",+ "ResponseFormatJsonSchema",+ "ResponseFormatJsonSchemaJsonSchema",+ "ResponseFormatText",+ "RuntimeConfig",+ "SandboxBuildStatus",+ "SandboxCapability",+ "SandboxConfig",+ "SandboxCreatedEvent",+ "SandboxProviderManifest",+ "Schedule",+ "ScheduleManifest",+ "ScheduleRun",+ "ScheduleRunStatus",+ "ScheduleStatus",+ "Session",+ "SessionAgent",+ "SessionAgentInline",+ "SessionAgentNameRef",+ "SessionAgentReference",+ "SessionAgentSpecBody",+ "SessionEvent",+ "SessionEventItem",+ "SessionMetadata",+ "SessionMetrics",+ "SessionMetricsChart",+ "SessionMetricsChartDataResponse",+ "SessionMetricsChartName",+ "SessionMetricsChartResponse",+ "SessionMetricsGraph",+ "SessionMetricsGraphLine",+ "SessionMetricsMeter",+ "SessionMetricsMeterName",+ "SessionMetricsMeterResponse",+ "SessionMetricsPoint",+ "SessionSource",+ "SessionSourceSchedule",+ "SessionSourceType",+ "SettingsCapability",+ "Skill",+ "SkillCapability",+ "SkillManifest",+ "SkillVersion",+ "TextContent",+ "ThreadCreatedEvent",+ "ThreadDoneEvent",+ "ThreadState",+ "ThreadStateDone",+ "ThreadStateError",+ "Timezone",+ "TogetherAiModelProvider",+ "TokenPagination",+ "ToolApprovalRequiredEvent",+ "ToolCall",+ "ToolCallRef",+ "ToolInfo",+ "ToolResponseEvent",+ "ToolResponseRequiredEvent",+ "TrueForge",+ "TrueFoundryMcpServerManifest",+ "TrueFoundryModelProvider",+ "TrueFoundryRegistrySkill",+ "TrueFoundrySystemToolInfo",+ "Turn",+ "TurnCreatedEvent",+ "TurnDoneEvent",+ "TurnDoneEventState",+ "TurnInputItem",+ "TurnMetrics",+ "TurnState",+ "TurnStateCancelled",+ "TurnStateCancelledMetrics",+ "TurnStateCancelledReason",+ "TurnStateDone",+ "TurnStateError",+ "TurnStateErrorMetrics",+ "TurnStateRunning",+ "TurnStreamingEvent",+ "UnauthorizedError",+ "UnprocessableEntityError",+ "UserMessage",+ "UserMessageContent",+ "UserMessageContentItem",+ "UserToolApprovalEvent",+ "UserToolResponseEvent",+ "ZaiModelProvider",+ "__version__",+ "agents",+ "auth",+ "catalogs",+ "internal",+ "mcp_servers",+ "models",+ "schedules",+ "server",+ "sessions",+ "settings",+ "skills",+]diff --git a/python/trueforge_sdk/src/trueforge_sdk/_default_clients.py b/python/trueforge_sdk/src/trueforge_sdk/_default_clients.pynew file mode 100644index 000000000..12f6533c9--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/_default_clients.py@@ -0,0 +1,32 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import httpx++SDK_DEFAULT_TIMEOUT = 60++try:+ import httpx_aiohttp # type: ignore[import-not-found]+except ImportError:++ class DefaultAioHttpClient(httpx.AsyncClient): # type: ignore+ def __init__(self, **kwargs: typing.Any) -> None:+ raise RuntimeError(+ "To use the aiohttp client, install the aiohttp extra: pip install trueforge_sdk[aiohttp]"+ )++else:++ class DefaultAioHttpClient(httpx_aiohttp.HttpxAiohttpClient): # type: ignore+ def __init__(self, **kwargs: typing.Any) -> None:+ kwargs.setdefault("timeout", SDK_DEFAULT_TIMEOUT)+ kwargs.setdefault("follow_redirects", True)+ super().__init__(**kwargs)+++class DefaultAsyncHttpxClient(httpx.AsyncClient):+ def __init__(self, **kwargs: typing.Any) -> None:+ kwargs.setdefault("timeout", SDK_DEFAULT_TIMEOUT)+ kwargs.setdefault("follow_redirects", True)+ super().__init__(**kwargs)diff --git a/python/trueforge_sdk/src/trueforge_sdk/agents/__init__.py b/python/trueforge_sdk/src/trueforge_sdk/agents/__init__.pynew file mode 100644index 000000000..5cde0202d--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/agents/__init__.py@@ -0,0 +1,4 @@+# This file was auto-generated by Fern from our API Definition.++# isort: skip_file+diff --git a/python/trueforge_sdk/src/trueforge_sdk/agents/client.py b/python/trueforge_sdk/src/trueforge_sdk/agents/client.pynew file mode 100644index 000000000..26221e855--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/agents/client.py@@ -0,0 +1,507 @@+# This file was auto-generated by Fern from our API Definition.++import typing++from ..core.client_wrapper import AsyncClientWrapper, SyncClientWrapper+from ..core.request_options import RequestOptions+from ..types.agent_spec import AgentSpec+from ..types.delete_agent_response import DeleteAgentResponse+from ..types.get_agent_response import GetAgentResponse+from ..types.list_agents_response import ListAgentsResponse+from ..types.resource_name import ResourceName+from .raw_client import AsyncRawAgentsClient, RawAgentsClient++# this is used as the default value for optional parameters+OMIT = typing.cast(typing.Any, ...)+++class AgentsClient:+ def __init__(self, *, client_wrapper: SyncClientWrapper):+ self._raw_client = RawAgentsClient(client_wrapper=client_wrapper)++ @property+ def with_raw_response(self) -> RawAgentsClient:+ """+ Retrieves a raw implementation of this client that returns raw responses.++ Returns+ -------+ RawAgentsClient+ """+ return self._raw_client++ def list(+ self,+ *,+ limit: typing.Optional[int] = 50,+ page_token: typing.Optional[str] = None,+ agent_name: typing.Optional[str] = None,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> ListAgentsResponse:+ """+ List configured agents for the tenant, ordered by name. Optional `agent_name` filters by substring.++ Parameters+ ----------+ limit : typing.Optional[int]+ Page size. Defaults to 50, max 100.++ page_token : typing.Optional[str]+ Opaque token from a previous response `next_page_token`.++ agent_name : typing.Optional[str]+ Case-insensitive substring match on agent name.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ ListAgentsResponse+ Paginated matching agents.++ Examples+ --------+ from trueforge_sdk import TrueForge++ client = TrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+ client.agents.list()+ """+ _response = self._raw_client.list(+ limit=limit, page_token=page_token, agent_name=agent_name, request_options=request_options+ )+ return _response.data++ def create(+ self,+ *,+ description: str,+ manifest: AgentSpec,+ name: ResourceName,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> GetAgentResponse:+ """+ Creates an agent and allocates an immutable id. Fails if `name` is already taken. Name cannot be changed later.++ Parameters+ ----------+ description : str++ manifest : AgentSpec++ name : ResourceName++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ GetAgentResponse+ The created agent.++ Examples+ --------+ from trueforge_sdk import AgentSpec, Model, TrueForge++ client = TrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+ client.agents.create(+ description="description",+ manifest=AgentSpec(+ model=Model(+ name="name",+ ),+ ),+ name="name",+ )+ """+ _response = self._raw_client.create(+ description=description, manifest=manifest, name=name, request_options=request_options+ )+ return _response.data++ def get(self, *, agent_id: str, request_options: typing.Optional[RequestOptions] = None) -> GetAgentResponse:+ """+ Fetch a configured agent by immutable id.++ Parameters+ ----------+ agent_id : str+ Immutable agent identifier.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ GetAgentResponse+ The agent.++ Examples+ --------+ from trueforge_sdk import TrueForge++ client = TrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+ client.agents.get(+ agent_id="agent_id",+ )+ """+ _response = self._raw_client.get(agent_id=agent_id, request_options=request_options)+ return _response.data++ def update(+ self,+ *,+ agent_id: str,+ manifest: AgentSpec,+ description: typing.Optional[str] = OMIT,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> GetAgentResponse:+ """+ Update an existing agent by immutable id.++ Parameters+ ----------+ agent_id : str+ Immutable agent identifier.++ manifest : AgentSpec++ description : typing.Optional[str]++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ GetAgentResponse+ The saved agent.++ Examples+ --------+ from trueforge_sdk import AgentSpec, Model, TrueForge++ client = TrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+ client.agents.update(+ agent_id="agent_id",+ manifest=AgentSpec(+ model=Model(+ name="name",+ ),+ ),+ )+ """+ _response = self._raw_client.update(+ agent_id=agent_id, manifest=manifest, description=description, request_options=request_options+ )+ return _response.data++ def delete(self, *, agent_id: str, request_options: typing.Optional[RequestOptions] = None) -> DeleteAgentResponse:+ """+ Delete a configured agent by immutable id.++ Parameters+ ----------+ agent_id : str+ Immutable agent identifier.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ DeleteAgentResponse+ Agent deleted.++ Examples+ --------+ from trueforge_sdk import TrueForge++ client = TrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+ client.agents.delete(+ agent_id="agent_id",+ )+ """+ _response = self._raw_client.delete(agent_id=agent_id, request_options=request_options)+ return _response.data+++class AsyncAgentsClient:+ def __init__(self, *, client_wrapper: AsyncClientWrapper):+ self._raw_client = AsyncRawAgentsClient(client_wrapper=client_wrapper)++ @property+ def with_raw_response(self) -> AsyncRawAgentsClient:+ """+ Retrieves a raw implementation of this client that returns raw responses.++ Returns+ -------+ AsyncRawAgentsClient+ """+ return self._raw_client++ async def list(+ self,+ *,+ limit: typing.Optional[int] = 50,+ page_token: typing.Optional[str] = None,+ agent_name: typing.Optional[str] = None,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> ListAgentsResponse:+ """+ List configured agents for the tenant, ordered by name. Optional `agent_name` filters by substring.++ Parameters+ ----------+ limit : typing.Optional[int]+ Page size. Defaults to 50, max 100.++ page_token : typing.Optional[str]+ Opaque token from a previous response `next_page_token`.++ agent_name : typing.Optional[str]+ Case-insensitive substring match on agent name.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ ListAgentsResponse+ Paginated matching agents.++ Examples+ --------+ import asyncio++ from trueforge_sdk import AsyncTrueForge++ client = AsyncTrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+++ async def main() -> None:+ await client.agents.list()+++ asyncio.run(main())+ """+ _response = await self._raw_client.list(+ limit=limit, page_token=page_token, agent_name=agent_name, request_options=request_options+ )+ return _response.data++ async def create(+ self,+ *,+ description: str,+ manifest: AgentSpec,+ name: ResourceName,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> GetAgentResponse:+ """+ Creates an agent and allocates an immutable id. Fails if `name` is already taken. Name cannot be changed later.++ Parameters+ ----------+ description : str++ manifest : AgentSpec++ name : ResourceName++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ GetAgentResponse+ The created agent.++ Examples+ --------+ import asyncio++ from trueforge_sdk import AgentSpec, AsyncTrueForge, Model++ client = AsyncTrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+++ async def main() -> None:+ await client.agents.create(+ description="description",+ manifest=AgentSpec(+ model=Model(+ name="name",+ ),+ ),+ name="name",+ )+++ asyncio.run(main())+ """+ _response = await self._raw_client.create(+ description=description, manifest=manifest, name=name, request_options=request_options+ )+ return _response.data++ async def get(self, *, agent_id: str, request_options: typing.Optional[RequestOptions] = None) -> GetAgentResponse:+ """+ Fetch a configured agent by immutable id.++ Parameters+ ----------+ agent_id : str+ Immutable agent identifier.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ GetAgentResponse+ The agent.++ Examples+ --------+ import asyncio++ from trueforge_sdk import AsyncTrueForge++ client = AsyncTrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+++ async def main() -> None:+ await client.agents.get(+ agent_id="agent_id",+ )+++ asyncio.run(main())+ """+ _response = await self._raw_client.get(agent_id=agent_id, request_options=request_options)+ return _response.data++ async def update(+ self,+ *,+ agent_id: str,+ manifest: AgentSpec,+ description: typing.Optional[str] = OMIT,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> GetAgentResponse:+ """+ Update an existing agent by immutable id.++ Parameters+ ----------+ agent_id : str+ Immutable agent identifier.++ manifest : AgentSpec++ description : typing.Optional[str]++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ GetAgentResponse+ The saved agent.++ Examples+ --------+ import asyncio++ from trueforge_sdk import AgentSpec, AsyncTrueForge, Model++ client = AsyncTrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+++ async def main() -> None:+ await client.agents.update(+ agent_id="agent_id",+ manifest=AgentSpec(+ model=Model(+ name="name",+ ),+ ),+ )+++ asyncio.run(main())+ """+ _response = await self._raw_client.update(+ agent_id=agent_id, manifest=manifest, description=description, request_options=request_options+ )+ return _response.data++ async def delete(+ self, *, agent_id: str, request_options: typing.Optional[RequestOptions] = None+ ) -> DeleteAgentResponse:+ """+ Delete a configured agent by immutable id.++ Parameters+ ----------+ agent_id : str+ Immutable agent identifier.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ DeleteAgentResponse+ Agent deleted.++ Examples+ --------+ import asyncio++ from trueforge_sdk import AsyncTrueForge++ client = AsyncTrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+++ async def main() -> None:+ await client.agents.delete(+ agent_id="agent_id",+ )+++ asyncio.run(main())+ """+ _response = await self._raw_client.delete(agent_id=agent_id, request_options=request_options)+ return _response.datadiff --git a/python/trueforge_sdk/src/trueforge_sdk/agents/raw_client.py b/python/trueforge_sdk/src/trueforge_sdk/agents/raw_client.pynew file mode 100644index 000000000..75d36a009--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/agents/raw_client.py@@ -0,0 +1,818 @@+# 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.jsonable_encoder import encode_path_param+from ..core.parse_error import ParsingError+from ..core.request_options import RequestOptions+from ..core.serialization import convert_and_respect_annotation_metadata+from ..core.unchecked_base_model import construct_type+from ..errors.bad_request_error import BadRequestError+from ..errors.conflict_error import ConflictError+from ..errors.not_found_error import NotFoundError+from ..errors.unauthorized_error import UnauthorizedError+from ..errors.unprocessable_entity_error import UnprocessableEntityError+from ..types.agent_spec import AgentSpec+from ..types.delete_agent_response import DeleteAgentResponse+from ..types.get_agent_response import GetAgentResponse+from ..types.list_agents_response import ListAgentsResponse+from ..types.request_error_response import RequestErrorResponse+from ..types.resource_name import ResourceName+from pydantic import ValidationError++# this is used as the default value for optional parameters+OMIT = typing.cast(typing.Any, ...)+++class RawAgentsClient:+ def __init__(self, *, client_wrapper: SyncClientWrapper):+ self._client_wrapper = client_wrapper++ def list(+ self,+ *,+ limit: typing.Optional[int] = 50,+ page_token: typing.Optional[str] = None,+ agent_name: typing.Optional[str] = None,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> HttpResponse[ListAgentsResponse]:+ """+ List configured agents for the tenant, ordered by name. Optional `agent_name` filters by substring.++ Parameters+ ----------+ limit : typing.Optional[int]+ Page size. Defaults to 50, max 100.++ page_token : typing.Optional[str]+ Opaque token from a previous response `next_page_token`.++ agent_name : typing.Optional[str]+ Case-insensitive substring match on agent name.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[ListAgentsResponse]+ Paginated matching agents.+ """+ _response = self._client_wrapper.httpx_client.request(+ "api/v1/agents",+ method="GET",+ params={+ "limit": limit,+ "page_token": page_token,+ "agent_name": agent_name,+ },+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ ListAgentsResponse,+ construct_type(+ type_=ListAgentsResponse, # 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(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 401:+ raise UnauthorizedError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ def create(+ self,+ *,+ description: str,+ manifest: AgentSpec,+ name: ResourceName,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> HttpResponse[GetAgentResponse]:+ """+ Creates an agent and allocates an immutable id. Fails if `name` is already taken. Name cannot be changed later.++ Parameters+ ----------+ description : str++ manifest : AgentSpec++ name : ResourceName++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[GetAgentResponse]+ The created agent.+ """+ _response = self._client_wrapper.httpx_client.request(+ "api/v1/agents",+ method="POST",+ json={+ "description": description,+ "manifest": convert_and_respect_annotation_metadata(+ object_=manifest, annotation=AgentSpec, direction="write"+ ),+ "name": name,+ },+ headers={+ "content-type": "application/json",+ },+ request_options=request_options,+ omit=OMIT,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ GetAgentResponse,+ construct_type(+ type_=GetAgentResponse, # 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(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 409:+ raise ConflictError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 422:+ raise UnprocessableEntityError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ def get(+ self, *, agent_id: str, request_options: typing.Optional[RequestOptions] = None+ ) -> HttpResponse[GetAgentResponse]:+ """+ Fetch a configured agent by immutable id.++ Parameters+ ----------+ agent_id : str+ Immutable agent identifier.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[GetAgentResponse]+ The agent.+ """+ _response = self._client_wrapper.httpx_client.request(+ f"api/v1/agents/{encode_path_param(agent_id)}",+ method="GET",+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ GetAgentResponse,+ construct_type(+ type_=GetAgentResponse, # type: ignore+ object_=_response.json(),+ ),+ )+ return HttpResponse(response=_response, data=_data)+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ def update(+ self,+ *,+ agent_id: str,+ manifest: AgentSpec,+ description: typing.Optional[str] = OMIT,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> HttpResponse[GetAgentResponse]:+ """+ Update an existing agent by immutable id.++ Parameters+ ----------+ agent_id : str+ Immutable agent identifier.++ manifest : AgentSpec++ description : typing.Optional[str]++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[GetAgentResponse]+ The saved agent.+ """+ _response = self._client_wrapper.httpx_client.request(+ f"api/v1/agents/{encode_path_param(agent_id)}",+ method="PUT",+ json={+ "description": description,+ "manifest": convert_and_respect_annotation_metadata(+ object_=manifest, annotation=AgentSpec, direction="write"+ ),+ },+ headers={+ "content-type": "application/json",+ },+ request_options=request_options,+ omit=OMIT,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ GetAgentResponse,+ construct_type(+ type_=GetAgentResponse, # 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(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 422:+ raise UnprocessableEntityError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ def delete(+ self, *, agent_id: str, request_options: typing.Optional[RequestOptions] = None+ ) -> HttpResponse[DeleteAgentResponse]:+ """+ Delete a configured agent by immutable id.++ Parameters+ ----------+ agent_id : str+ Immutable agent identifier.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[DeleteAgentResponse]+ Agent deleted.+ """+ _response = self._client_wrapper.httpx_client.request(+ f"api/v1/agents/{encode_path_param(agent_id)}",+ method="DELETE",+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ DeleteAgentResponse,+ construct_type(+ type_=DeleteAgentResponse, # type: ignore+ object_=_response.json(),+ ),+ )+ return HttpResponse(response=_response, data=_data)+ if _response.status_code == 401:+ raise UnauthorizedError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)+++class AsyncRawAgentsClient:+ def __init__(self, *, client_wrapper: AsyncClientWrapper):+ self._client_wrapper = client_wrapper++ async def list(+ self,+ *,+ limit: typing.Optional[int] = 50,+ page_token: typing.Optional[str] = None,+ agent_name: typing.Optional[str] = None,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> AsyncHttpResponse[ListAgentsResponse]:+ """+ List configured agents for the tenant, ordered by name. Optional `agent_name` filters by substring.++ Parameters+ ----------+ limit : typing.Optional[int]+ Page size. Defaults to 50, max 100.++ page_token : typing.Optional[str]+ Opaque token from a previous response `next_page_token`.++ agent_name : typing.Optional[str]+ Case-insensitive substring match on agent name.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ AsyncHttpResponse[ListAgentsResponse]+ Paginated matching agents.+ """+ _response = await self._client_wrapper.httpx_client.request(+ "api/v1/agents",+ method="GET",+ params={+ "limit": limit,+ "page_token": page_token,+ "agent_name": agent_name,+ },+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ ListAgentsResponse,+ construct_type(+ type_=ListAgentsResponse, # 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(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 401:+ raise UnauthorizedError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ async def create(+ self,+ *,+ description: str,+ manifest: AgentSpec,+ name: ResourceName,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> AsyncHttpResponse[GetAgentResponse]:+ """+ Creates an agent and allocates an immutable id. Fails if `name` is already taken. Name cannot be changed later.++ Parameters+ ----------+ description : str++ manifest : AgentSpec++ name : ResourceName++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ AsyncHttpResponse[GetAgentResponse]+ The created agent.+ """+ _response = await self._client_wrapper.httpx_client.request(+ "api/v1/agents",+ method="POST",+ json={+ "description": description,+ "manifest": convert_and_respect_annotation_metadata(+ object_=manifest, annotation=AgentSpec, direction="write"+ ),+ "name": name,+ },+ headers={+ "content-type": "application/json",+ },+ request_options=request_options,+ omit=OMIT,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ GetAgentResponse,+ construct_type(+ type_=GetAgentResponse, # 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(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 409:+ raise ConflictError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 422:+ raise UnprocessableEntityError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ async def get(+ self, *, agent_id: str, request_options: typing.Optional[RequestOptions] = None+ ) -> AsyncHttpResponse[GetAgentResponse]:+ """+ Fetch a configured agent by immutable id.++ Parameters+ ----------+ agent_id : str+ Immutable agent identifier.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ AsyncHttpResponse[GetAgentResponse]+ The agent.+ """+ _response = await self._client_wrapper.httpx_client.request(+ f"api/v1/agents/{encode_path_param(agent_id)}",+ method="GET",+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ GetAgentResponse,+ construct_type(+ type_=GetAgentResponse, # type: ignore+ object_=_response.json(),+ ),+ )+ return AsyncHttpResponse(response=_response, data=_data)+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ async def update(+ self,+ *,+ agent_id: str,+ manifest: AgentSpec,+ description: typing.Optional[str] = OMIT,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> AsyncHttpResponse[GetAgentResponse]:+ """+ Update an existing agent by immutable id.++ Parameters+ ----------+ agent_id : str+ Immutable agent identifier.++ manifest : AgentSpec++ description : typing.Optional[str]++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ AsyncHttpResponse[GetAgentResponse]+ The saved agent.+ """+ _response = await self._client_wrapper.httpx_client.request(+ f"api/v1/agents/{encode_path_param(agent_id)}",+ method="PUT",+ json={+ "description": description,+ "manifest": convert_and_respect_annotation_metadata(+ object_=manifest, annotation=AgentSpec, direction="write"+ ),+ },+ headers={+ "content-type": "application/json",+ },+ request_options=request_options,+ omit=OMIT,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ GetAgentResponse,+ construct_type(+ type_=GetAgentResponse, # 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(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 422:+ raise UnprocessableEntityError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ async def delete(+ self, *, agent_id: str, request_options: typing.Optional[RequestOptions] = None+ ) -> AsyncHttpResponse[DeleteAgentResponse]:+ """+ Delete a configured agent by immutable id.++ Parameters+ ----------+ agent_id : str+ Immutable agent identifier.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ AsyncHttpResponse[DeleteAgentResponse]+ Agent deleted.+ """+ _response = await self._client_wrapper.httpx_client.request(+ f"api/v1/agents/{encode_path_param(agent_id)}",+ method="DELETE",+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ DeleteAgentResponse,+ construct_type(+ type_=DeleteAgentResponse, # type: ignore+ object_=_response.json(),+ ),+ )+ return AsyncHttpResponse(response=_response, data=_data)+ if _response.status_code == 401:+ raise UnauthorizedError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)diff --git a/python/trueforge_sdk/src/trueforge_sdk/auth/__init__.py b/python/trueforge_sdk/src/trueforge_sdk/auth/__init__.pynew file mode 100644index 000000000..5cde0202d--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/auth/__init__.py@@ -0,0 +1,4 @@+# This file was auto-generated by Fern from our API Definition.++# isort: skip_file+diff --git a/python/trueforge_sdk/src/trueforge_sdk/auth/client.py b/python/trueforge_sdk/src/trueforge_sdk/auth/client.pynew file mode 100644index 000000000..3870a7524--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/auth/client.py@@ -0,0 +1,102 @@+# This file was auto-generated by Fern from our API Definition.++import typing++from ..core.client_wrapper import AsyncClientWrapper, SyncClientWrapper+from ..core.request_options import RequestOptions+from ..types.get_me_response import GetMeResponse+from .raw_client import AsyncRawAuthClient, RawAuthClient+++class AuthClient:+ def __init__(self, *, client_wrapper: SyncClientWrapper):+ self._raw_client = RawAuthClient(client_wrapper=client_wrapper)++ @property+ def with_raw_response(self) -> RawAuthClient:+ """+ Retrieves a raw implementation of this client that returns raw responses.++ Returns+ -------+ RawAuthClient+ """+ return self._raw_client++ def me(self, *, request_options: typing.Optional[RequestOptions] = None) -> GetMeResponse:+ """+ Returns the authenticated caller identity (`type`, `tenant_id`, `subject`, `roles`) wrapped as `{ data }`. `type` is `oidc-connected` when browser OIDC is enabled, otherwise `default`. When auth is enabled this requires a valid `id_token` cookie or `Authorization: Bearer` token (401 otherwise). When auth is disabled, returns the standalone default identity.++ Parameters+ ----------+ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ GetMeResponse+ Caller identity for the current request.++ Examples+ --------+ from trueforge_sdk import TrueForge++ client = TrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+ client.auth.me()+ """+ _response = self._raw_client.me(request_options=request_options)+ return _response.data+++class AsyncAuthClient:+ def __init__(self, *, client_wrapper: AsyncClientWrapper):+ self._raw_client = AsyncRawAuthClient(client_wrapper=client_wrapper)++ @property+ def with_raw_response(self) -> AsyncRawAuthClient:+ """+ Retrieves a raw implementation of this client that returns raw responses.++ Returns+ -------+ AsyncRawAuthClient+ """+ return self._raw_client++ async def me(self, *, request_options: typing.Optional[RequestOptions] = None) -> GetMeResponse:+ """+ Returns the authenticated caller identity (`type`, `tenant_id`, `subject`, `roles`) wrapped as `{ data }`. `type` is `oidc-connected` when browser OIDC is enabled, otherwise `default`. When auth is enabled this requires a valid `id_token` cookie or `Authorization: Bearer` token (401 otherwise). When auth is disabled, returns the standalone default identity.++ Parameters+ ----------+ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ GetMeResponse+ Caller identity for the current request.++ Examples+ --------+ import asyncio++ from trueforge_sdk import AsyncTrueForge++ client = AsyncTrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+++ async def main() -> None:+ await client.auth.me()+++ asyncio.run(main())+ """+ _response = await self._raw_client.me(request_options=request_options)+ return _response.datadiff --git a/python/trueforge_sdk/src/trueforge_sdk/auth/raw_client.py b/python/trueforge_sdk/src/trueforge_sdk/auth/raw_client.pynew file mode 100644index 000000000..48b252b19--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/auth/raw_client.py@@ -0,0 +1,123 @@+# 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.parse_error import ParsingError+from ..core.request_options import RequestOptions+from ..core.unchecked_base_model import construct_type+from ..errors.unauthorized_error import UnauthorizedError+from ..types.get_me_response import GetMeResponse+from ..types.request_error_response import RequestErrorResponse+from pydantic import ValidationError+++class RawAuthClient:+ def __init__(self, *, client_wrapper: SyncClientWrapper):+ self._client_wrapper = client_wrapper++ def me(self, *, request_options: typing.Optional[RequestOptions] = None) -> HttpResponse[GetMeResponse]:+ """+ Returns the authenticated caller identity (`type`, `tenant_id`, `subject`, `roles`) wrapped as `{ data }`. `type` is `oidc-connected` when browser OIDC is enabled, otherwise `default`. When auth is enabled this requires a valid `id_token` cookie or `Authorization: Bearer` token (401 otherwise). When auth is disabled, returns the standalone default identity.++ Parameters+ ----------+ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[GetMeResponse]+ Caller identity for the current request.+ """+ _response = self._client_wrapper.httpx_client.request(+ "api/v1/auth/me",+ method="GET",+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ GetMeResponse,+ construct_type(+ type_=GetMeResponse, # type: ignore+ object_=_response.json(),+ ),+ )+ return HttpResponse(response=_response, data=_data)+ if _response.status_code == 401:+ raise UnauthorizedError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)+++class AsyncRawAuthClient:+ def __init__(self, *, client_wrapper: AsyncClientWrapper):+ self._client_wrapper = client_wrapper++ async def me(self, *, request_options: typing.Optional[RequestOptions] = None) -> AsyncHttpResponse[GetMeResponse]:+ """+ Returns the authenticated caller identity (`type`, `tenant_id`, `subject`, `roles`) wrapped as `{ data }`. `type` is `oidc-connected` when browser OIDC is enabled, otherwise `default`. When auth is enabled this requires a valid `id_token` cookie or `Authorization: Bearer` token (401 otherwise). When auth is disabled, returns the standalone default identity.++ Parameters+ ----------+ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ AsyncHttpResponse[GetMeResponse]+ Caller identity for the current request.+ """+ _response = await self._client_wrapper.httpx_client.request(+ "api/v1/auth/me",+ method="GET",+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ GetMeResponse,+ construct_type(+ type_=GetMeResponse, # type: ignore+ object_=_response.json(),+ ),+ )+ return AsyncHttpResponse(response=_response, data=_data)+ if _response.status_code == 401:+ raise UnauthorizedError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)diff --git a/python/trueforge_sdk/src/trueforge_sdk/base_client.py b/python/trueforge_sdk/src/trueforge_sdk/base_client.pynew file mode 100644index 000000000..e086197b1--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/base_client.py@@ -0,0 +1,395 @@+# This file was auto-generated by Fern from our API Definition.++from __future__ import annotations++import typing++import httpx+from .core.client_wrapper import AsyncClientWrapper, SyncClientWrapper+from .core.logging import LogConfig, Logger++if typing.TYPE_CHECKING:+ from .agents.client import AgentsClient, AsyncAgentsClient+ from .auth.client import AsyncAuthClient, AuthClient+ from .catalogs.client import AsyncCatalogsClient, CatalogsClient+ from .internal.client import AsyncInternalClient, InternalClient+ from .mcp_servers.client import AsyncMcpServersClient, McpServersClient+ from .models.client import AsyncModelsClient, ModelsClient+ from .schedules.client import AsyncSchedulesClient, SchedulesClient+ from .server.client import AsyncServerClient, ServerClient+ from .sessions.client import AsyncSessionsClient, SessionsClient+ from .settings.client import AsyncSettingsClient, SettingsClient+ from .skills.client import AsyncSkillsClient, SkillsClient+++class BaseTrueForge:+ """+ Use this class to access the different functions within the SDK. You can instantiate any number of clients with different configuration that will propagate to these functions.++ Parameters+ ----------+ base_url : str+ The base url to use for requests from the client.++ token : typing.Optional[typing.Union[str, typing.Callable[[], str]]]+ headers : typing.Optional[typing.Dict[str, str]]+ Additional headers to send with every request.++ timeout : typing.Optional[float]+ The timeout to be used, in seconds, for requests. By default the timeout is 60 seconds, unless a custom httpx client is used, in which case this default is not enforced.++ max_retries : typing.Optional[int]+ The default maximum number of retries for failed requests. Defaults to 2. Per-request `max_retries` in `request_options` takes precedence over this value.++ stream_reconnection_enabled : typing.Optional[bool]+ Whether to automatically reconnect on stream disconnection for resumable streaming endpoints. Defaults to True. Per-request `stream_reconnection_enabled` in `request_options` takes precedence over this value.++ max_stream_reconnection_attempts : typing.Optional[int]+ The maximum number of reconnection attempts for resumable streaming endpoints. Defaults to no limit. Per-request `max_stream_reconnection_attempts` in `request_options` takes precedence over this value.++ follow_redirects : typing.Optional[bool]+ Whether the default httpx client follows redirects or not, this is irrelevant if a custom httpx client is passed in.++ httpx_client : typing.Optional[httpx.Client]+ The httpx client to use for making requests, a preconfigured client is used by default, however this is useful should you want to pass in any custom httpx configuration.++ logging : typing.Optional[typing.Union[LogConfig, Logger]]+ Configure logging for the SDK. Accepts a LogConfig dict with 'level' (debug/info/warn/error), 'logger' (custom logger implementation), and 'silent' (boolean, defaults to True) fields. You can also pass a pre-configured Logger instance.++ Examples+ --------+ from trueforge_sdk import TrueForge++ client = TrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+ """++ def __init__(+ self,+ *,+ base_url: str,+ token: typing.Optional[typing.Union[str, typing.Callable[[], str]]] = None,+ headers: typing.Optional[typing.Dict[str, str]] = None,+ timeout: typing.Optional[float] = None,+ max_retries: typing.Optional[int] = None,+ stream_reconnection_enabled: typing.Optional[bool] = None,+ max_stream_reconnection_attempts: typing.Optional[int] = None,+ follow_redirects: typing.Optional[bool] = True,+ httpx_client: typing.Optional[httpx.Client] = None,+ logging: typing.Optional[typing.Union[LogConfig, Logger]] = None,+ ):+ _defaulted_timeout = timeout if timeout is not None else 60 if httpx_client is None else None+ _defaulted_max_retries = max_retries if max_retries is not None else 2+ self._client_wrapper = SyncClientWrapper(+ base_url=base_url,+ token=token,+ headers=headers,+ httpx_client=httpx_client+ if httpx_client is not None+ else httpx.Client(timeout=_defaulted_timeout, follow_redirects=follow_redirects)+ if follow_redirects is not None+ else httpx.Client(timeout=_defaulted_timeout),+ timeout=_defaulted_timeout,+ max_retries=_defaulted_max_retries,+ stream_reconnection_enabled=stream_reconnection_enabled,+ max_stream_reconnection_attempts=max_stream_reconnection_attempts,+ logging=logging,+ )+ self._internal: typing.Optional[InternalClient] = None+ self._agents: typing.Optional[AgentsClient] = None+ self._auth: typing.Optional[AuthClient] = None+ self._server: typing.Optional[ServerClient] = None+ self._mcp_servers: typing.Optional[McpServersClient] = None+ self._models: typing.Optional[ModelsClient] = None+ self._schedules: typing.Optional[SchedulesClient] = None+ self._sessions: typing.Optional[SessionsClient] = None+ self._skills: typing.Optional[SkillsClient] = None+ self._catalogs: typing.Optional[CatalogsClient] = None+ self._settings: typing.Optional[SettingsClient] = None++ @property+ def internal(self):+ if self._internal is None:+ from .internal.client import InternalClient # noqa: E402++ self._internal = InternalClient(client_wrapper=self._client_wrapper)+ return self._internal++ @property+ def agents(self):+ if self._agents is None:+ from .agents.client import AgentsClient # noqa: E402++ self._agents = AgentsClient(client_wrapper=self._client_wrapper)+ return self._agents++ @property+ def auth(self):+ if self._auth is None:+ from .auth.client import AuthClient # noqa: E402++ self._auth = AuthClient(client_wrapper=self._client_wrapper)+ return self._auth++ @property+ def server(self):+ if self._server is None:+ from .server.client import ServerClient # noqa: E402++ self._server = ServerClient(client_wrapper=self._client_wrapper)+ return self._server++ @property+ def mcp_servers(self):+ if self._mcp_servers is None:+ from .mcp_servers.client import McpServersClient # noqa: E402++ self._mcp_servers = McpServersClient(client_wrapper=self._client_wrapper)+ return self._mcp_servers++ @property+ def models(self):+ if self._models is None:+ from .models.client import ModelsClient # noqa: E402++ self._models = ModelsClient(client_wrapper=self._client_wrapper)+ return self._models++ @property+ def schedules(self):+ if self._schedules is None:+ from .schedules.client import SchedulesClient # noqa: E402++ self._schedules = SchedulesClient(client_wrapper=self._client_wrapper)+ return self._schedules++ @property+ def sessions(self):+ if self._sessions is None:+ from .sessions.client import SessionsClient # noqa: E402++ self._sessions = SessionsClient(client_wrapper=self._client_wrapper)+ return self._sessions++ @property+ def skills(self):+ if self._skills is None:+ from .skills.client import SkillsClient # noqa: E402++ self._skills = SkillsClient(client_wrapper=self._client_wrapper)+ return self._skills++ @property+ def catalogs(self):+ if self._catalogs is None:+ from .catalogs.client import CatalogsClient # noqa: E402++ self._catalogs = CatalogsClient(client_wrapper=self._client_wrapper)+ return self._catalogs++ @property+ def settings(self):+ if self._settings is None:+ from .settings.client import SettingsClient # noqa: E402++ self._settings = SettingsClient(client_wrapper=self._client_wrapper)+ return self._settings+++def _make_default_async_client(+ timeout: typing.Optional[float],+ follow_redirects: typing.Optional[bool],+) -> httpx.AsyncClient:+ try:+ import httpx_aiohttp # type: ignore[import-not-found]+ except ImportError:+ pass+ else:+ if follow_redirects is not None:+ return httpx_aiohttp.HttpxAiohttpClient(timeout=timeout, follow_redirects=follow_redirects)+ return httpx_aiohttp.HttpxAiohttpClient(timeout=timeout)++ if follow_redirects is not None:+ return httpx.AsyncClient(timeout=timeout, follow_redirects=follow_redirects)+ return httpx.AsyncClient(timeout=timeout)+++class AsyncBaseTrueForge:+ """+ Use this class to access the different functions within the SDK. You can instantiate any number of clients with different configuration that will propagate to these functions.++ Parameters+ ----------+ base_url : str+ The base url to use for requests from the client.++ token : typing.Optional[typing.Union[str, typing.Callable[[], str]]]+ headers : typing.Optional[typing.Dict[str, str]]+ Additional headers to send with every request.++ async_token : typing.Optional[typing.Callable[[], typing.Awaitable[str]]]+ An async callable that returns a bearer token. Use this when token acquisition involves async I/O (e.g., refreshing tokens via an async HTTP client). When provided, this is used instead of the synchronous token for async requests.++ timeout : typing.Optional[float]+ The timeout to be used, in seconds, for requests. By default the timeout is 60 seconds, unless a custom httpx client is used, in which case this default is not enforced.++ max_retries : typing.Optional[int]+ The default maximum number of retries for failed requests. Defaults to 2. Per-request `max_retries` in `request_options` takes precedence over this value.++ stream_reconnection_enabled : typing.Optional[bool]+ Whether to automatically reconnect on stream disconnection for resumable streaming endpoints. Defaults to True. Per-request `stream_reconnection_enabled` in `request_options` takes precedence over this value.++ max_stream_reconnection_attempts : typing.Optional[int]+ The maximum number of reconnection attempts for resumable streaming endpoints. Defaults to no limit. Per-request `max_stream_reconnection_attempts` in `request_options` takes precedence over this value.++ follow_redirects : typing.Optional[bool]+ Whether the default httpx client follows redirects or not, this is irrelevant if a custom httpx client is passed in.++ httpx_client : typing.Optional[httpx.AsyncClient]+ The httpx client to use for making requests, a preconfigured client is used by default, however this is useful should you want to pass in any custom httpx configuration.++ logging : typing.Optional[typing.Union[LogConfig, Logger]]+ Configure logging for the SDK. Accepts a LogConfig dict with 'level' (debug/info/warn/error), 'logger' (custom logger implementation), and 'silent' (boolean, defaults to True) fields. You can also pass a pre-configured Logger instance.++ Examples+ --------+ from trueforge_sdk import AsyncTrueForge++ client = AsyncTrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+ """++ def __init__(+ self,+ *,+ base_url: str,+ token: typing.Optional[typing.Union[str, typing.Callable[[], str]]] = None,+ headers: typing.Optional[typing.Dict[str, str]] = None,+ async_token: typing.Optional[typing.Callable[[], typing.Awaitable[str]]] = None,+ timeout: typing.Optional[float] = None,+ max_retries: typing.Optional[int] = None,+ stream_reconnection_enabled: typing.Optional[bool] = None,+ max_stream_reconnection_attempts: typing.Optional[int] = None,+ follow_redirects: typing.Optional[bool] = True,+ httpx_client: typing.Optional[httpx.AsyncClient] = None,+ logging: typing.Optional[typing.Union[LogConfig, Logger]] = None,+ ):+ _defaulted_timeout = timeout if timeout is not None else 60 if httpx_client is None else None+ _defaulted_max_retries = max_retries if max_retries is not None else 2+ self._client_wrapper = AsyncClientWrapper(+ base_url=base_url,+ token=token,+ headers=headers,+ async_token=async_token,+ httpx_client=httpx_client+ if httpx_client is not None+ else _make_default_async_client(timeout=_defaulted_timeout, follow_redirects=follow_redirects),+ timeout=_defaulted_timeout,+ max_retries=_defaulted_max_retries,+ stream_reconnection_enabled=stream_reconnection_enabled,+ max_stream_reconnection_attempts=max_stream_reconnection_attempts,+ logging=logging,+ )+ self._internal: typing.Optional[AsyncInternalClient] = None+ self._agents: typing.Optional[AsyncAgentsClient] = None+ self._auth: typing.Optional[AsyncAuthClient] = None+ self._server: typing.Optional[AsyncServerClient] = None+ self._mcp_servers: typing.Optional[AsyncMcpServersClient] = None+ self._models: typing.Optional[AsyncModelsClient] = None+ self._schedules: typing.Optional[AsyncSchedulesClient] = None+ self._sessions: typing.Optional[AsyncSessionsClient] = None+ self._skills: typing.Optional[AsyncSkillsClient] = None+ self._catalogs: typing.Optional[AsyncCatalogsClient] = None+ self._settings: typing.Optional[AsyncSettingsClient] = None++ @property+ def internal(self):+ if self._internal is None:+ from .internal.client import AsyncInternalClient # noqa: E402++ self._internal = AsyncInternalClient(client_wrapper=self._client_wrapper)+ return self._internal++ @property+ def agents(self):+ if self._agents is None:+ from .agents.client import AsyncAgentsClient # noqa: E402++ self._agents = AsyncAgentsClient(client_wrapper=self._client_wrapper)+ return self._agents++ @property+ def auth(self):+ if self._auth is None:+ from .auth.client import AsyncAuthClient # noqa: E402++ self._auth = AsyncAuthClient(client_wrapper=self._client_wrapper)+ return self._auth++ @property+ def server(self):+ if self._server is None:+ from .server.client import AsyncServerClient # noqa: E402++ self._server = AsyncServerClient(client_wrapper=self._client_wrapper)+ return self._server++ @property+ def mcp_servers(self):+ if self._mcp_servers is None:+ from .mcp_servers.client import AsyncMcpServersClient # noqa: E402++ self._mcp_servers = AsyncMcpServersClient(client_wrapper=self._client_wrapper)+ return self._mcp_servers++ @property+ def models(self):+ if self._models is None:+ from .models.client import AsyncModelsClient # noqa: E402++ self._models = AsyncModelsClient(client_wrapper=self._client_wrapper)+ return self._models++ @property+ def schedules(self):+ if self._schedules is None:+ from .schedules.client import AsyncSchedulesClient # noqa: E402++ self._schedules = AsyncSchedulesClient(client_wrapper=self._client_wrapper)+ return self._schedules++ @property+ def sessions(self):+ if self._sessions is None:+ from .sessions.client import AsyncSessionsClient # noqa: E402++ self._sessions = AsyncSessionsClient(client_wrapper=self._client_wrapper)+ return self._sessions++ @property+ def skills(self):+ if self._skills is None:+ from .skills.client import AsyncSkillsClient # noqa: E402++ self._skills = AsyncSkillsClient(client_wrapper=self._client_wrapper)+ return self._skills++ @property+ def catalogs(self):+ if self._catalogs is None:+ from .catalogs.client import AsyncCatalogsClient # noqa: E402++ self._catalogs = AsyncCatalogsClient(client_wrapper=self._client_wrapper)+ return self._catalogs++ @property+ def settings(self):+ if self._settings is None:+ from .settings.client import AsyncSettingsClient # noqa: E402++ self._settings = AsyncSettingsClient(client_wrapper=self._client_wrapper)+ return self._settingsdiff --git a/python/trueforge_sdk/src/trueforge_sdk/catalogs/__init__.py b/python/trueforge_sdk/src/trueforge_sdk/catalogs/__init__.pynew file mode 100644index 000000000..c8555edfe--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/catalogs/__init__.py@@ -0,0 +1,39 @@+# This file was auto-generated by Fern from our API Definition.++# isort: skip_file++import typing+from importlib import import_module++if typing.TYPE_CHECKING:+ from . import mcp_servers, model_providers, sandbox_providers, skills+_dynamic_imports: typing.Dict[str, str] = {+ "mcp_servers": ".mcp_servers",+ "model_providers": ".model_providers",+ "sandbox_providers": ".sandbox_providers",+ "skills": ".skills",+}+++def __getattr__(attr_name: str) -> typing.Any:+ module_name = _dynamic_imports.get(attr_name)+ if module_name is None:+ raise AttributeError(f"No {attr_name} found in _dynamic_imports for module name -> {__name__}")+ try:+ module = import_module(module_name, __package__)+ if module_name == f".{attr_name}":+ return module+ else:+ return getattr(module, attr_name)+ except ImportError as e:+ raise ImportError(f"Failed to import {attr_name} from {module_name}: {e}") from e+ except AttributeError as e:+ raise AttributeError(f"Failed to get {attr_name} from {module_name}: {e}") from e+++def __dir__():+ lazy_attrs = list(_dynamic_imports.keys())+ return sorted(lazy_attrs)+++__all__ = ["mcp_servers", "model_providers", "sandbox_providers", "skills"]diff --git a/python/trueforge_sdk/src/trueforge_sdk/catalogs/client.py b/python/trueforge_sdk/src/trueforge_sdk/catalogs/client.pynew file mode 100644index 000000000..d74c24af1--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/catalogs/client.py@@ -0,0 +1,120 @@+# This file was auto-generated by Fern from our API Definition.++from __future__ import annotations++import typing++from ..core.client_wrapper import AsyncClientWrapper, SyncClientWrapper+from .raw_client import AsyncRawCatalogsClient, RawCatalogsClient++if typing.TYPE_CHECKING:+ from .mcp_servers.client import AsyncMcpServersClient, McpServersClient+ from .model_providers.client import AsyncModelProvidersClient, ModelProvidersClient+ from .sandbox_providers.client import AsyncSandboxProvidersClient, SandboxProvidersClient+ from .skills.client import AsyncSkillsClient, SkillsClient+++class CatalogsClient:+ def __init__(self, *, client_wrapper: SyncClientWrapper):+ self._raw_client = RawCatalogsClient(client_wrapper=client_wrapper)+ self._client_wrapper = client_wrapper+ self._mcp_servers: typing.Optional[McpServersClient] = None+ self._model_providers: typing.Optional[ModelProvidersClient] = None+ self._sandbox_providers: typing.Optional[SandboxProvidersClient] = None+ self._skills: typing.Optional[SkillsClient] = None++ @property+ def with_raw_response(self) -> RawCatalogsClient:+ """+ Retrieves a raw implementation of this client that returns raw responses.++ Returns+ -------+ RawCatalogsClient+ """+ return self._raw_client++ @property+ def mcp_servers(self):+ if self._mcp_servers is None:+ from .mcp_servers.client import McpServersClient # noqa: E402++ self._mcp_servers = McpServersClient(client_wrapper=self._client_wrapper)+ return self._mcp_servers++ @property+ def model_providers(self):+ if self._model_providers is None:+ from .model_providers.client import ModelProvidersClient # noqa: E402++ self._model_providers = ModelProvidersClient(client_wrapper=self._client_wrapper)+ return self._model_providers++ @property+ def sandbox_providers(self):+ if self._sandbox_providers is None:+ from .sandbox_providers.client import SandboxProvidersClient # noqa: E402++ self._sandbox_providers = SandboxProvidersClient(client_wrapper=self._client_wrapper)+ return self._sandbox_providers++ @property+ def skills(self):+ if self._skills is None:+ from .skills.client import SkillsClient # noqa: E402++ self._skills = SkillsClient(client_wrapper=self._client_wrapper)+ return self._skills+++class AsyncCatalogsClient:+ def __init__(self, *, client_wrapper: AsyncClientWrapper):+ self._raw_client = AsyncRawCatalogsClient(client_wrapper=client_wrapper)+ self._client_wrapper = client_wrapper+ self._mcp_servers: typing.Optional[AsyncMcpServersClient] = None+ self._model_providers: typing.Optional[AsyncModelProvidersClient] = None+ self._sandbox_providers: typing.Optional[AsyncSandboxProvidersClient] = None+ self._skills: typing.Optional[AsyncSkillsClient] = None++ @property+ def with_raw_response(self) -> AsyncRawCatalogsClient:+ """+ Retrieves a raw implementation of this client that returns raw responses.++ Returns+ -------+ AsyncRawCatalogsClient+ """+ return self._raw_client++ @property+ def mcp_servers(self):+ if self._mcp_servers is None:+ from .mcp_servers.client import AsyncMcpServersClient # noqa: E402++ self._mcp_servers = AsyncMcpServersClient(client_wrapper=self._client_wrapper)+ return self._mcp_servers++ @property+ def model_providers(self):+ if self._model_providers is None:+ from .model_providers.client import AsyncModelProvidersClient # noqa: E402++ self._model_providers = AsyncModelProvidersClient(client_wrapper=self._client_wrapper)+ return self._model_providers++ @property+ def sandbox_providers(self):+ if self._sandbox_providers is None:+ from .sandbox_providers.client import AsyncSandboxProvidersClient # noqa: E402++ self._sandbox_providers = AsyncSandboxProvidersClient(client_wrapper=self._client_wrapper)+ return self._sandbox_providers++ @property+ def skills(self):+ if self._skills is None:+ from .skills.client import AsyncSkillsClient # noqa: E402++ self._skills = AsyncSkillsClient(client_wrapper=self._client_wrapper)+ return self._skillsdiff --git a/python/trueforge_sdk/src/trueforge_sdk/catalogs/mcp_servers/__init__.py b/python/trueforge_sdk/src/trueforge_sdk/catalogs/mcp_servers/__init__.pynew file mode 100644index 000000000..5cde0202d--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/catalogs/mcp_servers/__init__.py@@ -0,0 +1,4 @@+# This file was auto-generated by Fern from our API Definition.++# isort: skip_file+diff --git a/python/trueforge_sdk/src/trueforge_sdk/catalogs/mcp_servers/client.py b/python/trueforge_sdk/src/trueforge_sdk/catalogs/mcp_servers/client.pynew file mode 100644index 000000000..acbafc222--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/catalogs/mcp_servers/client.py@@ -0,0 +1,102 @@+# This file was auto-generated by Fern from our API Definition.++import typing++from ...core.client_wrapper import AsyncClientWrapper, SyncClientWrapper+from ...core.request_options import RequestOptions+from ...types.get_mcp_server_catalog_response import GetMcpServerCatalogResponse+from .raw_client import AsyncRawMcpServersClient, RawMcpServersClient+++class McpServersClient:+ def __init__(self, *, client_wrapper: SyncClientWrapper):+ self._raw_client = RawMcpServersClient(client_wrapper=client_wrapper)++ @property+ def with_raw_response(self) -> RawMcpServersClient:+ """+ Retrieves a raw implementation of this client that returns raw responses.++ Returns+ -------+ RawMcpServersClient+ """+ return self._raw_client++ def list(self, *, request_options: typing.Optional[RequestOptions] = None) -> GetMcpServerCatalogResponse:+ """+ Shipped MCP server presets (discovery-only). Copy into PUT /settings/mcp-servers to configure.++ Parameters+ ----------+ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ GetMcpServerCatalogResponse+ Shipped MCP server presets.++ Examples+ --------+ from trueforge_sdk import TrueForge++ client = TrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+ client.catalogs.mcp_servers.list()+ """+ _response = self._raw_client.list(request_options=request_options)+ return _response.data+++class AsyncMcpServersClient:+ def __init__(self, *, client_wrapper: AsyncClientWrapper):+ self._raw_client = AsyncRawMcpServersClient(client_wrapper=client_wrapper)++ @property+ def with_raw_response(self) -> AsyncRawMcpServersClient:+ """+ Retrieves a raw implementation of this client that returns raw responses.++ Returns+ -------+ AsyncRawMcpServersClient+ """+ return self._raw_client++ async def list(self, *, request_options: typing.Optional[RequestOptions] = None) -> GetMcpServerCatalogResponse:+ """+ Shipped MCP server presets (discovery-only). Copy into PUT /settings/mcp-servers to configure.++ Parameters+ ----------+ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ GetMcpServerCatalogResponse+ Shipped MCP server presets.++ Examples+ --------+ import asyncio++ from trueforge_sdk import AsyncTrueForge++ client = AsyncTrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+++ async def main() -> None:+ await client.catalogs.mcp_servers.list()+++ asyncio.run(main())+ """+ _response = await self._raw_client.list(request_options=request_options)+ return _response.datadiff --git a/python/trueforge_sdk/src/trueforge_sdk/catalogs/mcp_servers/raw_client.py b/python/trueforge_sdk/src/trueforge_sdk/catalogs/mcp_servers/raw_client.pynew file mode 100644index 000000000..4a12f2ee9--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/catalogs/mcp_servers/raw_client.py@@ -0,0 +1,127 @@+# 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.parse_error import ParsingError+from ...core.request_options import RequestOptions+from ...core.unchecked_base_model import construct_type+from ...errors.unauthorized_error import UnauthorizedError+from ...types.get_mcp_server_catalog_response import GetMcpServerCatalogResponse+from ...types.request_error_response import RequestErrorResponse+from pydantic import ValidationError+++class RawMcpServersClient:+ def __init__(self, *, client_wrapper: SyncClientWrapper):+ self._client_wrapper = client_wrapper++ def list(+ self, *, request_options: typing.Optional[RequestOptions] = None+ ) -> HttpResponse[GetMcpServerCatalogResponse]:+ """+ Shipped MCP server presets (discovery-only). Copy into PUT /settings/mcp-servers to configure.++ Parameters+ ----------+ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[GetMcpServerCatalogResponse]+ Shipped MCP server presets.+ """+ _response = self._client_wrapper.httpx_client.request(+ "api/v1/catalogs/mcp-servers",+ method="GET",+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ GetMcpServerCatalogResponse,+ construct_type(+ type_=GetMcpServerCatalogResponse, # type: ignore+ object_=_response.json(),+ ),+ )+ return HttpResponse(response=_response, data=_data)+ if _response.status_code == 401:+ raise UnauthorizedError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)+++class AsyncRawMcpServersClient:+ def __init__(self, *, client_wrapper: AsyncClientWrapper):+ self._client_wrapper = client_wrapper++ async def list(+ self, *, request_options: typing.Optional[RequestOptions] = None+ ) -> AsyncHttpResponse[GetMcpServerCatalogResponse]:+ """+ Shipped MCP server presets (discovery-only). Copy into PUT /settings/mcp-servers to configure.++ Parameters+ ----------+ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ AsyncHttpResponse[GetMcpServerCatalogResponse]+ Shipped MCP server presets.+ """+ _response = await self._client_wrapper.httpx_client.request(+ "api/v1/catalogs/mcp-servers",+ method="GET",+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ GetMcpServerCatalogResponse,+ construct_type(+ type_=GetMcpServerCatalogResponse, # type: ignore+ object_=_response.json(),+ ),+ )+ return AsyncHttpResponse(response=_response, data=_data)+ if _response.status_code == 401:+ raise UnauthorizedError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)diff --git a/python/trueforge_sdk/src/trueforge_sdk/catalogs/model_providers/__init__.py b/python/trueforge_sdk/src/trueforge_sdk/catalogs/model_providers/__init__.pynew file mode 100644index 000000000..5cde0202d--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/catalogs/model_providers/__init__.py@@ -0,0 +1,4 @@+# This file was auto-generated by Fern from our API Definition.++# isort: skip_file+diff --git a/python/trueforge_sdk/src/trueforge_sdk/catalogs/model_providers/client.py b/python/trueforge_sdk/src/trueforge_sdk/catalogs/model_providers/client.pynew file mode 100644index 000000000..73e93243f--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/catalogs/model_providers/client.py@@ -0,0 +1,102 @@+# This file was auto-generated by Fern from our API Definition.++import typing++from ...core.client_wrapper import AsyncClientWrapper, SyncClientWrapper+from ...core.request_options import RequestOptions+from ...types.get_model_provider_catalog_response import GetModelProviderCatalogResponse+from .raw_client import AsyncRawModelProvidersClient, RawModelProvidersClient+++class ModelProvidersClient:+ def __init__(self, *, client_wrapper: SyncClientWrapper):+ self._raw_client = RawModelProvidersClient(client_wrapper=client_wrapper)++ @property+ def with_raw_response(self) -> RawModelProvidersClient:+ """+ Retrieves a raw implementation of this client that returns raw responses.++ Returns+ -------+ RawModelProvidersClient+ """+ return self._raw_client++ def list(self, *, request_options: typing.Optional[RequestOptions] = None) -> GetModelProviderCatalogResponse:+ """+ Shipped model-provider presets (discovery-only). Copy into PUT /settings/model-providers to configure. Includes a `custom` sentinel with `supported_reasoning_efforts`.++ Parameters+ ----------+ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ GetModelProviderCatalogResponse+ Shipped model-provider presets.++ Examples+ --------+ from trueforge_sdk import TrueForge++ client = TrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+ client.catalogs.model_providers.list()+ """+ _response = self._raw_client.list(request_options=request_options)+ return _response.data+++class AsyncModelProvidersClient:+ def __init__(self, *, client_wrapper: AsyncClientWrapper):+ self._raw_client = AsyncRawModelProvidersClient(client_wrapper=client_wrapper)++ @property+ def with_raw_response(self) -> AsyncRawModelProvidersClient:+ """+ Retrieves a raw implementation of this client that returns raw responses.++ Returns+ -------+ AsyncRawModelProvidersClient+ """+ return self._raw_client++ async def list(self, *, request_options: typing.Optional[RequestOptions] = None) -> GetModelProviderCatalogResponse:+ """+ Shipped model-provider presets (discovery-only). Copy into PUT /settings/model-providers to configure. Includes a `custom` sentinel with `supported_reasoning_efforts`.++ Parameters+ ----------+ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ GetModelProviderCatalogResponse+ Shipped model-provider presets.++ Examples+ --------+ import asyncio++ from trueforge_sdk import AsyncTrueForge++ client = AsyncTrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+++ async def main() -> None:+ await client.catalogs.model_providers.list()+++ asyncio.run(main())+ """+ _response = await self._raw_client.list(request_options=request_options)+ return _response.datadiff --git a/python/trueforge_sdk/src/trueforge_sdk/catalogs/model_providers/raw_client.py b/python/trueforge_sdk/src/trueforge_sdk/catalogs/model_providers/raw_client.pynew file mode 100644index 000000000..c619ffb34--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/catalogs/model_providers/raw_client.py@@ -0,0 +1,127 @@+# 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.parse_error import ParsingError+from ...core.request_options import RequestOptions+from ...core.unchecked_base_model import construct_type+from ...errors.unauthorized_error import UnauthorizedError+from ...types.get_model_provider_catalog_response import GetModelProviderCatalogResponse+from ...types.request_error_response import RequestErrorResponse+from pydantic import ValidationError+++class RawModelProvidersClient:+ def __init__(self, *, client_wrapper: SyncClientWrapper):+ self._client_wrapper = client_wrapper++ def list(+ self, *, request_options: typing.Optional[RequestOptions] = None+ ) -> HttpResponse[GetModelProviderCatalogResponse]:+ """+ Shipped model-provider presets (discovery-only). Copy into PUT /settings/model-providers to configure. Includes a `custom` sentinel with `supported_reasoning_efforts`.++ Parameters+ ----------+ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[GetModelProviderCatalogResponse]+ Shipped model-provider presets.+ """+ _response = self._client_wrapper.httpx_client.request(+ "api/v1/catalogs/model-providers",+ method="GET",+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ GetModelProviderCatalogResponse,+ construct_type(+ type_=GetModelProviderCatalogResponse, # type: ignore+ object_=_response.json(),+ ),+ )+ return HttpResponse(response=_response, data=_data)+ if _response.status_code == 401:+ raise UnauthorizedError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)+++class AsyncRawModelProvidersClient:+ def __init__(self, *, client_wrapper: AsyncClientWrapper):+ self._client_wrapper = client_wrapper++ async def list(+ self, *, request_options: typing.Optional[RequestOptions] = None+ ) -> AsyncHttpResponse[GetModelProviderCatalogResponse]:+ """+ Shipped model-provider presets (discovery-only). Copy into PUT /settings/model-providers to configure. Includes a `custom` sentinel with `supported_reasoning_efforts`.++ Parameters+ ----------+ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ AsyncHttpResponse[GetModelProviderCatalogResponse]+ Shipped model-provider presets.+ """+ _response = await self._client_wrapper.httpx_client.request(+ "api/v1/catalogs/model-providers",+ method="GET",+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ GetModelProviderCatalogResponse,+ construct_type(+ type_=GetModelProviderCatalogResponse, # type: ignore+ object_=_response.json(),+ ),+ )+ return AsyncHttpResponse(response=_response, data=_data)+ if _response.status_code == 401:+ raise UnauthorizedError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)diff --git a/python/trueforge_sdk/src/trueforge_sdk/catalogs/raw_client.py b/python/trueforge_sdk/src/trueforge_sdk/catalogs/raw_client.pynew file mode 100644index 000000000..e98c39839--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/catalogs/raw_client.py@@ -0,0 +1,13 @@+# This file was auto-generated by Fern from our API Definition.++from ..core.client_wrapper import AsyncClientWrapper, SyncClientWrapper+++class RawCatalogsClient:+ def __init__(self, *, client_wrapper: SyncClientWrapper):+ self._client_wrapper = client_wrapper+++class AsyncRawCatalogsClient:+ def __init__(self, *, client_wrapper: AsyncClientWrapper):+ self._client_wrapper = client_wrapperdiff --git a/python/trueforge_sdk/src/trueforge_sdk/catalogs/sandbox_providers/__init__.py b/python/trueforge_sdk/src/trueforge_sdk/catalogs/sandbox_providers/__init__.pynew file mode 100644index 000000000..5cde0202d--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/catalogs/sandbox_providers/__init__.py@@ -0,0 +1,4 @@+# This file was auto-generated by Fern from our API Definition.++# isort: skip_file+diff --git a/python/trueforge_sdk/src/trueforge_sdk/catalogs/sandbox_providers/client.py b/python/trueforge_sdk/src/trueforge_sdk/catalogs/sandbox_providers/client.pynew file mode 100644index 000000000..b6e70ee64--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/catalogs/sandbox_providers/client.py@@ -0,0 +1,104 @@+# This file was auto-generated by Fern from our API Definition.++import typing++from ...core.client_wrapper import AsyncClientWrapper, SyncClientWrapper+from ...core.request_options import RequestOptions+from ...types.get_sandbox_provider_catalog_response import GetSandboxProviderCatalogResponse+from .raw_client import AsyncRawSandboxProvidersClient, RawSandboxProvidersClient+++class SandboxProvidersClient:+ def __init__(self, *, client_wrapper: SyncClientWrapper):+ self._raw_client = RawSandboxProvidersClient(client_wrapper=client_wrapper)++ @property+ def with_raw_response(self) -> RawSandboxProvidersClient:+ """+ Retrieves a raw implementation of this client that returns raw responses.++ Returns+ -------+ RawSandboxProvidersClient+ """+ return self._raw_client++ def list(self, *, request_options: typing.Optional[RequestOptions] = None) -> GetSandboxProviderCatalogResponse:+ """+ Shipped sandbox-provider presets (discovery-only). Copy into PUT /settings/sandbox-providers to configure.++ Parameters+ ----------+ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ GetSandboxProviderCatalogResponse+ Shipped sandbox-provider presets.++ Examples+ --------+ from trueforge_sdk import TrueForge++ client = TrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+ client.catalogs.sandbox_providers.list()+ """+ _response = self._raw_client.list(request_options=request_options)+ return _response.data+++class AsyncSandboxProvidersClient:+ def __init__(self, *, client_wrapper: AsyncClientWrapper):+ self._raw_client = AsyncRawSandboxProvidersClient(client_wrapper=client_wrapper)++ @property+ def with_raw_response(self) -> AsyncRawSandboxProvidersClient:+ """+ Retrieves a raw implementation of this client that returns raw responses.++ Returns+ -------+ AsyncRawSandboxProvidersClient+ """+ return self._raw_client++ async def list(+ self, *, request_options: typing.Optional[RequestOptions] = None+ ) -> GetSandboxProviderCatalogResponse:+ """+ Shipped sandbox-provider presets (discovery-only). Copy into PUT /settings/sandbox-providers to configure.++ Parameters+ ----------+ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ GetSandboxProviderCatalogResponse+ Shipped sandbox-provider presets.++ Examples+ --------+ import asyncio++ from trueforge_sdk import AsyncTrueForge++ client = AsyncTrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+++ async def main() -> None:+ await client.catalogs.sandbox_providers.list()+++ asyncio.run(main())+ """+ _response = await self._raw_client.list(request_options=request_options)+ return _response.datadiff --git a/python/trueforge_sdk/src/trueforge_sdk/catalogs/sandbox_providers/raw_client.py b/python/trueforge_sdk/src/trueforge_sdk/catalogs/sandbox_providers/raw_client.pynew file mode 100644index 000000000..2c23863bd--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/catalogs/sandbox_providers/raw_client.py@@ -0,0 +1,127 @@+# 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.parse_error import ParsingError+from ...core.request_options import RequestOptions+from ...core.unchecked_base_model import construct_type+from ...errors.unauthorized_error import UnauthorizedError+from ...types.get_sandbox_provider_catalog_response import GetSandboxProviderCatalogResponse+from ...types.request_error_response import RequestErrorResponse+from pydantic import ValidationError+++class RawSandboxProvidersClient:+ def __init__(self, *, client_wrapper: SyncClientWrapper):+ self._client_wrapper = client_wrapper++ def list(+ self, *, request_options: typing.Optional[RequestOptions] = None+ ) -> HttpResponse[GetSandboxProviderCatalogResponse]:+ """+ Shipped sandbox-provider presets (discovery-only). Copy into PUT /settings/sandbox-providers to configure.++ Parameters+ ----------+ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[GetSandboxProviderCatalogResponse]+ Shipped sandbox-provider presets.+ """+ _response = self._client_wrapper.httpx_client.request(+ "api/v1/catalogs/sandbox-providers",+ method="GET",+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ GetSandboxProviderCatalogResponse,+ construct_type(+ type_=GetSandboxProviderCatalogResponse, # type: ignore+ object_=_response.json(),+ ),+ )+ return HttpResponse(response=_response, data=_data)+ if _response.status_code == 401:+ raise UnauthorizedError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)+++class AsyncRawSandboxProvidersClient:+ def __init__(self, *, client_wrapper: AsyncClientWrapper):+ self._client_wrapper = client_wrapper++ async def list(+ self, *, request_options: typing.Optional[RequestOptions] = None+ ) -> AsyncHttpResponse[GetSandboxProviderCatalogResponse]:+ """+ Shipped sandbox-provider presets (discovery-only). Copy into PUT /settings/sandbox-providers to configure.++ Parameters+ ----------+ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ AsyncHttpResponse[GetSandboxProviderCatalogResponse]+ Shipped sandbox-provider presets.+ """+ _response = await self._client_wrapper.httpx_client.request(+ "api/v1/catalogs/sandbox-providers",+ method="GET",+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ GetSandboxProviderCatalogResponse,+ construct_type(+ type_=GetSandboxProviderCatalogResponse, # type: ignore+ object_=_response.json(),+ ),+ )+ return AsyncHttpResponse(response=_response, data=_data)+ if _response.status_code == 401:+ raise UnauthorizedError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)diff --git a/python/trueforge_sdk/src/trueforge_sdk/catalogs/skills/__init__.py b/python/trueforge_sdk/src/trueforge_sdk/catalogs/skills/__init__.pynew file mode 100644index 000000000..5cde0202d--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/catalogs/skills/__init__.py@@ -0,0 +1,4 @@+# This file was auto-generated by Fern from our API Definition.++# isort: skip_file+diff --git a/python/trueforge_sdk/src/trueforge_sdk/catalogs/skills/client.py b/python/trueforge_sdk/src/trueforge_sdk/catalogs/skills/client.pynew file mode 100644index 000000000..00c053cef--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/catalogs/skills/client.py@@ -0,0 +1,102 @@+# This file was auto-generated by Fern from our API Definition.++import typing++from ...core.client_wrapper import AsyncClientWrapper, SyncClientWrapper+from ...core.request_options import RequestOptions+from ...types.get_skill_catalog_response import GetSkillCatalogResponse+from .raw_client import AsyncRawSkillsClient, RawSkillsClient+++class SkillsClient:+ def __init__(self, *, client_wrapper: SyncClientWrapper):+ self._raw_client = RawSkillsClient(client_wrapper=client_wrapper)++ @property+ def with_raw_response(self) -> RawSkillsClient:+ """+ Retrieves a raw implementation of this client that returns raw responses.++ Returns+ -------+ RawSkillsClient+ """+ return self._raw_client++ def list(self, *, request_options: typing.Optional[RequestOptions] = None) -> GetSkillCatalogResponse:+ """+ Shipped skill presets (discovery-only). Copy into PUT /settings/skills to configure.++ Parameters+ ----------+ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ GetSkillCatalogResponse+ Shipped skill presets.++ Examples+ --------+ from trueforge_sdk import TrueForge++ client = TrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+ client.catalogs.skills.list()+ """+ _response = self._raw_client.list(request_options=request_options)+ return _response.data+++class AsyncSkillsClient:+ def __init__(self, *, client_wrapper: AsyncClientWrapper):+ self._raw_client = AsyncRawSkillsClient(client_wrapper=client_wrapper)++ @property+ def with_raw_response(self) -> AsyncRawSkillsClient:+ """+ Retrieves a raw implementation of this client that returns raw responses.++ Returns+ -------+ AsyncRawSkillsClient+ """+ return self._raw_client++ async def list(self, *, request_options: typing.Optional[RequestOptions] = None) -> GetSkillCatalogResponse:+ """+ Shipped skill presets (discovery-only). Copy into PUT /settings/skills to configure.++ Parameters+ ----------+ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ GetSkillCatalogResponse+ Shipped skill presets.++ Examples+ --------+ import asyncio++ from trueforge_sdk import AsyncTrueForge++ client = AsyncTrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+++ async def main() -> None:+ await client.catalogs.skills.list()+++ asyncio.run(main())+ """+ _response = await self._raw_client.list(request_options=request_options)+ return _response.datadiff --git a/python/trueforge_sdk/src/trueforge_sdk/catalogs/skills/raw_client.py b/python/trueforge_sdk/src/trueforge_sdk/catalogs/skills/raw_client.pynew file mode 100644index 000000000..bcbb8dbe7--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/catalogs/skills/raw_client.py@@ -0,0 +1,125 @@+# 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.parse_error import ParsingError+from ...core.request_options import RequestOptions+from ...core.unchecked_base_model import construct_type+from ...errors.unauthorized_error import UnauthorizedError+from ...types.get_skill_catalog_response import GetSkillCatalogResponse+from ...types.request_error_response import RequestErrorResponse+from pydantic import ValidationError+++class RawSkillsClient:+ def __init__(self, *, client_wrapper: SyncClientWrapper):+ self._client_wrapper = client_wrapper++ def list(self, *, request_options: typing.Optional[RequestOptions] = None) -> HttpResponse[GetSkillCatalogResponse]:+ """+ Shipped skill presets (discovery-only). Copy into PUT /settings/skills to configure.++ Parameters+ ----------+ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[GetSkillCatalogResponse]+ Shipped skill presets.+ """+ _response = self._client_wrapper.httpx_client.request(+ "api/v1/catalogs/skills",+ method="GET",+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ GetSkillCatalogResponse,+ construct_type(+ type_=GetSkillCatalogResponse, # type: ignore+ object_=_response.json(),+ ),+ )+ return HttpResponse(response=_response, data=_data)+ if _response.status_code == 401:+ raise UnauthorizedError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)+++class AsyncRawSkillsClient:+ def __init__(self, *, client_wrapper: AsyncClientWrapper):+ self._client_wrapper = client_wrapper++ async def list(+ self, *, request_options: typing.Optional[RequestOptions] = None+ ) -> AsyncHttpResponse[GetSkillCatalogResponse]:+ """+ Shipped skill presets (discovery-only). Copy into PUT /settings/skills to configure.++ Parameters+ ----------+ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ AsyncHttpResponse[GetSkillCatalogResponse]+ Shipped skill presets.+ """+ _response = await self._client_wrapper.httpx_client.request(+ "api/v1/catalogs/skills",+ method="GET",+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ GetSkillCatalogResponse,+ construct_type(+ type_=GetSkillCatalogResponse, # type: ignore+ object_=_response.json(),+ ),+ )+ return AsyncHttpResponse(response=_response, data=_data)+ if _response.status_code == 401:+ raise UnauthorizedError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)diff --git a/python/trueforge_sdk/src/trueforge_sdk/client.py b/python/trueforge_sdk/src/trueforge_sdk/client.pynew file mode 100644index 000000000..648c9d448--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/client.py@@ -0,0 +1,67 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import httpx+from .base_client import AsyncBaseTrueForge, BaseTrueForge+from .core.logging import LogConfig, Logger+++class TrueForge(BaseTrueForge):+ def __init__(+ self,+ *,+ base_url: str,+ token: typing.Optional[typing.Union[str, typing.Callable[[], str]]] = None,+ headers: typing.Optional[typing.Dict[str, str]] = None,+ timeout: typing.Optional[float] = None,+ max_retries: typing.Optional[int] = None,+ stream_reconnection_enabled: typing.Optional[bool] = None,+ max_stream_reconnection_attempts: typing.Optional[int] = None,+ follow_redirects: typing.Optional[bool] = True,+ httpx_client: typing.Optional[httpx.Client] = None,+ logging: typing.Optional[typing.Union[LogConfig, Logger]] = None,+ ):+ super().__init__(+ base_url=base_url,+ token=token,+ headers=headers,+ timeout=timeout,+ max_retries=max_retries,+ stream_reconnection_enabled=stream_reconnection_enabled,+ max_stream_reconnection_attempts=max_stream_reconnection_attempts,+ follow_redirects=follow_redirects,+ httpx_client=httpx_client,+ logging=logging,+ )+++class AsyncTrueForge(AsyncBaseTrueForge):+ def __init__(+ self,+ *,+ base_url: str,+ token: typing.Optional[typing.Union[str, typing.Callable[[], str]]] = None,+ headers: typing.Optional[typing.Dict[str, str]] = None,+ async_token: typing.Optional[typing.Callable[[], typing.Awaitable[str]]] = None,+ timeout: typing.Optional[float] = None,+ max_retries: typing.Optional[int] = None,+ stream_reconnection_enabled: typing.Optional[bool] = None,+ max_stream_reconnection_attempts: typing.Optional[int] = None,+ follow_redirects: typing.Optional[bool] = True,+ httpx_client: typing.Optional[httpx.AsyncClient] = None,+ logging: typing.Optional[typing.Union[LogConfig, Logger]] = None,+ ):+ super().__init__(+ base_url=base_url,+ token=token,+ headers=headers,+ async_token=async_token,+ timeout=timeout,+ max_retries=max_retries,+ stream_reconnection_enabled=stream_reconnection_enabled,+ max_stream_reconnection_attempts=max_stream_reconnection_attempts,+ follow_redirects=follow_redirects,+ httpx_client=httpx_client,+ logging=logging,+ )diff --git a/python/trueforge_sdk/src/trueforge_sdk/core/__init__.py b/python/trueforge_sdk/src/trueforge_sdk/core/__init__.pynew file mode 100644index 000000000..48239474b--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/core/__init__.py@@ -0,0 +1,146 @@+# This file was auto-generated by Fern from our API Definition.++# isort: skip_file++import typing+from importlib import import_module++if typing.TYPE_CHECKING:+ from .api_error import ApiError+ from .client_wrapper import AsyncClientWrapper, BaseClientWrapper, SyncClientWrapper+ from .datetime_utils import Rfc2822DateTime, parse_rfc2822_datetime, serialize_datetime+ from .file import File, convert_file_dict_to_httpx_tuples, with_content_type+ from .http_client import AsyncHttpClient, HttpClient+ from .http_response import AsyncHttpResponse, HttpResponse+ from .jsonable_encoder import encode_path_param, jsonable_encoder+ from .logging import ConsoleLogger, ILogger, LogConfig, LogLevel, Logger, create_logger+ from .pagination import AsyncPager, SyncPager+ from .parse_error import ParsingError+ from .pydantic_utilities import (+ IS_PYDANTIC_V2,+ UniversalBaseModel,+ UniversalRootModel,+ parse_obj_as,+ universal_field_validator,+ universal_root_validator,+ update_forward_refs,+ )+ from .query_encoder import encode_query+ from .remove_none_from_dict import remove_none_from_dict+ from .request_options import RequestOptions+ from .serialization import FieldMetadata, convert_and_respect_annotation_metadata+ from .stream import AsyncStream, Stream, StreamEvent+ from .unchecked_base_model import UncheckedBaseModel, UnionMetadata, construct_type+_dynamic_imports: typing.Dict[str, str] = {+ "ApiError": ".api_error",+ "AsyncClientWrapper": ".client_wrapper",+ "AsyncHttpClient": ".http_client",+ "AsyncHttpResponse": ".http_response",+ "AsyncPager": ".pagination",+ "AsyncStream": ".stream",+ "BaseClientWrapper": ".client_wrapper",+ "ConsoleLogger": ".logging",+ "FieldMetadata": ".serialization",+ "File": ".file",+ "HttpClient": ".http_client",+ "HttpResponse": ".http_response",+ "ILogger": ".logging",+ "IS_PYDANTIC_V2": ".pydantic_utilities",+ "LogConfig": ".logging",+ "LogLevel": ".logging",+ "Logger": ".logging",+ "ParsingError": ".parse_error",+ "RequestOptions": ".request_options",+ "Rfc2822DateTime": ".datetime_utils",+ "Stream": ".stream",+ "StreamEvent": ".stream",+ "SyncClientWrapper": ".client_wrapper",+ "SyncPager": ".pagination",+ "UncheckedBaseModel": ".unchecked_base_model",+ "UnionMetadata": ".unchecked_base_model",+ "UniversalBaseModel": ".pydantic_utilities",+ "UniversalRootModel": ".pydantic_utilities",+ "construct_type": ".unchecked_base_model",+ "convert_and_respect_annotation_metadata": ".serialization",+ "convert_file_dict_to_httpx_tuples": ".file",+ "create_logger": ".logging",+ "encode_path_param": ".jsonable_encoder",+ "encode_query": ".query_encoder",+ "jsonable_encoder": ".jsonable_encoder",+ "parse_obj_as": ".pydantic_utilities",+ "parse_rfc2822_datetime": ".datetime_utils",+ "remove_none_from_dict": ".remove_none_from_dict",+ "serialize_datetime": ".datetime_utils",+ "universal_field_validator": ".pydantic_utilities",+ "universal_root_validator": ".pydantic_utilities",+ "update_forward_refs": ".pydantic_utilities",+ "with_content_type": ".file",+}+++def __getattr__(attr_name: str) -> typing.Any:+ module_name = _dynamic_imports.get(attr_name)+ if module_name is None:+ raise AttributeError(f"No {attr_name} found in _dynamic_imports for module name -> {__name__}")+ try:+ module = import_module(module_name, __package__)+ if module_name == f".{attr_name}":+ return module+ else:+ return getattr(module, attr_name)+ except ImportError as e:+ raise ImportError(f"Failed to import {attr_name} from {module_name}: {e}") from e+ except AttributeError as e:+ raise AttributeError(f"Failed to get {attr_name} from {module_name}: {e}") from e+++def __dir__():+ lazy_attrs = list(_dynamic_imports.keys())+ return sorted(lazy_attrs)+++__all__ = [+ "ApiError",+ "AsyncClientWrapper",+ "AsyncHttpClient",+ "AsyncHttpResponse",+ "AsyncPager",+ "AsyncStream",+ "BaseClientWrapper",+ "ConsoleLogger",+ "FieldMetadata",+ "File",+ "HttpClient",+ "HttpResponse",+ "ILogger",+ "IS_PYDANTIC_V2",+ "LogConfig",+ "LogLevel",+ "Logger",+ "ParsingError",+ "RequestOptions",+ "Rfc2822DateTime",+ "Stream",+ "StreamEvent",+ "SyncClientWrapper",+ "SyncPager",+ "UncheckedBaseModel",+ "UnionMetadata",+ "UniversalBaseModel",+ "UniversalRootModel",+ "construct_type",+ "convert_and_respect_annotation_metadata",+ "convert_file_dict_to_httpx_tuples",+ "create_logger",+ "encode_path_param",+ "encode_query",+ "jsonable_encoder",+ "parse_obj_as",+ "parse_rfc2822_datetime",+ "remove_none_from_dict",+ "serialize_datetime",+ "universal_field_validator",+ "universal_root_validator",+ "update_forward_refs",+ "with_content_type",+]diff --git a/python/trueforge_sdk/src/trueforge_sdk/core/api_error.py b/python/trueforge_sdk/src/trueforge_sdk/core/api_error.pynew file mode 100644index 000000000..6f850a60c--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/core/api_error.py@@ -0,0 +1,23 @@+# This file was auto-generated by Fern from our API Definition.++from typing import Any, Dict, Optional+++class ApiError(Exception):+ headers: Optional[Dict[str, str]]+ status_code: Optional[int]+ body: Any++ def __init__(+ self,+ *,+ headers: Optional[Dict[str, str]] = None,+ status_code: Optional[int] = None,+ body: Any = None,+ ) -> None:+ self.headers = headers+ self.status_code = status_code+ self.body = body++ def __str__(self) -> str:+ return f"headers: {self.headers}, status_code: {self.status_code}, body: {self.body}"diff --git a/python/trueforge_sdk/src/trueforge_sdk/core/client_wrapper.py b/python/trueforge_sdk/src/trueforge_sdk/core/client_wrapper.pynew file mode 100644index 000000000..9b8a434f2--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/core/client_wrapper.py@@ -0,0 +1,149 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import httpx+from .http_client import AsyncHttpClient, HttpClient+from .logging import LogConfig, Logger+++class BaseClientWrapper:+ def __init__(+ self,+ *,+ token: typing.Optional[typing.Union[str, typing.Callable[[], str]]] = None,+ headers: typing.Optional[typing.Dict[str, str]] = None,+ base_url: str,+ timeout: typing.Optional[float] = None,+ max_retries: int = 2,+ stream_reconnection_enabled: typing.Optional[bool] = None,+ max_stream_reconnection_attempts: typing.Optional[int] = None,+ logging: typing.Optional[typing.Union[LogConfig, Logger]] = None,+ ):+ self._token = token+ self._headers = headers+ self._base_url = base_url+ self._timeout = timeout+ self._max_retries = max_retries+ self._stream_reconnection_enabled = stream_reconnection_enabled+ self._max_stream_reconnection_attempts = max_stream_reconnection_attempts+ self._logging = logging++ def get_headers(self) -> typing.Dict[str, str]:+ import platform++ headers: typing.Dict[str, str] = {+ "User-Agent": "trueforge_sdk/0.2.0-rc.5",+ "X-Fern-Language": "Python",+ "X-Fern-Runtime": f"python/{platform.python_version()}",+ "X-Fern-Platform": f"{platform.system().lower()}/{platform.release()}",+ "X-Fern-SDK-Name": "trueforge_sdk",+ "X-Fern-SDK-Version": "0.2.0-rc.5",+ **(self.get_custom_headers() or {}),+ }+ token = self._get_token()+ if token is not None:+ headers["Authorization"] = f"Bearer {token}"+ return headers++ def _get_token(self) -> typing.Optional[str]:+ if isinstance(self._token, str) or self._token is None:+ return self._token+ else:+ return self._token()++ def get_custom_headers(self) -> typing.Optional[typing.Dict[str, str]]:+ return self._headers++ def get_base_url(self) -> str:+ return self._base_url++ def get_timeout(self) -> typing.Optional[float]:+ return self._timeout++ def get_max_retries(self) -> int:+ return self._max_retries++ def get_stream_reconnection_enabled(self) -> bool:+ return self._stream_reconnection_enabled if self._stream_reconnection_enabled is not None else True++ def get_max_stream_reconnection_attempts(self) -> typing.Optional[int]:+ return self._max_stream_reconnection_attempts+++class SyncClientWrapper(BaseClientWrapper):+ def __init__(+ self,+ *,+ token: typing.Optional[typing.Union[str, typing.Callable[[], str]]] = None,+ headers: typing.Optional[typing.Dict[str, str]] = None,+ base_url: str,+ timeout: typing.Optional[float] = None,+ max_retries: int = 2,+ stream_reconnection_enabled: typing.Optional[bool] = None,+ max_stream_reconnection_attempts: typing.Optional[int] = None,+ logging: typing.Optional[typing.Union[LogConfig, Logger]] = None,+ httpx_client: httpx.Client,+ ):+ super().__init__(+ token=token,+ headers=headers,+ base_url=base_url,+ timeout=timeout,+ max_retries=max_retries,+ stream_reconnection_enabled=stream_reconnection_enabled,+ max_stream_reconnection_attempts=max_stream_reconnection_attempts,+ logging=logging,+ )+ self.httpx_client = HttpClient(+ httpx_client=httpx_client,+ base_headers=self.get_headers,+ base_timeout=self.get_timeout,+ base_url=self.get_base_url,+ base_max_retries=self.get_max_retries(),+ logging_config=self._logging,+ )+++class AsyncClientWrapper(BaseClientWrapper):+ def __init__(+ self,+ *,+ token: typing.Optional[typing.Union[str, typing.Callable[[], str]]] = None,+ headers: typing.Optional[typing.Dict[str, str]] = None,+ base_url: str,+ timeout: typing.Optional[float] = None,+ max_retries: int = 2,+ stream_reconnection_enabled: typing.Optional[bool] = None,+ max_stream_reconnection_attempts: typing.Optional[int] = None,+ logging: typing.Optional[typing.Union[LogConfig, Logger]] = None,+ async_token: typing.Optional[typing.Callable[[], typing.Awaitable[str]]] = None,+ httpx_client: httpx.AsyncClient,+ ):+ super().__init__(+ token=token,+ headers=headers,+ base_url=base_url,+ timeout=timeout,+ max_retries=max_retries,+ stream_reconnection_enabled=stream_reconnection_enabled,+ max_stream_reconnection_attempts=max_stream_reconnection_attempts,+ logging=logging,+ )+ self._async_token = async_token+ self.httpx_client = AsyncHttpClient(+ httpx_client=httpx_client,+ base_headers=self.get_headers,+ base_timeout=self.get_timeout,+ base_url=self.get_base_url,+ base_max_retries=self.get_max_retries(),+ async_base_headers=self.async_get_headers,+ logging_config=self._logging,+ )++ async def async_get_headers(self) -> typing.Dict[str, str]:+ headers = self.get_headers()+ if self._async_token is not None:+ token = await self._async_token()+ headers["Authorization"] = f"Bearer {token}"+ return headersdiff --git a/python/trueforge_sdk/src/trueforge_sdk/core/datetime_utils.py b/python/trueforge_sdk/src/trueforge_sdk/core/datetime_utils.pynew file mode 100644index 000000000..a12b2ad03--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/core/datetime_utils.py@@ -0,0 +1,70 @@+# This file was auto-generated by Fern from our API Definition.++import datetime as dt+from email.utils import parsedate_to_datetime+from typing import Any++import pydantic++IS_PYDANTIC_V2 = pydantic.VERSION.startswith("2.")+++def parse_rfc2822_datetime(v: Any) -> dt.datetime:+ """+ Parse an RFC 2822 datetime string (e.g., "Wed, 02 Oct 2002 13:00:00 GMT")+ into a datetime object. If the value is already a datetime, return it as-is.+ Falls back to ISO 8601 parsing if RFC 2822 parsing fails.+ """+ if isinstance(v, dt.datetime):+ return v+ if isinstance(v, str):+ try:+ return parsedate_to_datetime(v)+ except Exception:+ pass+ # Fallback to ISO 8601 parsing+ return dt.datetime.fromisoformat(v.replace("Z", "+00:00"))+ raise ValueError(f"Expected str or datetime, got {type(v)}")+++class Rfc2822DateTime(dt.datetime):+ """A datetime subclass that parses RFC 2822 date strings.++ On Pydantic V1, uses __get_validators__ for pre-validation.+ On Pydantic V2, uses __get_pydantic_core_schema__ for BeforeValidator-style parsing.+ """++ @classmethod+ def __get_validators__(cls): # type: ignore[no-untyped-def]+ yield parse_rfc2822_datetime++ @classmethod+ def __get_pydantic_core_schema__(cls, _source_type: Any, _handler: Any) -> Any: # type: ignore[override]+ from pydantic_core import core_schema++ return core_schema.no_info_before_validator_function(parse_rfc2822_datetime, core_schema.datetime_schema())+++def serialize_datetime(v: dt.datetime) -> str:+ """+ Serialize a datetime including timezone info.++ Uses the timezone info provided if present, otherwise uses the current runtime's timezone info.++ UTC datetimes end in "Z" while all other timezones are represented as offset from UTC, e.g. +05:00.+ """++ def _serialize_zoned_datetime(v: dt.datetime) -> str:+ if v.tzinfo is not None and v.tzinfo.tzname(None) == dt.timezone.utc.tzname(None):+ # UTC is a special case where we use "Z" at the end instead of "+00:00"+ return v.isoformat().replace("+00:00", "Z")+ else:+ # Delegate to the typical +/- offset format+ return v.isoformat()++ if v.tzinfo is not None:+ return _serialize_zoned_datetime(v)+ else:+ local_tz = dt.datetime.now().astimezone().tzinfo+ localized_dt = v.replace(tzinfo=local_tz)+ return _serialize_zoned_datetime(localized_dt)diff --git a/python/trueforge_sdk/src/trueforge_sdk/core/enum.py b/python/trueforge_sdk/src/trueforge_sdk/core/enum.pynew file mode 100644index 000000000..a3d17a67b--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/core/enum.py@@ -0,0 +1,20 @@+# This file was auto-generated by Fern from our API Definition.++"""+Provides a StrEnum base class that works across Python versions.++For Python >= 3.11, this re-exports the standard library enum.StrEnum.+For older Python versions, this defines a compatible StrEnum using the+(str, Enum) mixin pattern so that generated SDKs can use a single base+class in all supported Python versions.+"""++import enum+import sys++if sys.version_info >= (3, 11):+ from enum import StrEnum+else:++ class StrEnum(str, enum.Enum):+ passdiff --git a/python/trueforge_sdk/src/trueforge_sdk/core/file.py b/python/trueforge_sdk/src/trueforge_sdk/core/file.pynew file mode 100644index 000000000..44b0d27c0--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/core/file.py@@ -0,0 +1,67 @@+# This file was auto-generated by Fern from our API Definition.++from typing import IO, Dict, List, Mapping, Optional, Tuple, Union, cast++# File typing inspired by the flexibility of types within the httpx library+# https://github.com/encode/httpx/blob/master/httpx/_types.py+FileContent = Union[IO[bytes], bytes, str]+File = Union[+ # file (or bytes)+ FileContent,+ # (filename, file (or bytes))+ Tuple[Optional[str], FileContent],+ # (filename, file (or bytes), content_type)+ Tuple[Optional[str], FileContent, Optional[str]],+ # (filename, file (or bytes), content_type, headers)+ Tuple[+ Optional[str],+ FileContent,+ Optional[str],+ Mapping[str, str],+ ],+]+++def convert_file_dict_to_httpx_tuples(+ d: Dict[str, Union[File, List[File]]],+) -> List[Tuple[str, File]]:+ """+ The format we use is a list of tuples, where the first element is the+ name of the file and the second is the file object. Typically HTTPX wants+ a dict, but to be able to send lists of files, you have to use the list+ approach (which also works for non-lists)+ https://github.com/encode/httpx/pull/1032+ """++ httpx_tuples = []+ for key, file_like in d.items():+ if isinstance(file_like, list):+ for file_like_item in file_like:+ httpx_tuples.append((key, file_like_item))+ else:+ httpx_tuples.append((key, file_like))+ return httpx_tuples+++def with_content_type(*, file: File, default_content_type: str) -> File:+ """+ This function resolves to the file's content type, if provided, and defaults+ to the default_content_type value if not.+ """+ if isinstance(file, tuple):+ if len(file) == 2:+ filename, content = cast(Tuple[Optional[str], FileContent], file) # type: ignore+ return (filename, content, default_content_type)+ elif len(file) == 3:+ filename, content, file_content_type = cast(Tuple[Optional[str], FileContent, Optional[str]], file) # type: ignore+ out_content_type = file_content_type or default_content_type+ return (filename, content, out_content_type)+ elif len(file) == 4:+ filename, content, file_content_type, headers = cast( # type: ignore+ Tuple[Optional[str], FileContent, Optional[str], Mapping[str, str]], file+ )+ out_content_type = file_content_type or default_content_type+ return (filename, content, out_content_type, headers)+ else:+ raise ValueError(f"Unexpected tuple length: {len(file)}")+ return (None, file, default_content_type)diff --git a/python/trueforge_sdk/src/trueforge_sdk/core/force_multipart.py b/python/trueforge_sdk/src/trueforge_sdk/core/force_multipart.pynew file mode 100644index 000000000..5440913fd--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/core/force_multipart.py@@ -0,0 +1,18 @@+# This file was auto-generated by Fern from our API Definition.++from typing import Any, Dict+++class ForceMultipartDict(Dict[str, Any]):+ """+ A dictionary subclass that always evaluates to True in boolean contexts.++ This is used to force multipart/form-data encoding in HTTP requests even when+ the dictionary is empty, which would normally evaluate to False.+ """++ def __bool__(self) -> bool:+ return True+++FORCE_MULTIPART = ForceMultipartDict()diff --git a/python/trueforge_sdk/src/trueforge_sdk/core/http_client.py b/python/trueforge_sdk/src/trueforge_sdk/core/http_client.pynew file mode 100644index 000000000..3e5a78650--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/core/http_client.py@@ -0,0 +1,940 @@+# This file was auto-generated by Fern from our API Definition.++import asyncio+import email.utils+import re+import socket+import time+import typing+from contextlib import asynccontextmanager, contextmanager+from random import random++import httpx+from .file import File, convert_file_dict_to_httpx_tuples+from .force_multipart import FORCE_MULTIPART+from .jsonable_encoder import jsonable_encoder+from .logging import LogConfig, Logger, create_logger+from .query_encoder import encode_query+from .remove_none_from_dict import remove_none_from_dict as remove_none_from_dict+from .request_options import RequestOptions+from httpx._types import RequestFiles++INITIAL_RETRY_DELAY_SECONDS = 1.0+MAX_RETRY_DELAY_SECONDS = 60.0+JITTER_FACTOR = 0.2 # 20% random jitter+++def get_keepalive_socket_options(+ idle: int = 60,+ intvl: int = 30,+ cnt: int = 5,+) -> typing.List[typing.Tuple[int, int, int]]:+ """+ Build TCP keepalive socket options for the current platform.++ Keepalive probes keep otherwise-idle connections alive so that long,+ non-streaming requests survive idle-connection reaping by a firewall,+ load balancer, or NAT. The available socket constants are OS-dependent,+ so each option is guarded and only emitted when the platform defines it:++ - ``SO_KEEPALIVE`` is portable (Linux/macOS/Windows).+ - The idle-before-first-probe knob is ``TCP_KEEPIDLE`` on Linux and modern+ Windows, but ``TCP_KEEPALIVE`` on macOS.+ - ``TCP_KEEPINTVL`` / ``TCP_KEEPCNT`` exist on Linux/macOS/modern Windows.++ Passing these tuples to ``httpx.HTTPTransport(socket_options=...)`` /+ ``httpx.AsyncHTTPTransport(socket_options=...)`` applies them to every+ connection the transport opens.+ """+ opts: typing.List[typing.Tuple[int, int, int]] = [(socket.SOL_SOCKET, socket.SO_KEEPALIVE, 1)]+ idle_const = getattr(socket, "TCP_KEEPIDLE", None) or getattr(socket, "TCP_KEEPALIVE", None)+ if idle_const:+ opts.append((socket.IPPROTO_TCP, idle_const, idle))+ if hasattr(socket, "TCP_KEEPINTVL"):+ opts.append((socket.IPPROTO_TCP, socket.TCP_KEEPINTVL, intvl))+ if hasattr(socket, "TCP_KEEPCNT"):+ opts.append((socket.IPPROTO_TCP, socket.TCP_KEEPCNT, cnt))+ return opts+++def _parse_retry_after(response_headers: httpx.Headers) -> typing.Optional[float]:+ """+ This function parses the `Retry-After` header in a HTTP response and returns the number of seconds to wait.++ Inspired by the urllib3 retry implementation.+ """+ retry_after_ms = response_headers.get("retry-after-ms")+ if retry_after_ms is not None:+ try:+ return int(retry_after_ms) / 1000 if retry_after_ms > 0 else 0+ except Exception:+ pass++ retry_after = response_headers.get("retry-after")+ if retry_after is None:+ return None++ # Attempt to parse the header as an int.+ if re.match(r"^\s*[0-9]+\s*$", retry_after):+ seconds = float(retry_after)+ # Fallback to parsing it as a date.+ else:+ retry_date_tuple = email.utils.parsedate_tz(retry_after)+ if retry_date_tuple is None:+ return None+ if retry_date_tuple[9] is None: # Python 2+ # Assume UTC if no timezone was specified+ # On Python2.7, parsedate_tz returns None for a timezone offset+ # instead of 0 if no timezone is given, where mktime_tz treats+ # a None timezone offset as local time.+ retry_date_tuple = retry_date_tuple[:9] + (0,) + retry_date_tuple[10:]++ retry_date = email.utils.mktime_tz(retry_date_tuple)+ seconds = retry_date - time.time()++ if seconds < 0:+ seconds = 0++ return seconds+++def _add_positive_jitter(delay: float) -> float:+ """Add positive jitter (0-20%) to prevent thundering herd."""+ jitter_multiplier = 1 + random() * JITTER_FACTOR+ return delay * jitter_multiplier+++def _add_symmetric_jitter(delay: float) -> float:+ """Add symmetric jitter (±10%) for exponential backoff."""+ jitter_multiplier = 1 + (random() - 0.5) * JITTER_FACTOR+ return delay * jitter_multiplier+++def _parse_x_ratelimit_reset(response_headers: httpx.Headers) -> typing.Optional[float]:+ """+ Parse the X-RateLimit-Reset header (Unix timestamp in seconds).+ Returns seconds to wait, or None if header is missing/invalid.+ """+ reset_time_str = response_headers.get("x-ratelimit-reset")+ if reset_time_str is None:+ return None++ try:+ reset_time = int(reset_time_str)+ delay = reset_time - time.time()+ if delay > 0:+ return delay+ except (ValueError, TypeError):+ pass++ return None+++def _retry_timeout(response: httpx.Response, retries: int) -> float:+ """+ Determine the amount of time to wait before retrying a request.+ This function begins by trying to parse a retry-after header from the response, and then proceeds to use exponential backoff+ with a jitter to determine the number of seconds to wait.+ """++ # 1. Check Retry-After header first+ retry_after = _parse_retry_after(response.headers)+ if retry_after is not None and retry_after > 0:+ return min(retry_after, MAX_RETRY_DELAY_SECONDS)++ # 2. Check X-RateLimit-Reset header (with positive jitter)+ ratelimit_reset = _parse_x_ratelimit_reset(response.headers)+ if ratelimit_reset is not None:+ return _add_positive_jitter(min(ratelimit_reset, MAX_RETRY_DELAY_SECONDS))++ # 3. Fall back to exponential backoff (with symmetric jitter)+ backoff = min(INITIAL_RETRY_DELAY_SECONDS * pow(2.0, retries), MAX_RETRY_DELAY_SECONDS)+ return _add_symmetric_jitter(backoff)+++def _retry_timeout_from_retries(retries: int) -> float:+ """Determine retry timeout using exponential backoff when no response is available."""+ backoff = min(INITIAL_RETRY_DELAY_SECONDS * pow(2.0, retries), MAX_RETRY_DELAY_SECONDS)+ return _add_symmetric_jitter(backoff)+++def _should_retry(response: httpx.Response) -> bool:+ return response.status_code >= 500 or response.status_code in [429, 408, 409]+++_SENSITIVE_HEADERS = frozenset(+ {+ "authorization",+ "www-authenticate",+ "x-api-key",+ "api-key",+ "apikey",+ "x-api-token",+ "x-auth-token",+ "auth-token",+ "cookie",+ "set-cookie",+ "proxy-authorization",+ "proxy-authenticate",+ "x-csrf-token",+ "x-xsrf-token",+ "x-session-token",+ "x-access-token",+ }+)+++def _redact_headers(headers: typing.Dict[str, str]) -> typing.Dict[str, str]:+ return {k: ("[REDACTED]" if k.lower() in _SENSITIVE_HEADERS else v) for k, v in headers.items()}+++def _build_url(base_url: str, path: typing.Optional[str]) -> str:+ """+ Build a full URL by joining a base URL with a path.++ This function correctly handles base URLs that contain path prefixes (e.g., tenant-based URLs)+ by using string concatenation instead of urllib.parse.urljoin(), which would incorrectly+ strip path components when the path starts with '/'.++ Example:+ >>> _build_url("https://cloud.example.com/org/tenant/api", "/users")+ 'https://cloud.example.com/org/tenant/api/users'++ Args:+ base_url: The base URL, which may contain path prefixes.+ path: The path to append. Can be None or empty string.++ Returns:+ The full URL with base_url and path properly joined.+ """+ if not path:+ return base_url+ return f"{base_url.rstrip('/')}/{path.lstrip('/')}"+++def _maybe_filter_none_from_multipart_data(+ data: typing.Optional[typing.Any],+ request_files: typing.Optional[RequestFiles],+ force_multipart: typing.Optional[bool],+) -> typing.Optional[typing.Any]:+ """+ Filter None values from data body for multipart/form requests.+ This prevents httpx from converting None to empty strings in multipart encoding.+ Only applies when files are present or force_multipart is True.+ """+ if data is not None and isinstance(data, typing.Mapping) and (request_files or force_multipart):+ return remove_none_from_dict(data)+ return data+++def remove_omit_from_dict(+ original: typing.Dict[str, typing.Optional[typing.Any]],+ omit: typing.Optional[typing.Any],+) -> typing.Dict[str, typing.Any]:+ if omit is None:+ return original+ new: typing.Dict[str, typing.Any] = {}+ for key, value in original.items():+ if value is not omit:+ new[key] = value+ return new+++def maybe_filter_request_body(+ data: typing.Optional[typing.Any],+ request_options: typing.Optional[RequestOptions],+ omit: typing.Optional[typing.Any],+) -> typing.Optional[typing.Any]:+ if data is None:+ return (+ jsonable_encoder(request_options.get("additional_body_parameters", {})) or {}+ if request_options is not None+ else None+ )+ elif not isinstance(data, typing.Mapping):+ data_content = jsonable_encoder(data)+ else:+ data_content = {+ **(jsonable_encoder(remove_omit_from_dict(data, omit))), # type: ignore+ **(+ jsonable_encoder(request_options.get("additional_body_parameters", {})) or {}+ if request_options is not None+ else {}+ ),+ }+ return data_content+++# Abstracted out for testing purposes+def get_request_body(+ *,+ json: typing.Optional[typing.Any],+ data: typing.Optional[typing.Any],+ request_options: typing.Optional[RequestOptions],+ omit: typing.Optional[typing.Any],+ optional_body: bool = False,+) -> typing.Tuple[typing.Optional[typing.Any], typing.Optional[typing.Any]]:+ # A whole body left at the sentinel was never passed by the caller, so it is absent+ # rather than empty: the request carries no content and no `Content-Type`.+ if omit is not None:+ if json is omit:+ json = None+ if data is omit:+ data = None++ json_body = None+ data_body = None+ if data is not None:+ data_body = maybe_filter_request_body(data, request_options, omit)+ else:+ # If both data and json are None, we send json data in the event extra properties are specified+ json_body = maybe_filter_request_body(json, request_options, omit)++ has_additional_body_parameters = bool(+ request_options is not None and request_options.get("additional_body_parameters")+ )++ # Only collapse empty dict to None when the body was not explicitly provided+ # and there are no additional body parameters. This preserves explicit empty+ # bodies (e.g., when an endpoint has a request body type but all fields are optional).+ # `optional_body` marks an endpoint whose body the API does not require, where a body+ # that ends up empty means the caller passed none of its properties, so the request is+ # sent with no content and no `Content-Type`.+ if json_body == {} and (json is None or optional_body) and not has_additional_body_parameters:+ json_body = None+ if data_body == {} and (data is None or optional_body) and not has_additional_body_parameters:+ data_body = None++ return json_body, data_body+++def drop_content_type_without_body(+ headers: typing.Dict[str, typing.Any],+ *,+ json_body: typing.Optional[typing.Any],+ data_body: typing.Optional[typing.Any],+ optional_body: bool,+) -> typing.Dict[str, typing.Any]:+ """Strip ``Content-Type`` from a request that carries no body.++ ``get_request_body`` drops the body of an ``optional_body`` endpoint when the caller+ supplied none of it, but the endpoint still passes the content type it would have used.+ A request that sends nothing must not advertise a media type, so a server that branches+ on the header sees a bodyless call for what it is.+ """+ if not optional_body or json_body is not None or data_body is not None:+ return headers+ return {key: value for key, value in headers.items() if key.lower() != "content-type"}+++class HttpClient:+ def __init__(+ self,+ *,+ httpx_client: httpx.Client,+ base_timeout: typing.Callable[[], typing.Optional[float]],+ base_headers: typing.Callable[[], typing.Dict[str, str]],+ base_url: typing.Optional[typing.Callable[[], str]] = None,+ base_max_retries: int = 2,+ logging_config: typing.Optional[typing.Union[LogConfig, Logger]] = None,+ ):+ self.base_url = base_url+ self.base_timeout = base_timeout+ self.base_headers = base_headers+ self.base_max_retries = base_max_retries+ self.httpx_client = httpx_client+ self.logger = create_logger(logging_config)++ def get_base_url(self, maybe_base_url: typing.Optional[str]) -> str:+ base_url = maybe_base_url+ if self.base_url is not None and base_url is None:+ base_url = self.base_url()++ if base_url is None:+ raise ValueError("A base_url is required to make this request, please provide one and try again.")+ return base_url++ def request(+ self,+ path: typing.Optional[str] = None,+ *,+ method: str,+ base_url: typing.Optional[str] = None,+ params: typing.Optional[typing.Dict[str, typing.Any]] = None,+ json: typing.Optional[typing.Any] = None,+ data: typing.Optional[typing.Any] = None,+ content: typing.Optional[typing.Union[bytes, typing.Iterator[bytes], typing.AsyncIterator[bytes]]] = None,+ files: typing.Optional[+ typing.Union[+ typing.Dict[str, typing.Optional[typing.Union[File, typing.List[File]]]],+ typing.List[typing.Tuple[str, File]],+ ]+ ] = None,+ headers: typing.Optional[typing.Dict[str, typing.Any]] = None,+ request_options: typing.Optional[RequestOptions] = None,+ retries: int = 0,+ omit: typing.Optional[typing.Any] = None,+ optional_body: bool = False,+ force_multipart: typing.Optional[bool] = None,+ ) -> httpx.Response:+ base_url = self.get_base_url(base_url)+ _timeout = (+ request_options.get("timeout")+ if request_options is not None and request_options.get("timeout") is not None+ else request_options.get("timeout_in_seconds")+ if request_options is not None and request_options.get("timeout_in_seconds") is not None+ else self.base_timeout()+ )+ timeout = _timeout if _timeout is not None else httpx.USE_CLIENT_DEFAULT++ json_body, data_body = get_request_body(+ json=json, data=data, request_options=request_options, omit=omit, optional_body=optional_body+ )++ request_files: typing.Optional[RequestFiles] = (+ convert_file_dict_to_httpx_tuples(remove_omit_from_dict(remove_none_from_dict(files), omit))+ if (files is not None and files is not omit and isinstance(files, dict))+ else None+ )++ if (request_files is None or len(request_files) == 0) and force_multipart:+ request_files = FORCE_MULTIPART++ data_body = _maybe_filter_none_from_multipart_data(data_body, request_files, force_multipart)++ # Compute encoded params separately to avoid passing empty list to httpx+ # (httpx strips existing query params from URL when params=[] is passed)+ _encoded_params = encode_query(+ jsonable_encoder(+ remove_none_from_dict(+ remove_omit_from_dict(+ {+ **(params if params is not None else {}),+ **(+ request_options.get("additional_query_parameters", {}) or {}+ if request_options is not None+ else {}+ ),+ },+ omit,+ )+ )+ )+ )++ _request_url = _build_url(base_url, path)+ _request_headers = jsonable_encoder(+ remove_none_from_dict(+ {+ **self.base_headers(),+ **(headers if headers is not None else {}),+ **(request_options.get("additional_headers", {}) or {} if request_options is not None else {}),+ }+ )+ )+ _request_headers = drop_content_type_without_body(+ _request_headers, json_body=json_body, data_body=data_body, optional_body=optional_body+ )++ if self.logger.is_debug():+ self.logger.debug(+ "Making HTTP request",+ method=method,+ url=_request_url,+ headers=_redact_headers(_request_headers),+ has_body=json_body is not None or data_body is not None,+ )++ max_retries: int = (+ request_options.get("max_retries", self.base_max_retries)+ if request_options is not None+ else self.base_max_retries+ )++ try:+ response = self.httpx_client.request(+ method=method,+ url=_request_url,+ headers=_request_headers,+ params=_encoded_params if _encoded_params else None,+ json=json_body,+ data=data_body,+ content=content,+ files=request_files,+ timeout=timeout,+ )+ except (httpx.ConnectError, httpx.RemoteProtocolError):+ if retries < max_retries:+ time.sleep(_retry_timeout_from_retries(retries=retries))+ return self.request(+ path=path,+ method=method,+ base_url=base_url,+ params=params,+ json=json,+ data=data,+ content=content,+ files=files,+ headers=headers,+ request_options=request_options,+ retries=retries + 1,+ omit=omit,+ force_multipart=force_multipart,+ )+ raise++ if _should_retry(response=response):+ if retries < max_retries:+ time.sleep(_retry_timeout(response=response, retries=retries))+ return self.request(+ path=path,+ method=method,+ base_url=base_url,+ params=params,+ json=json,+ data=data,+ content=content,+ files=files,+ headers=headers,+ request_options=request_options,+ retries=retries + 1,+ omit=omit,+ force_multipart=force_multipart,+ )++ if self.logger.is_debug():+ if 200 <= response.status_code < 400:+ self.logger.debug(+ "HTTP request succeeded",+ method=method,+ url=_request_url,+ status_code=response.status_code,+ )++ if self.logger.is_error():+ if response.status_code >= 400:+ self.logger.error(+ "HTTP request failed with error status",+ method=method,+ url=_request_url,+ status_code=response.status_code,+ )++ return response++ @contextmanager+ def stream(+ self,+ path: typing.Optional[str] = None,+ *,+ method: str,+ base_url: typing.Optional[str] = None,+ params: typing.Optional[typing.Dict[str, typing.Any]] = None,+ json: typing.Optional[typing.Any] = None,+ data: typing.Optional[typing.Any] = None,+ content: typing.Optional[typing.Union[bytes, typing.Iterator[bytes], typing.AsyncIterator[bytes]]] = None,+ files: typing.Optional[+ typing.Union[+ typing.Dict[str, typing.Optional[typing.Union[File, typing.List[File]]]],+ typing.List[typing.Tuple[str, File]],+ ]+ ] = None,+ headers: typing.Optional[typing.Dict[str, typing.Any]] = None,+ request_options: typing.Optional[RequestOptions] = None,+ retries: int = 0,+ omit: typing.Optional[typing.Any] = None,+ optional_body: bool = False,+ force_multipart: typing.Optional[bool] = None,+ ) -> typing.Iterator[httpx.Response]:+ base_url = self.get_base_url(base_url)+ _timeout = (+ request_options.get("timeout")+ if request_options is not None and request_options.get("timeout") is not None+ else request_options.get("timeout_in_seconds")+ if request_options is not None and request_options.get("timeout_in_seconds") is not None+ else self.base_timeout()+ )+ timeout = _timeout if _timeout is not None else httpx.USE_CLIENT_DEFAULT++ request_files: typing.Optional[RequestFiles] = (+ convert_file_dict_to_httpx_tuples(remove_omit_from_dict(remove_none_from_dict(files), omit))+ if (files is not None and files is not omit and isinstance(files, dict))+ else None+ )++ if (request_files is None or len(request_files) == 0) and force_multipart:+ request_files = FORCE_MULTIPART++ json_body, data_body = get_request_body(+ json=json, data=data, request_options=request_options, omit=omit, optional_body=optional_body+ )++ data_body = _maybe_filter_none_from_multipart_data(data_body, request_files, force_multipart)++ # Compute encoded params separately to avoid passing empty list to httpx+ # (httpx strips existing query params from URL when params=[] is passed)+ _encoded_params = encode_query(+ jsonable_encoder(+ remove_none_from_dict(+ remove_omit_from_dict(+ {+ **(params if params is not None else {}),+ **(+ request_options.get("additional_query_parameters", {})+ if request_options is not None+ else {}+ ),+ },+ omit,+ )+ )+ )+ )++ _request_url = _build_url(base_url, path)+ _request_headers = jsonable_encoder(+ remove_none_from_dict(+ {+ **self.base_headers(),+ **(headers if headers is not None else {}),+ **(request_options.get("additional_headers", {}) if request_options is not None else {}),+ }+ )+ )+ _request_headers = drop_content_type_without_body(+ _request_headers, json_body=json_body, data_body=data_body, optional_body=optional_body+ )++ if self.logger.is_debug():+ self.logger.debug(+ "Making streaming HTTP request",+ method=method,+ url=_request_url,+ headers=_redact_headers(_request_headers),+ )++ with self.httpx_client.stream(+ method=method,+ url=_request_url,+ headers=_request_headers,+ params=_encoded_params if _encoded_params else None,+ json=json_body,+ data=data_body,+ content=content,+ files=request_files,+ timeout=timeout,+ ) as stream:+ yield stream+++class AsyncHttpClient:+ def __init__(+ self,+ *,+ httpx_client: httpx.AsyncClient,+ base_timeout: typing.Callable[[], typing.Optional[float]],+ base_headers: typing.Callable[[], typing.Dict[str, str]],+ base_url: typing.Optional[typing.Callable[[], str]] = None,+ base_max_retries: int = 2,+ async_base_headers: typing.Optional[typing.Callable[[], typing.Awaitable[typing.Dict[str, str]]]] = None,+ logging_config: typing.Optional[typing.Union[LogConfig, Logger]] = None,+ ):+ self.base_url = base_url+ self.base_timeout = base_timeout+ self.base_headers = base_headers+ self.base_max_retries = base_max_retries+ self.async_base_headers = async_base_headers+ self.httpx_client = httpx_client+ self.logger = create_logger(logging_config)++ async def _get_headers(self) -> typing.Dict[str, str]:+ if self.async_base_headers is not None:+ return await self.async_base_headers()+ return self.base_headers()++ def get_base_url(self, maybe_base_url: typing.Optional[str]) -> str:+ base_url = maybe_base_url+ if self.base_url is not None and base_url is None:+ base_url = self.base_url()++ if base_url is None:+ raise ValueError("A base_url is required to make this request, please provide one and try again.")+ return base_url++ async def request(+ self,+ path: typing.Optional[str] = None,+ *,+ method: str,+ base_url: typing.Optional[str] = None,+ params: typing.Optional[typing.Dict[str, typing.Any]] = None,+ json: typing.Optional[typing.Any] = None,+ data: typing.Optional[typing.Any] = None,+ content: typing.Optional[typing.Union[bytes, typing.Iterator[bytes], typing.AsyncIterator[bytes]]] = None,+ files: typing.Optional[+ typing.Union[+ typing.Dict[str, typing.Optional[typing.Union[File, typing.List[File]]]],+ typing.List[typing.Tuple[str, File]],+ ]+ ] = None,+ headers: typing.Optional[typing.Dict[str, typing.Any]] = None,+ request_options: typing.Optional[RequestOptions] = None,+ retries: int = 0,+ omit: typing.Optional[typing.Any] = None,+ optional_body: bool = False,+ force_multipart: typing.Optional[bool] = None,+ ) -> httpx.Response:+ base_url = self.get_base_url(base_url)+ _timeout = (+ request_options.get("timeout")+ if request_options is not None and request_options.get("timeout") is not None+ else request_options.get("timeout_in_seconds")+ if request_options is not None and request_options.get("timeout_in_seconds") is not None+ else self.base_timeout()+ )+ timeout = _timeout if _timeout is not None else httpx.USE_CLIENT_DEFAULT++ request_files: typing.Optional[RequestFiles] = (+ convert_file_dict_to_httpx_tuples(remove_omit_from_dict(remove_none_from_dict(files), omit))+ if (files is not None and files is not omit and isinstance(files, dict))+ else None+ )++ if (request_files is None or len(request_files) == 0) and force_multipart:+ request_files = FORCE_MULTIPART++ json_body, data_body = get_request_body(+ json=json, data=data, request_options=request_options, omit=omit, optional_body=optional_body+ )++ data_body = _maybe_filter_none_from_multipart_data(data_body, request_files, force_multipart)++ # Get headers (supports async token providers)+ _headers = await self._get_headers()++ # Compute encoded params separately to avoid passing empty list to httpx+ # (httpx strips existing query params from URL when params=[] is passed)+ _encoded_params = encode_query(+ jsonable_encoder(+ remove_none_from_dict(+ remove_omit_from_dict(+ {+ **(params if params is not None else {}),+ **(+ request_options.get("additional_query_parameters", {}) or {}+ if request_options is not None+ else {}+ ),+ },+ omit,+ )+ )+ )+ )++ _request_url = _build_url(base_url, path)+ _request_headers = jsonable_encoder(+ remove_none_from_dict(+ {+ **_headers,+ **(headers if headers is not None else {}),+ **(request_options.get("additional_headers", {}) or {} if request_options is not None else {}),+ }+ )+ )+ _request_headers = drop_content_type_without_body(+ _request_headers, json_body=json_body, data_body=data_body, optional_body=optional_body+ )++ if self.logger.is_debug():+ self.logger.debug(+ "Making HTTP request",+ method=method,+ url=_request_url,+ headers=_redact_headers(_request_headers),+ has_body=json_body is not None or data_body is not None,+ )++ max_retries: int = (+ request_options.get("max_retries", self.base_max_retries)+ if request_options is not None+ else self.base_max_retries+ )++ try:+ response = await self.httpx_client.request(+ method=method,+ url=_request_url,+ headers=_request_headers,+ params=_encoded_params if _encoded_params else None,+ json=json_body,+ data=data_body,+ content=content,+ files=request_files,+ timeout=timeout,+ )+ except (httpx.ConnectError, httpx.RemoteProtocolError):+ if retries < max_retries:+ await asyncio.sleep(_retry_timeout_from_retries(retries=retries))+ return await self.request(+ path=path,+ method=method,+ base_url=base_url,+ params=params,+ json=json,+ data=data,+ content=content,+ files=files,+ headers=headers,+ request_options=request_options,+ retries=retries + 1,+ omit=omit,+ force_multipart=force_multipart,+ )+ raise++ if _should_retry(response=response):+ if retries < max_retries:+ await asyncio.sleep(_retry_timeout(response=response, retries=retries))+ return await self.request(+ path=path,+ method=method,+ base_url=base_url,+ params=params,+ json=json,+ data=data,+ content=content,+ files=files,+ headers=headers,+ request_options=request_options,+ retries=retries + 1,+ omit=omit,+ force_multipart=force_multipart,+ )++ if self.logger.is_debug():+ if 200 <= response.status_code < 400:+ self.logger.debug(+ "HTTP request succeeded",+ method=method,+ url=_request_url,+ status_code=response.status_code,+ )++ if self.logger.is_error():+ if response.status_code >= 400:+ self.logger.error(+ "HTTP request failed with error status",+ method=method,+ url=_request_url,+ status_code=response.status_code,+ )++ return response++ @asynccontextmanager+ async def stream(+ self,+ path: typing.Optional[str] = None,+ *,+ method: str,+ base_url: typing.Optional[str] = None,+ params: typing.Optional[typing.Dict[str, typing.Any]] = None,+ json: typing.Optional[typing.Any] = None,+ data: typing.Optional[typing.Any] = None,+ content: typing.Optional[typing.Union[bytes, typing.Iterator[bytes], typing.AsyncIterator[bytes]]] = None,+ files: typing.Optional[+ typing.Union[+ typing.Dict[str, typing.Optional[typing.Union[File, typing.List[File]]]],+ typing.List[typing.Tuple[str, File]],+ ]+ ] = None,+ headers: typing.Optional[typing.Dict[str, typing.Any]] = None,+ request_options: typing.Optional[RequestOptions] = None,+ retries: int = 0,+ omit: typing.Optional[typing.Any] = None,+ optional_body: bool = False,+ force_multipart: typing.Optional[bool] = None,+ ) -> typing.AsyncIterator[httpx.Response]:+ base_url = self.get_base_url(base_url)+ _timeout = (+ request_options.get("timeout")+ if request_options is not None and request_options.get("timeout") is not None+ else request_options.get("timeout_in_seconds")+ if request_options is not None and request_options.get("timeout_in_seconds") is not None+ else self.base_timeout()+ )+ timeout = _timeout if _timeout is not None else httpx.USE_CLIENT_DEFAULT++ request_files: typing.Optional[RequestFiles] = (+ convert_file_dict_to_httpx_tuples(remove_omit_from_dict(remove_none_from_dict(files), omit))+ if (files is not None and files is not omit and isinstance(files, dict))+ else None+ )++ if (request_files is None or len(request_files) == 0) and force_multipart:+ request_files = FORCE_MULTIPART++ json_body, data_body = get_request_body(+ json=json, data=data, request_options=request_options, omit=omit, optional_body=optional_body+ )++ data_body = _maybe_filter_none_from_multipart_data(data_body, request_files, force_multipart)++ # Get headers (supports async token providers)+ _headers = await self._get_headers()++ # Compute encoded params separately to avoid passing empty list to httpx+ # (httpx strips existing query params from URL when params=[] is passed)+ _encoded_params = encode_query(+ jsonable_encoder(+ remove_none_from_dict(+ remove_omit_from_dict(+ {+ **(params if params is not None else {}),+ **(+ request_options.get("additional_query_parameters", {})+ if request_options is not None+ else {}+ ),+ },+ omit=omit,+ )+ )+ )+ )++ _request_url = _build_url(base_url, path)+ _request_headers = jsonable_encoder(+ remove_none_from_dict(+ {+ **_headers,+ **(headers if headers is not None else {}),+ **(request_options.get("additional_headers", {}) if request_options is not None else {}),+ }+ )+ )+ _request_headers = drop_content_type_without_body(+ _request_headers, json_body=json_body, data_body=data_body, optional_body=optional_body+ )++ if self.logger.is_debug():+ self.logger.debug(+ "Making streaming HTTP request",+ method=method,+ url=_request_url,+ headers=_redact_headers(_request_headers),+ )++ async with self.httpx_client.stream(+ method=method,+ url=_request_url,+ headers=_request_headers,+ params=_encoded_params if _encoded_params else None,+ json=json_body,+ data=data_body,+ content=content,+ files=request_files,+ timeout=timeout,+ ) as stream:+ yield streamdiff --git a/python/trueforge_sdk/src/trueforge_sdk/core/http_response.py b/python/trueforge_sdk/src/trueforge_sdk/core/http_response.pynew file mode 100644index 000000000..9aa1e1888--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/core/http_response.py@@ -0,0 +1,63 @@+# This file was auto-generated by Fern from our API Definition.++from typing import Dict, Generic, TypeVar++import httpx++# Generic to represent the underlying type of the data wrapped by the HTTP response.+T = TypeVar("T")+++class BaseHttpResponse:+ """Minimalist HTTP response wrapper that exposes response headers and status code."""++ _response: httpx.Response++ def __init__(self, response: httpx.Response):+ self._response = response++ @property+ def headers(self) -> Dict[str, str]:+ return dict(self._response.headers)++ @property+ def status_code(self) -> int:+ return self._response.status_code++ @property+ def response(self) -> httpx.Response:+ return self._response+++class HttpResponse(Generic[T], BaseHttpResponse):+ """HTTP response wrapper that exposes response headers and data."""++ _data: T++ def __init__(self, response: httpx.Response, data: T):+ super().__init__(response)+ self._data = data++ @property+ def data(self) -> T:+ return self._data++ def close(self) -> None:+ self._response.close()+++class AsyncHttpResponse(Generic[T], BaseHttpResponse):+ """HTTP response wrapper that exposes response headers and data."""++ _data: T++ def __init__(self, response: httpx.Response, data: T):+ super().__init__(response)+ self._data = data++ @property+ def data(self) -> T:+ return self._data++ async def close(self) -> None:+ await self._response.aclose()diff --git a/python/trueforge_sdk/src/trueforge_sdk/core/http_sse/__init__.py b/python/trueforge_sdk/src/trueforge_sdk/core/http_sse/__init__.pynew file mode 100644index 000000000..730e5a338--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/core/http_sse/__init__.py@@ -0,0 +1,42 @@+# This file was auto-generated by Fern from our API Definition.++# isort: skip_file++import typing+from importlib import import_module++if typing.TYPE_CHECKING:+ from ._api import EventSource, aconnect_sse, connect_sse+ from ._exceptions import SSEError+ from ._models import ServerSentEvent+_dynamic_imports: typing.Dict[str, str] = {+ "EventSource": "._api",+ "SSEError": "._exceptions",+ "ServerSentEvent": "._models",+ "aconnect_sse": "._api",+ "connect_sse": "._api",+}+++def __getattr__(attr_name: str) -> typing.Any:+ module_name = _dynamic_imports.get(attr_name)+ if module_name is None:+ raise AttributeError(f"No {attr_name} found in _dynamic_imports for module name -> {__name__}")+ try:+ module = import_module(module_name, __package__)+ if module_name == f".{attr_name}":+ return module+ else:+ return getattr(module, attr_name)+ except ImportError as e:+ raise ImportError(f"Failed to import {attr_name} from {module_name}: {e}") from e+ except AttributeError as e:+ raise AttributeError(f"Failed to get {attr_name} from {module_name}: {e}") from e+++def __dir__():+ lazy_attrs = list(_dynamic_imports.keys())+ return sorted(lazy_attrs)+++__all__ = ["EventSource", "SSEError", "ServerSentEvent", "aconnect_sse", "connect_sse"]diff --git a/python/trueforge_sdk/src/trueforge_sdk/core/http_sse/_api.py b/python/trueforge_sdk/src/trueforge_sdk/core/http_sse/_api.pynew file mode 100644index 000000000..9ca5602c2--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/core/http_sse/_api.py@@ -0,0 +1,455 @@+# This file was auto-generated by Fern from our API Definition.++import codecs+import re+import time+from contextlib import asynccontextmanager, contextmanager+from typing import (+ Any,+ AsyncContextManager,+ AsyncGenerator,+ AsyncIterator,+ Callable,+ ContextManager,+ Iterator,+ Optional,+)++import anyio+import httpx+from ._decoders import SSEDecoder+from ._exceptions import SSEError+from ._models import ServerSentEvent++MAX_LINE_SIZE: int = 1_048_576 # 1 MiB++# Reconnection defaults, mirroring the TypeScript SDK's Stream implementation.+DEFAULT_MAX_RECONNECTION_ATTEMPTS: int = 5+DEFAULT_RECONNECT_DELAY_MS: int = 1_000+MAX_RECONNECT_DELAY_MS: int = 30_000+++# A reconnect callback re-issues the original request (with a ``Last-Event-ID``+# header set to the supplied event id) and returns a *context manager* yielding+# a fresh streaming ``httpx.Response``. Sync clients supply a sync context+# manager; async clients supply an async one.+class EventSource:+ def __init__(+ self,+ response: httpx.Response,+ *,+ resumable: bool = False,+ stream_reconnection_enabled: bool = True,+ max_stream_reconnection_attempts: Optional[int] = None,+ stream_terminator: Optional[str] = None,+ reconnect: Optional[Callable[[str], Any]] = None,+ ) -> None:+ self._response = response+ self._resumable = resumable+ self._stream_reconnection_enabled = stream_reconnection_enabled+ self._max_stream_reconnection_attempts = max_stream_reconnection_attempts+ self._stream_terminator = stream_terminator+ self._reconnect = reconnect++ @staticmethod+ def _is_event_stream(response: httpx.Response) -> bool:+ content_type = response.headers.get("content-type", "").partition(";")[0]+ return "text/event-stream" in content_type++ def _check_content_type(self) -> None:+ if not self._is_event_stream(self._response):+ content_type = self._response.headers.get("content-type", "").partition(";")[0]+ raise SSEError(+ f"Expected response header Content-Type to contain 'text/event-stream', got {content_type!r}"+ )++ def _is_reconnect_response_usable(self, response: httpx.Response) -> bool:+ """Whether a reconnected response can be resumed as an SSE stream.++ ``httpx.stream`` does not raise on non-success status, so a resume that+ returns an error page (e.g. ``200 text/html`` or a ``500`` body) would+ otherwise be parsed as SSE and yield garbage/zero events. Such a+ response is treated as a failed attempt (back off and retry) instead.+ """+ return response.status_code < 400 and self._is_event_stream(response)++ def _get_charset(self, response: Optional[httpx.Response] = None) -> str:+ """Extract charset from Content-Type header, fallback to UTF-8."""+ resolved = response if response is not None else self._response+ content_type = resolved.headers.get("content-type", "")++ # Parse charset parameter using regex+ charset_match = re.search(r"charset=([^;\s]+)", content_type, re.IGNORECASE)+ if charset_match:+ charset = charset_match.group(1).strip("\"'")+ # Validate that it's a known encoding+ try:+ # Test if the charset is valid by trying to encode/decode+ "test".encode(charset).decode(charset)+ return charset+ except (LookupError, UnicodeError):+ # If charset is invalid, fall back to UTF-8+ pass++ # Default to UTF-8 if no charset specified or invalid charset+ return "utf-8"++ @property+ def response(self) -> httpx.Response:+ return self._response++ @staticmethod+ def _normalize_sse_line_endings(buf: str) -> str:+ """Normalize line endings per the SSE spec (\\r\\n → \\n, bare \\r → \\n).++ A trailing \\r is preserved because it may pair with a leading \\n in+ the next chunk to form a single \\r\\n terminator.+ """+ buf = buf.replace("\r\n", "\n")+ if buf.endswith("\r"):+ return buf[:-1].replace("\r", "\n") + "\r"+ return buf.replace("\r", "\n")++ def _new_text_decoder(self, response: Optional[httpx.Response] = None) -> "codecs.IncrementalDecoder":+ return codecs.getincrementaldecoder(self._get_charset(response))(errors="replace")++ def _reconnect_applicable(self) -> bool:+ """Whether reconnection is configured for this stream at all.++ This is the terminator-gating half of the reconnect decision, kept+ separate from :meth:`_should_reconnect` (which additionally requires a+ last *dispatched* id and an unexhausted attempt budget). The split lets+ a mid-stream transport error terminate consistently:+ - a stream that can never reconnect (non-resumable, no terminator,+ disabled, or no callback) must re-raise the error to the caller, so a+ truncated stream is not mistaken for a clean completion;+ - a resumable stream that has merely run out of attempts (or has no id+ to resume from) ends cleanly — the same way an exhausted empty/error+ -body resume already does, matching the TypeScript ``return``.+ """+ return (+ self._resumable+ and self._stream_terminator is not None+ and self._stream_reconnection_enabled+ and self._reconnect is not None+ )++ def _should_reconnect(self, last_dispatched_id: Optional[str], reconnect_attempts: int) -> bool:+ """Decide whether a prematurely-ended stream should be reconnected.++ Mirrors the TypeScript ``shouldReconnect`` gating:+ - only resumable SSE endpoints with a configured terminator, reconnect+ enabled, and a reconnect callback are eligible (see+ :meth:`_reconnect_applicable`);+ - a last *dispatched* event id must exist to resume from;+ - the consecutive-failed-attempt cap must not be exceeded.+ """+ if not self._reconnect_applicable():+ return False+ if not last_dispatched_id:+ return False+ max_attempts = (+ self._max_stream_reconnection_attempts+ if self._max_stream_reconnection_attempts is not None+ else DEFAULT_MAX_RECONNECTION_ATTEMPTS+ )+ if reconnect_attempts >= max_attempts:+ return False+ return True++ def _reconnect_delay_seconds(self, last_retry: Optional[int]) -> float:+ """Backoff before a reconnect.++ Uses the server's most recent ``retry:`` directive (milliseconds) when+ present, otherwise a default of ``DEFAULT_RECONNECT_DELAY_MS``, clamped+ to ``MAX_RECONNECT_DELAY_MS``.+ """+ base_ms = last_retry if (last_retry is not None and last_retry > 0) else DEFAULT_RECONNECT_DELAY_MS+ return min(base_ms, MAX_RECONNECT_DELAY_MS) / 1000.0++ def _sleep_before_reconnect(self, last_retry: Optional[int]) -> None:+ # ``time.sleep`` blocks the calling thread but remains interruptible by+ # signals (e.g. ``KeyboardInterrupt``), which propagate out and abort+ # the reconnect without issuing another request.+ time.sleep(self._reconnect_delay_seconds(last_retry))++ async def _asleep_before_reconnect(self, last_retry: Optional[int]) -> None:+ # ``anyio.sleep`` is cancellation-aware: if the consumer cancels the task+ # or closes the async generator mid-delay, this raises (and no further+ # request is issued) instead of blocking for the whole interval.+ await anyio.sleep(self._reconnect_delay_seconds(last_retry))++ def _decode_response(+ self,+ response: httpx.Response,+ decoder: SSEDecoder,+ text_decoder: "codecs.IncrementalDecoder",+ ) -> Iterator[ServerSentEvent]:+ buf = ""+ for chunk in response.iter_bytes():+ buf += text_decoder.decode(chunk)+ buf = self._normalize_sse_line_endings(buf)++ while "\n" in buf:+ line, buf = buf.split("\n", 1)+ sse = decoder.decode(line)+ if sse is not None:+ yield sse++ if len(buf) > MAX_LINE_SIZE:+ raise SSEError(+ f"SSE line exceeded maximum size of {MAX_LINE_SIZE} characters without encountering a newline"+ )++ yield from self._flush_decoder(buf, decoder, text_decoder)++ async def _adecode_response(+ self,+ response: httpx.Response,+ decoder: SSEDecoder,+ text_decoder: "codecs.IncrementalDecoder",+ ) -> AsyncGenerator[ServerSentEvent, None]:+ buf = ""+ async for chunk in response.aiter_bytes():+ buf += text_decoder.decode(chunk)+ buf = self._normalize_sse_line_endings(buf)++ while "\n" in buf:+ line, buf = buf.split("\n", 1)+ sse = decoder.decode(line)+ if sse is not None:+ yield sse++ if len(buf) > MAX_LINE_SIZE:+ raise SSEError(+ f"SSE line exceeded maximum size of {MAX_LINE_SIZE} characters without encountering a newline"+ )++ for sse in self._flush_decoder(buf, decoder, text_decoder):+ yield sse++ def _flush_decoder(+ self,+ buf: str,+ decoder: SSEDecoder,+ text_decoder: "codecs.IncrementalDecoder",+ ) -> Iterator[ServerSentEvent]:+ # Flush any remaining bytes from the incremental decoder+ buf += text_decoder.decode(b"", final=True)+ buf = buf.replace("\r\n", "\n").replace("\r", "\n")++ if len(buf) > MAX_LINE_SIZE:+ raise SSEError(+ f"SSE line exceeded maximum size of {MAX_LINE_SIZE} characters without encountering a newline"+ )++ while "\n" in buf:+ line, buf = buf.split("\n", 1)+ sse = decoder.decode(line)+ if sse is not None:+ yield sse++ if buf.strip():+ sse = decoder.decode(buf)+ if sse is not None:+ yield sse++ def iter_sse(self) -> Iterator[ServerSentEvent]:+ self._check_content_type()+ decoder = SSEDecoder()+ text_decoder = self._new_text_decoder()++ last_dispatched_id: Optional[str] = None+ last_retry: Optional[int] = None+ # Consecutive failed reconnection attempts. Reset to 0 whenever an event+ # is successfully dispatched (reset-on-progress) — matching browser+ # `EventSource` semantics: a server that emits >=1 event then drops on+ # every connection can reconnect indefinitely.+ reconnect_attempts = 0++ # ``None`` means there is no live stream to read this iteration (e.g. a+ # failed reconnect); the loop then re-evaluates the reconnect decision+ # without re-reading an exhausted response.+ response: Optional[httpx.Response] = self._response+ # Context manager for a response we opened ourselves and must close.+ # The initial response is owned by the caller, so it starts as None.+ owned_cm: Optional[ContextManager[httpx.Response]] = None+ try:+ while True:+ if response is not None:+ events = self._decode_response(response, decoder, text_decoder)+ while True:+ try:+ sse = next(events)+ except StopIteration:+ break+ except SSEError:+ # A protocol violation (e.g. an oversized line) is a+ # genuine error, not a dropped connection; propagate it.+ # Listed first because ``SSEError`` subclasses+ # ``httpx.TransportError``.+ raise+ except httpx.TransportError:+ # A transport error mid-stream (e.g. the server dropped+ # the connection: ``ReadError``/``RemoteProtocolError``)+ # is a premature end. Only swallow it when reconnection+ # is configured for this stream; otherwise re-raise so a+ # non-resumable stream still surfaces the error to the+ # caller instead of looking like a clean completion.+ # When reconnection is applicable but the attempt budget+ # is exhausted, we ``break`` and end cleanly below — the+ # same way an exhausted empty/error-body resume does, so+ # give-up is consistent regardless of failure shape.+ # ``next`` is used rather than ``for`` so this cannot+ # swallow a ``GeneratorExit`` raised at a ``yield``.+ if not self._reconnect_applicable():+ raise+ break+ yield sse+ if sse.id:+ last_dispatched_id = sse.id+ if sse.retry is not None:+ last_retry = sse.retry+ reconnect_attempts = 0++ if not self._should_reconnect(last_dispatched_id, reconnect_attempts):+ return+ reconnect_attempts += 1++ self._sleep_before_reconnect(last_retry)++ # Close the previously-opened reconnect response before opening+ # a new one so we never hold more than one extra connection.+ if owned_cm is not None:+ owned_cm.__exit__(None, None, None)+ owned_cm = None++ assert self._reconnect is not None # guaranteed by _should_reconnect+ try:+ cm: ContextManager[httpx.Response] = self._reconnect(last_dispatched_id or "")+ new_response = cm.__enter__()+ except Exception:+ # A failed reconnect consumes an attempt; back off and retry.+ response = None+ continue+ owned_cm = cm+ if new_response is None or not self._is_reconnect_response_usable(new_response):+ # Null/empty body or a non-SSE/error response (e.g. 204/304,+ # a 500, or an HTML error page): treat as a failed attempt.+ response = None+ continue++ response = new_response+ # Drop any partial event left over from the dropped stream, but+ # keep the last event id (per the SSE spec) and start a fresh+ # incremental text decoder for the new connection.+ decoder.reset_in_progress_event()+ text_decoder = self._new_text_decoder(new_response)+ finally:+ if owned_cm is not None:+ owned_cm.__exit__(None, None, None)++ async def aiter_sse(self) -> AsyncGenerator[ServerSentEvent, None]:+ self._check_content_type()+ decoder = SSEDecoder()+ text_decoder = self._new_text_decoder()++ last_dispatched_id: Optional[str] = None+ last_retry: Optional[int] = None+ reconnect_attempts = 0++ response: Optional[httpx.Response] = self._response+ owned_cm: Optional[AsyncContextManager[httpx.Response]] = None+ try:+ while True:+ if response is not None:+ events = self._adecode_response(response, decoder, text_decoder)+ while True:+ try:+ sse = await events.__anext__()+ except StopAsyncIteration:+ break+ except SSEError:+ # A protocol violation (e.g. an oversized line) is a+ # genuine error, not a dropped connection; propagate it.+ # Listed first because ``SSEError`` subclasses+ # ``httpx.TransportError``.+ raise+ except httpx.TransportError:+ # A transport error mid-stream (e.g. the server dropped+ # the connection: ``ReadError``/``RemoteProtocolError``)+ # is a premature end. Only swallow it when reconnection+ # is configured for this stream; otherwise re-raise so a+ # non-resumable stream still surfaces the error to the+ # caller instead of looking like a clean completion.+ # When reconnection is applicable but the attempt budget+ # is exhausted, we ``break`` and end cleanly below — the+ # same way an exhausted empty/error-body resume does, so+ # give-up is consistent regardless of failure shape.+ if not self._reconnect_applicable():+ raise+ break+ yield sse+ if sse.id:+ last_dispatched_id = sse.id+ if sse.retry is not None:+ last_retry = sse.retry+ reconnect_attempts = 0++ if not self._should_reconnect(last_dispatched_id, reconnect_attempts):+ return+ reconnect_attempts += 1++ await self._asleep_before_reconnect(last_retry)++ if owned_cm is not None:+ await owned_cm.__aexit__(None, None, None)+ owned_cm = None++ assert self._reconnect is not None # guaranteed by _should_reconnect+ try:+ cm: AsyncContextManager[httpx.Response] = self._reconnect(last_dispatched_id or "")+ new_response = await cm.__aenter__()+ except Exception:+ response = None+ continue+ owned_cm = cm+ if new_response is None or not self._is_reconnect_response_usable(new_response):+ response = None+ continue++ response = new_response+ decoder.reset_in_progress_event()+ text_decoder = self._new_text_decoder(new_response)+ finally:+ if owned_cm is not None:+ # Shield the close so a cancellation delivered while reading a+ # reconnected response still fully tears the connection down+ # instead of leaking it until the client is closed.+ with anyio.CancelScope(shield=True):+ await owned_cm.__aexit__(None, None, None)+++@contextmanager+def connect_sse(client: httpx.Client, method: str, url: str, **kwargs: Any) -> Iterator[EventSource]:+ headers = kwargs.pop("headers", {})+ headers["Accept"] = "text/event-stream"+ headers["Cache-Control"] = "no-store"++ with client.stream(method, url, headers=headers, **kwargs) as response:+ yield EventSource(response)+++@asynccontextmanager+async def aconnect_sse(+ client: httpx.AsyncClient,+ method: str,+ url: str,+ **kwargs: Any,+) -> AsyncIterator[EventSource]:+ headers = kwargs.pop("headers", {})+ headers["Accept"] = "text/event-stream"+ headers["Cache-Control"] = "no-store"++ async with client.stream(method, url, headers=headers, **kwargs) as response:+ yield EventSource(response)diff --git a/python/trueforge_sdk/src/trueforge_sdk/core/http_sse/_decoders.py b/python/trueforge_sdk/src/trueforge_sdk/core/http_sse/_decoders.pynew file mode 100644index 000000000..1f6b35ec0--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/core/http_sse/_decoders.py@@ -0,0 +1,74 @@+# This file was auto-generated by Fern from our API Definition.++from typing import List, Optional++from ._models import ServerSentEvent+++class SSEDecoder:+ def __init__(self) -> None:+ self._event = ""+ self._data: List[str] = []+ self._last_event_id = ""+ self._retry: Optional[int] = None++ def reset_in_progress_event(self) -> None:+ """Discard any partially-parsed (undispatched) event.++ Used when a stream ends mid-event before reconnecting: the buffered+ ``event``/``data``/``retry`` fields of the never-dispatched event must+ be dropped so they do not corrupt the first event of the reconnected+ stream. Per the SSE spec the last event id is *not* reset here — it+ persists across connections.+ """+ self._event = ""+ self._data = []+ self._retry = None++ def decode(self, line: str) -> Optional[ServerSentEvent]:+ # See: https://html.spec.whatwg.org/multipage/server-sent-events.html#event-stream-interpretation # noqa: E501++ if not line:+ if not self._event and not self._data and not self._last_event_id and self._retry is None:+ return None++ sse = ServerSentEvent(+ event=self._event,+ data="\n".join(self._data),+ id=self._last_event_id,+ retry=self._retry,+ )++ # NOTE: as per the SSE spec, do not reset last_event_id.+ self._event = ""+ self._data = []+ self._retry = None++ return sse++ if line.startswith(":"):+ return None++ fieldname, _, value = line.partition(":")++ if value.startswith(" "):+ value = value[1:]++ if fieldname == "event":+ self._event = value+ elif fieldname == "data":+ self._data.append(value)+ elif fieldname == "id":+ if "\0" in value:+ pass+ else:+ self._last_event_id = value+ elif fieldname == "retry":+ try:+ self._retry = int(value)+ except (TypeError, ValueError):+ pass+ else:+ pass # Field is ignored.++ return Nonediff --git a/python/trueforge_sdk/src/trueforge_sdk/core/http_sse/_exceptions.py b/python/trueforge_sdk/src/trueforge_sdk/core/http_sse/_exceptions.pynew file mode 100644index 000000000..81605a8a6--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/core/http_sse/_exceptions.py@@ -0,0 +1,7 @@+# This file was auto-generated by Fern from our API Definition.++import httpx+++class SSEError(httpx.TransportError):+ passdiff --git a/python/trueforge_sdk/src/trueforge_sdk/core/http_sse/_models.py b/python/trueforge_sdk/src/trueforge_sdk/core/http_sse/_models.pynew file mode 100644index 000000000..1af57f8fd--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/core/http_sse/_models.py@@ -0,0 +1,17 @@+# This file was auto-generated by Fern from our API Definition.++import json+from dataclasses import dataclass+from typing import Any, Optional+++@dataclass(frozen=True)+class ServerSentEvent:+ event: str = "message"+ data: str = ""+ id: str = ""+ retry: Optional[int] = None++ def json(self) -> Any:+ """Parse the data field as JSON."""+ return json.loads(self.data)diff --git a/python/trueforge_sdk/src/trueforge_sdk/core/jsonable_encoder.py b/python/trueforge_sdk/src/trueforge_sdk/core/jsonable_encoder.pynew file mode 100644index 000000000..f638cc9a4--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/core/jsonable_encoder.py@@ -0,0 +1,133 @@+# This file was auto-generated by Fern from our API Definition.++"""+jsonable_encoder converts a Python object to a JSON-friendly dict+(e.g. datetimes to strings, Pydantic models to dicts).++Taken from FastAPI, and made a bit simpler+https://github.com/tiangolo/fastapi/blob/master/fastapi/encoders.py+"""++import base64+import dataclasses+import datetime as dt+from enum import Enum+from pathlib import PurePath+from types import GeneratorType+from typing import Any, Callable, Dict, List, Optional, Set, Union+from urllib.parse import quote++import pydantic+from .datetime_utils import serialize_datetime+from .pydantic_utilities import (+ IS_PYDANTIC_V2,+ encode_by_type,+ to_jsonable_with_fallback,+)++SetIntStr = Set[Union[int, str]]+DictIntStrAny = Dict[Union[int, str], Any]+++def jsonable_encoder(obj: Any, custom_encoder: Optional[Dict[Any, Callable[[Any], Any]]] = None) -> Any:+ custom_encoder = custom_encoder or {}+ # Generated SDKs use Ellipsis (`...`) as the sentinel value for "OMIT".+ # OMIT values should be excluded from serialized payloads.+ if obj is Ellipsis:+ return None+ if custom_encoder:+ if type(obj) in custom_encoder:+ return custom_encoder[type(obj)](obj)+ else:+ for encoder_type, encoder_instance in custom_encoder.items():+ if isinstance(obj, encoder_type):+ return encoder_instance(obj)+ if isinstance(obj, pydantic.BaseModel):+ if IS_PYDANTIC_V2:+ encoder = getattr(obj.model_config, "json_encoders", {}) # type: ignore # Pydantic v2+ else:+ encoder = getattr(obj.__config__, "json_encoders", {}) # type: ignore # Pydantic v1+ if custom_encoder:+ encoder.update(custom_encoder)+ obj_dict = obj.dict(by_alias=True)+ if "__root__" in obj_dict:+ obj_dict = obj_dict["__root__"]+ if "root" in obj_dict:+ obj_dict = obj_dict["root"]+ return jsonable_encoder(obj_dict, custom_encoder=encoder)+ if dataclasses.is_dataclass(obj):+ obj_dict = dataclasses.asdict(obj) # type: ignore+ return jsonable_encoder(obj_dict, custom_encoder=custom_encoder)+ if isinstance(obj, bytes):+ return base64.b64encode(obj).decode("utf-8")+ if isinstance(obj, Enum):+ return obj.value+ if isinstance(obj, PurePath):+ return str(obj)+ if isinstance(obj, (str, int, float, type(None))):+ return obj+ if isinstance(obj, dt.datetime):+ return serialize_datetime(obj)+ if isinstance(obj, dt.date):+ return str(obj)+ if isinstance(obj, dict):+ encoded_dict = {}+ allowed_keys = set(obj.keys())+ for key, value in obj.items():+ if key in allowed_keys:+ if value is Ellipsis:+ continue+ encoded_key = jsonable_encoder(key, custom_encoder=custom_encoder)+ encoded_value = jsonable_encoder(value, custom_encoder=custom_encoder)+ encoded_dict[encoded_key] = encoded_value+ return encoded_dict+ if isinstance(obj, (list, set, frozenset, GeneratorType, tuple)):+ encoded_list = []+ for item in obj:+ if item is Ellipsis:+ continue+ encoded_list.append(jsonable_encoder(item, custom_encoder=custom_encoder))+ return encoded_list++ def fallback_serializer(o: Any) -> Any:+ attempt_encode = encode_by_type(o)+ if attempt_encode is not None:+ return attempt_encode++ try:+ data = dict(o)+ except Exception as e:+ errors: List[Exception] = []+ errors.append(e)+ try:+ data = vars(o)+ except Exception as e:+ errors.append(e)+ raise ValueError(errors) from e+ return jsonable_encoder(data, custom_encoder=custom_encoder)++ return to_jsonable_with_fallback(obj, fallback_serializer)+++def encode_path_param(obj: Any) -> str:+ """Encode a value for use in a URL path segment.++ Ensures proper string conversion for all types, including+ booleans which need lowercase 'true'/'false' rather than+ Python's 'True'/'False'.+ """+ if isinstance(obj, bool):+ return "true" if obj else "false"+ return str(jsonable_encoder(obj))+++def quote_path_param(obj: Any) -> str:+ """Encode a value for use in a URL path segment, percent-encoding it.++ Same as encode_path_param, except the result is percent-encoded so+ that a value containing "/" or ".." cannot change which endpoint+ the request resolves to.+ """+ if isinstance(obj, bool):+ return "true" if obj else "false"+ return quote(str(jsonable_encoder(obj)), safe="")diff --git a/python/trueforge_sdk/src/trueforge_sdk/core/logging.py b/python/trueforge_sdk/src/trueforge_sdk/core/logging.pynew file mode 100644index 000000000..e5e572458--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/core/logging.py@@ -0,0 +1,107 @@+# This file was auto-generated by Fern from our API Definition.++import logging+import typing++LogLevel = typing.Literal["debug", "info", "warn", "error"]++_LOG_LEVEL_MAP: typing.Dict[LogLevel, int] = {+ "debug": 1,+ "info": 2,+ "warn": 3,+ "error": 4,+}+++class ILogger(typing.Protocol):+ def debug(self, message: str, **kwargs: typing.Any) -> None: ...+ def info(self, message: str, **kwargs: typing.Any) -> None: ...+ def warn(self, message: str, **kwargs: typing.Any) -> None: ...+ def error(self, message: str, **kwargs: typing.Any) -> None: ...+++class ConsoleLogger:+ _logger: logging.Logger++ def __init__(self) -> None:+ self._logger = logging.getLogger("fern")+ if not self._logger.handlers:+ handler = logging.StreamHandler()+ handler.setFormatter(logging.Formatter("%(levelname)s - %(message)s"))+ self._logger.addHandler(handler)+ self._logger.setLevel(logging.DEBUG)++ def debug(self, message: str, **kwargs: typing.Any) -> None:+ self._logger.debug(message, extra=kwargs)++ def info(self, message: str, **kwargs: typing.Any) -> None:+ self._logger.info(message, extra=kwargs)++ def warn(self, message: str, **kwargs: typing.Any) -> None:+ self._logger.warning(message, extra=kwargs)++ def error(self, message: str, **kwargs: typing.Any) -> None:+ self._logger.error(message, extra=kwargs)+++class LogConfig(typing.TypedDict, total=False):+ level: LogLevel+ logger: ILogger+ silent: bool+++class Logger:+ _level: int+ _logger: ILogger+ _silent: bool++ def __init__(self, *, level: LogLevel, logger: ILogger, silent: bool) -> None:+ self._level = _LOG_LEVEL_MAP[level]+ self._logger = logger+ self._silent = silent++ def _should_log(self, level: LogLevel) -> bool:+ return not self._silent and self._level <= _LOG_LEVEL_MAP[level]++ def is_debug(self) -> bool:+ return self._should_log("debug")++ def is_info(self) -> bool:+ return self._should_log("info")++ def is_warn(self) -> bool:+ return self._should_log("warn")++ def is_error(self) -> bool:+ return self._should_log("error")++ def debug(self, message: str, **kwargs: typing.Any) -> None:+ if self.is_debug():+ self._logger.debug(message, **kwargs)++ def info(self, message: str, **kwargs: typing.Any) -> None:+ if self.is_info():+ self._logger.info(message, **kwargs)++ def warn(self, message: str, **kwargs: typing.Any) -> None:+ if self.is_warn():+ self._logger.warn(message, **kwargs)++ def error(self, message: str, **kwargs: typing.Any) -> None:+ if self.is_error():+ self._logger.error(message, **kwargs)+++_default_logger: Logger = Logger(level="info", logger=ConsoleLogger(), silent=True)+++def create_logger(config: typing.Optional[typing.Union[LogConfig, Logger]] = None) -> Logger:+ if config is None:+ return _default_logger+ if isinstance(config, Logger):+ return config+ return Logger(+ level=config.get("level", "info"),+ logger=config.get("logger", ConsoleLogger()),+ silent=config.get("silent", True),+ )diff --git a/python/trueforge_sdk/src/trueforge_sdk/core/pagination.py b/python/trueforge_sdk/src/trueforge_sdk/core/pagination.pynew file mode 100644index 000000000..760b08995--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/core/pagination.py@@ -0,0 +1,82 @@+# This file was auto-generated by Fern from our API Definition.++from __future__ import annotations++from dataclasses import dataclass+from typing import AsyncIterator, Awaitable, Callable, Generic, Iterator, List, Optional, TypeVar++# Generic to represent the underlying type of the results within a page+T = TypeVar("T")+# Generic to represent the type of the API response+R = TypeVar("R")+++# SDKs implement a Page ABC per-pagination request, the endpoint then returns a pager that wraps this type+# for example, an endpoint will return SyncPager[UserPage] where UserPage implements the Page ABC. ex:+#+# SyncPager<InnerListType>(+# has_next=response.list_metadata.after is not None,+# items=response.data,+# # This should be the outer function that returns the SyncPager again+# get_next=lambda: list(..., cursor: response.cursor) (or list(..., offset: offset + 1))+# )+++@dataclass(frozen=True)+class SyncPager(Generic[T, R]):+ get_next: Optional[Callable[[], Optional[SyncPager[T, R]]]]+ has_next: bool+ items: Optional[List[T]]+ response: R++ # Here we type ignore the iterator to avoid a mypy error+ # caused by the type conflict with Pydanitc's __iter__ method+ # brought in by extending the base model+ def __iter__(self) -> Iterator[T]: # type: ignore[override]+ for page in self.iter_pages():+ if page.items is not None:+ yield from page.items++ def iter_pages(self) -> Iterator[SyncPager[T, R]]:+ page: Optional[SyncPager[T, R]] = self+ while page is not None:+ yield page++ if not page.has_next or page.get_next is None:+ return++ page = page.get_next()+ if page is None or page.items is None or len(page.items) == 0:+ return++ def next_page(self) -> Optional[SyncPager[T, R]]:+ return self.get_next() if self.get_next is not None else None+++@dataclass(frozen=True)+class AsyncPager(Generic[T, R]):+ get_next: Optional[Callable[[], Awaitable[Optional[AsyncPager[T, R]]]]]+ has_next: bool+ items: Optional[List[T]]+ response: R++ async def __aiter__(self) -> AsyncIterator[T]:+ async for page in self.iter_pages():+ if page.items is not None:+ for item in page.items:+ yield item++ async def iter_pages(self) -> AsyncIterator[AsyncPager[T, R]]:+ page: Optional[AsyncPager[T, R]] = self+ while page is not None:+ yield page++ if not page.has_next or page.get_next is None:+ return++ page = await page.get_next()+ if page is None or page.items is None or len(page.items) == 0:+ return++ async def next_page(self) -> Optional[AsyncPager[T, R]]:+ return await self.get_next() if self.get_next is not None else Nonediff --git a/python/trueforge_sdk/src/trueforge_sdk/core/parse_error.py b/python/trueforge_sdk/src/trueforge_sdk/core/parse_error.pynew file mode 100644index 000000000..4527c6a8a--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/core/parse_error.py@@ -0,0 +1,36 @@+# This file was auto-generated by Fern from our API Definition.++from typing import Any, Dict, Optional+++class ParsingError(Exception):+ """+ Raised when the SDK fails to parse/validate a response from the server.+ This typically indicates that the server returned a response whose shape+ does not match the expected schema.+ """++ headers: Optional[Dict[str, str]]+ status_code: Optional[int]+ body: Any+ cause: Optional[Exception]++ def __init__(+ self,+ *,+ headers: Optional[Dict[str, str]] = None,+ status_code: Optional[int] = None,+ body: Any = None,+ cause: Optional[Exception] = None,+ ) -> None:+ self.headers = headers+ self.status_code = status_code+ self.body = body+ self.cause = cause+ super().__init__()+ if cause is not None:+ self.__cause__ = cause++ def __str__(self) -> str:+ cause_str = f", cause: {self.cause}" if self.cause is not None else ""+ return f"headers: {self.headers}, status_code: {self.status_code}, body: {self.body}{cause_str}"diff --git a/python/trueforge_sdk/src/trueforge_sdk/core/pydantic_utilities.py b/python/trueforge_sdk/src/trueforge_sdk/core/pydantic_utilities.pynew file mode 100644index 000000000..6587f5e18--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/core/pydantic_utilities.py@@ -0,0 +1,508 @@+# This file was auto-generated by Fern from our API Definition.++# nopycln: file+import datetime as dt+import inspect+import json+import logging+from collections import defaultdict+from dataclasses import asdict+from typing import (+ TYPE_CHECKING,+ Any,+ Callable,+ ClassVar,+ Dict,+ List,+ Mapping,+ Optional,+ Set,+ Tuple,+ Type,+ TypeVar,+ Union,+ cast,+)++import pydantic+import typing_extensions+from pydantic.fields import FieldInfo as _FieldInfo++_logger = logging.getLogger(__name__)++if TYPE_CHECKING:+ from .http_sse._models import ServerSentEvent++IS_PYDANTIC_V2 = pydantic.VERSION.startswith("2.")++if IS_PYDANTIC_V2:+ _datetime_adapter = pydantic.TypeAdapter(dt.datetime) # type: ignore[attr-defined]+ _date_adapter = pydantic.TypeAdapter(dt.date) # type: ignore[attr-defined]++ def parse_datetime(value: Any) -> dt.datetime: # type: ignore[misc]+ if isinstance(value, dt.datetime):+ return value+ return _datetime_adapter.validate_python(value)++ def parse_date(value: Any) -> dt.date: # type: ignore[misc]+ if isinstance(value, dt.datetime):+ return value.date()+ if isinstance(value, dt.date):+ return value+ return _date_adapter.validate_python(value)++ # Avoid importing from pydantic.v1 to maintain Python 3.14 compatibility.+ from typing import get_args as get_args # type: ignore[assignment]+ from typing import get_origin as get_origin # type: ignore[assignment]++ def is_literal_type(tp: Optional[Type[Any]]) -> bool: # type: ignore[misc]+ return typing_extensions.get_origin(tp) is typing_extensions.Literal++ def is_union(tp: Optional[Type[Any]]) -> bool: # type: ignore[misc]+ return tp is Union or typing_extensions.get_origin(tp) is Union # type: ignore[comparison-overlap]++ # Inline encoders_by_type to avoid importing from pydantic.v1.json+ import re as _re+ from collections import deque as _deque+ from decimal import Decimal as _Decimal+ from enum import Enum as _Enum+ from ipaddress import (+ IPv4Address as _IPv4Address,+ )+ from ipaddress import (+ IPv4Interface as _IPv4Interface,+ )+ from ipaddress import (+ IPv4Network as _IPv4Network,+ )+ from ipaddress import (+ IPv6Address as _IPv6Address,+ )+ from ipaddress import (+ IPv6Interface as _IPv6Interface,+ )+ from ipaddress import (+ IPv6Network as _IPv6Network,+ )+ from pathlib import Path as _Path+ from types import GeneratorType as _GeneratorType+ from uuid import UUID as _UUID++ from pydantic.fields import FieldInfo as ModelField # type: ignore[no-redef, assignment]++ def _decimal_encoder(dec_value: Any) -> Any:+ if dec_value.as_tuple().exponent >= 0:+ return int(dec_value)+ return float(dec_value)++ encoders_by_type: Dict[Type[Any], Callable[[Any], Any]] = { # type: ignore[no-redef]+ bytes: lambda o: o.decode(),+ dt.date: lambda o: o.isoformat(),+ dt.datetime: lambda o: o.isoformat(),+ dt.time: lambda o: o.isoformat(),+ dt.timedelta: lambda td: td.total_seconds(),+ _Decimal: _decimal_encoder,+ _Enum: lambda o: o.value,+ frozenset: list,+ _deque: list,+ _GeneratorType: list,+ _IPv4Address: str,+ _IPv4Interface: str,+ _IPv4Network: str,+ _IPv6Address: str,+ _IPv6Interface: str,+ _IPv6Network: str,+ _Path: str,+ _re.Pattern: lambda o: o.pattern,+ set: list,+ _UUID: str,+ }+else:+ from pydantic.datetime_parse import parse_date as parse_date # type: ignore[no-redef]+ from pydantic.datetime_parse import parse_datetime as parse_datetime # type: ignore[no-redef]+ from pydantic.fields import ModelField as ModelField # type: ignore[attr-defined, no-redef, assignment]+ from pydantic.json import ENCODERS_BY_TYPE as encoders_by_type # type: ignore[no-redef]+ from pydantic.typing import get_args as get_args # type: ignore[no-redef]+ from pydantic.typing import get_origin as get_origin # type: ignore[no-redef]+ from pydantic.typing import is_literal_type as is_literal_type # type: ignore[no-redef, assignment]+ from pydantic.typing import is_union as is_union # type: ignore[no-redef]++from .datetime_utils import serialize_datetime+from .serialization import convert_and_respect_annotation_metadata+from typing_extensions import TypeAlias++T = TypeVar("T")+Model = TypeVar("Model", bound=pydantic.BaseModel)+++def parse_sse_obj(sse: "ServerSentEvent", type_: Type[T]) -> T:+ """+ Parse a ServerSentEvent into the appropriate type.++ This function handles data-level discrimination where the discriminator+ (e.g., 'type') is inside the 'data' payload. It parses the SSE data field+ as JSON and deserializes it into the target type.++ Note: Protocol-level discrimination (where the discriminator comes from+ the SSE event: field) is handled at code-generation time and does not+ use this function.++ Args:+ sse: The ServerSentEvent object to parse+ type_: The target type to deserialize into++ Returns:+ The parsed object of type T++ Note:+ This function is only available in SDK contexts where http_sse module exists.+ """+ sse_event = asdict(sse)+ data_value = sse_event.get("data")+ if isinstance(data_value, str) and data_value:+ try:+ parsed_data = json.loads(data_value)+ return parse_obj_as(type_, parsed_data)+ except json.JSONDecodeError as e:+ _logger.warning(+ "Failed to parse SSE data field as JSON: %s, data: %s",+ e,+ data_value[:100] if len(data_value) > 100 else data_value,+ )+ return parse_obj_as(type_, sse_event)+++_type_adapter_cache: Dict[int, Any] = {}+++def _get_type_adapter(type_: Type[Any]) -> Any:+ key = id(type_)+ adapter = _type_adapter_cache.get(key)+ if adapter is None:+ adapter = pydantic.TypeAdapter(type_) # type: ignore[attr-defined]+ _type_adapter_cache[key] = adapter+ return adapter+++def parse_obj_as(type_: Type[T], object_: Any) -> T:+ # convert_and_respect_annotation_metadata is required for TypedDict aliasing.+ #+ # For Pydantic models, whether we should pre-dealias depends on how the model encodes aliasing:+ # - If the model uses real Pydantic aliases (pydantic.Field(alias=...)), then we must pass wire keys through+ # unchanged so Pydantic can validate them.+ # - If the model encodes aliasing only via FieldMetadata annotations, then we MUST pre-dealias because Pydantic+ # will not recognize those aliases during validation.+ if inspect.isclass(type_) and issubclass(type_, pydantic.BaseModel):+ has_pydantic_aliases = False+ if IS_PYDANTIC_V2:+ for field_name, field_info in getattr(type_, "model_fields", {}).items(): # type: ignore[attr-defined]+ alias = getattr(field_info, "alias", None)+ if alias is not None and alias != field_name:+ has_pydantic_aliases = True+ break+ else:+ for field in getattr(type_, "__fields__", {}).values():+ alias = getattr(field, "alias", None)+ name = getattr(field, "name", None)+ if alias is not None and name is not None and alias != name:+ has_pydantic_aliases = True+ break++ dealiased_object = (+ object_+ if has_pydantic_aliases+ else convert_and_respect_annotation_metadata(object_=object_, annotation=type_, direction="read")+ )+ else:+ dealiased_object = convert_and_respect_annotation_metadata(object_=object_, annotation=type_, direction="read")+ if IS_PYDANTIC_V2:+ adapter = _get_type_adapter(type_)+ return adapter.validate_python(dealiased_object) # type: ignore[no-any-return]+ return pydantic.parse_obj_as(type_, dealiased_object)+++def to_jsonable_with_fallback(obj: Any, fallback_serializer: Callable[[Any], Any]) -> Any:+ if IS_PYDANTIC_V2:+ from pydantic_core import to_jsonable_python++ return to_jsonable_python(obj, fallback=fallback_serializer)+ return fallback_serializer(obj)+++class UniversalBaseModel(pydantic.BaseModel):+ if IS_PYDANTIC_V2:+ model_config: ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict( # type: ignore[typeddict-unknown-key]+ # Allow fields beginning with `model_` to be used in the model+ protected_namespaces=(),+ )++ @pydantic.model_validator(mode="before") # type: ignore[attr-defined]+ @classmethod+ def _coerce_field_names_to_aliases(cls, data: Any) -> Any:+ """+ Accept Python field names in input by rewriting them to their Pydantic aliases,+ while avoiding silent collisions when a key could refer to multiple fields.+ """+ if not isinstance(data, Mapping):+ return data++ fields = getattr(cls, "model_fields", {}) # type: ignore[attr-defined]+ name_to_alias: Dict[str, str] = {}+ alias_to_name: Dict[str, str] = {}++ for name, field_info in fields.items():+ alias = getattr(field_info, "alias", None) or name+ name_to_alias[name] = alias+ if alias != name:+ alias_to_name[alias] = name++ # Detect ambiguous keys: a key that is an alias for one field and a name for another.+ ambiguous_keys = set(alias_to_name.keys()).intersection(set(name_to_alias.keys()))+ for key in ambiguous_keys:+ if key in data and name_to_alias[key] not in data:+ raise ValueError(+ f"Ambiguous input key '{key}': it is both a field name and an alias. "+ "Provide the explicit alias key to disambiguate."+ )++ original_keys = set(data.keys())+ rewritten: Dict[str, Any] = dict(data)+ for name, alias in name_to_alias.items():+ if alias != name and name in original_keys and alias not in rewritten:+ rewritten[alias] = rewritten.pop(name)++ return rewritten++ @pydantic.model_serializer(mode="plain", when_used="json") # type: ignore[attr-defined]+ def serialize_model(self) -> Any: # type: ignore[name-defined]+ serialized = self.dict() # type: ignore[attr-defined]+ data = {k: serialize_datetime(v) if isinstance(v, dt.datetime) else v for k, v in serialized.items()}+ return data++ else:++ class Config:+ smart_union = True+ json_encoders = {dt.datetime: serialize_datetime}++ @pydantic.root_validator(pre=True)+ def _coerce_field_names_to_aliases(cls, values: Any) -> Any:+ """+ Pydantic v1 equivalent of _coerce_field_names_to_aliases.+ """+ if not isinstance(values, Mapping):+ return values++ fields = getattr(cls, "__fields__", {})+ name_to_alias: Dict[str, str] = {}+ alias_to_name: Dict[str, str] = {}++ for name, field in fields.items():+ alias = getattr(field, "alias", None) or name+ name_to_alias[name] = alias+ if alias != name:+ alias_to_name[alias] = name++ ambiguous_keys = set(alias_to_name.keys()).intersection(set(name_to_alias.keys()))+ for key in ambiguous_keys:+ if key in values and name_to_alias[key] not in values:+ raise ValueError(+ f"Ambiguous input key '{key}': it is both a field name and an alias. "+ "Provide the explicit alias key to disambiguate."+ )++ original_keys = set(values.keys())+ rewritten: Dict[str, Any] = dict(values)+ for name, alias in name_to_alias.items():+ if alias != name and name in original_keys and alias not in rewritten:+ rewritten[alias] = rewritten.pop(name)++ return rewritten++ @classmethod+ def model_construct(cls: Type["Model"], _fields_set: Optional[Set[str]] = None, **values: Any) -> "Model":+ dealiased_object = convert_and_respect_annotation_metadata(object_=values, annotation=cls, direction="read")+ return cls.construct(_fields_set, **dealiased_object)++ @classmethod+ def construct(cls: Type["Model"], _fields_set: Optional[Set[str]] = None, **values: Any) -> "Model":+ dealiased_object = convert_and_respect_annotation_metadata(object_=values, annotation=cls, direction="read")+ if IS_PYDANTIC_V2:+ return super().model_construct(_fields_set, **dealiased_object) # type: ignore[misc]+ return super().construct(_fields_set, **dealiased_object)++ def json(self, **kwargs: Any) -> str:+ kwargs_with_defaults = {+ "by_alias": True,+ "exclude_unset": True,+ **kwargs,+ }+ if IS_PYDANTIC_V2:+ return super().model_dump_json(**kwargs_with_defaults) # type: ignore[misc]+ return super().json(**kwargs_with_defaults)++ def dict(self, **kwargs: Any) -> Dict[str, Any]:+ """+ Override the default dict method to `exclude_unset` by default. This function patches+ `exclude_unset` to work include fields within non-None default values.+ """+ # Note: the logic here is multiplexed given the levers exposed in Pydantic V1 vs V2+ # Pydantic V1's .dict can be extremely slow, so we do not want to call it twice.+ #+ # We'd ideally do the same for Pydantic V2, but it shells out to a library to serialize models+ # that we have less control over, and this is less intrusive than custom serializers for now.+ if IS_PYDANTIC_V2:+ kwargs_with_defaults_exclude_unset = {+ **kwargs,+ "by_alias": True,+ "exclude_unset": True,+ "exclude_none": False,+ }+ kwargs_with_defaults_exclude_none = {+ **kwargs,+ "by_alias": True,+ "exclude_none": True,+ "exclude_unset": False,+ }+ dict_dump = deep_union_pydantic_dicts(+ super().model_dump(**kwargs_with_defaults_exclude_unset), # type: ignore[misc]+ super().model_dump(**kwargs_with_defaults_exclude_none), # type: ignore[misc]+ )++ else:+ _fields_set = self.__fields_set__.copy()++ fields = _get_model_fields(self.__class__)+ for name, field in fields.items():+ if name not in _fields_set:+ default = _get_field_default(field)++ # If the default values are non-null act like they've been set+ # This effectively allows exclude_unset to work like exclude_none where+ # the latter passes through intentionally set none values.+ if default is not None or ("exclude_unset" in kwargs and not kwargs["exclude_unset"]):+ _fields_set.add(name)++ if default is not None:+ self.__fields_set__.add(name)++ kwargs_with_defaults_exclude_unset_include_fields = {+ "by_alias": True,+ "exclude_unset": True,+ "include": _fields_set,+ **kwargs,+ }++ dict_dump = super().dict(**kwargs_with_defaults_exclude_unset_include_fields)++ return cast(+ Dict[str, Any],+ convert_and_respect_annotation_metadata(object_=dict_dump, annotation=self.__class__, direction="write"),+ )+++def _union_list_of_pydantic_dicts(source: List[Any], destination: List[Any]) -> List[Any]:+ converted_list: List[Any] = []+ for i, item in enumerate(source):+ destination_value = destination[i]+ if isinstance(item, dict):+ converted_list.append(deep_union_pydantic_dicts(item, destination_value))+ elif isinstance(item, list):+ converted_list.append(_union_list_of_pydantic_dicts(item, destination_value))+ else:+ converted_list.append(item)+ return converted_list+++def deep_union_pydantic_dicts(source: Dict[str, Any], destination: Dict[str, Any]) -> Dict[str, Any]:+ for key, value in source.items():+ node = destination.setdefault(key, {})+ if isinstance(value, dict):+ deep_union_pydantic_dicts(value, node)+ # Note: we do not do this same processing for sets given we do not have sets of models+ # and given the sets are unordered, the processing of the set and matching objects would+ # be non-trivial.+ elif isinstance(value, list):+ destination[key] = _union_list_of_pydantic_dicts(value, node)+ else:+ destination[key] = value++ return destination+++if IS_PYDANTIC_V2:++ class V2RootModel(UniversalBaseModel, pydantic.RootModel): # type: ignore[misc, name-defined, type-arg]+ pass++ UniversalRootModel: TypeAlias = V2RootModel # type: ignore[misc]+else:+ UniversalRootModel: TypeAlias = UniversalBaseModel # type: ignore[misc, no-redef]+++def encode_by_type(o: Any) -> Any:+ encoders_by_class_tuples: Dict[Callable[[Any], Any], Tuple[Any, ...]] = defaultdict(tuple)+ for type_, encoder in encoders_by_type.items():+ encoders_by_class_tuples[encoder] += (type_,)++ if type(o) in encoders_by_type:+ return encoders_by_type[type(o)](o)+ for encoder, classes_tuple in encoders_by_class_tuples.items():+ if isinstance(o, classes_tuple):+ return encoder(o)+++def update_forward_refs(model: Type["Model"], **localns: Any) -> None:+ if IS_PYDANTIC_V2:+ model.model_rebuild(raise_errors=False) # type: ignore[attr-defined]+ else:+ model.update_forward_refs(**localns)+++# Mirrors Pydantic's internal typing+AnyCallable = Callable[..., Any]+++def universal_root_validator(+ pre: bool = False,+) -> Callable[[AnyCallable], AnyCallable]:+ def decorator(func: AnyCallable) -> AnyCallable:+ if IS_PYDANTIC_V2:+ # In Pydantic v2, for RootModel we always use "before" mode+ # The custom validators transform the input value before the model is created+ return cast(AnyCallable, pydantic.model_validator(mode="before")(func)) # type: ignore[attr-defined]+ return cast(AnyCallable, pydantic.root_validator(pre=pre)(func)) # type: ignore[call-overload]++ return decorator+++def universal_field_validator(field_name: str, pre: bool = False) -> Callable[[AnyCallable], AnyCallable]:+ def decorator(func: AnyCallable) -> AnyCallable:+ if IS_PYDANTIC_V2:+ return cast(AnyCallable, pydantic.field_validator(field_name, mode="before" if pre else "after")(func)) # type: ignore[attr-defined]+ return cast(AnyCallable, pydantic.validator(field_name, pre=pre)(func))++ return decorator+++PydanticField = Union[ModelField, _FieldInfo]+++def _get_model_fields(model: Type["Model"]) -> Mapping[str, PydanticField]:+ if IS_PYDANTIC_V2:+ return cast(Mapping[str, PydanticField], model.model_fields) # type: ignore[attr-defined]+ return cast(Mapping[str, PydanticField], model.__fields__)+++def _get_field_default(field: PydanticField) -> Any:+ try:+ value = field.get_default() # type: ignore[union-attr]+ except:+ value = field.default+ if IS_PYDANTIC_V2:+ from pydantic_core import PydanticUndefined++ if value == PydanticUndefined:+ return None+ return value+ return valuediff --git a/python/trueforge_sdk/src/trueforge_sdk/core/query_encoder.py b/python/trueforge_sdk/src/trueforge_sdk/core/query_encoder.pynew file mode 100644index 000000000..3183001d4--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/core/query_encoder.py@@ -0,0 +1,58 @@+# This file was auto-generated by Fern from our API Definition.++from typing import Any, Dict, List, Optional, Tuple++import pydantic+++# Flattens dicts to be of the form {"key[subkey][subkey2]": value} where value is not a dict+def traverse_query_dict(dict_flat: Dict[str, Any], key_prefix: Optional[str] = None) -> List[Tuple[str, Any]]:+ result = []+ for k, v in dict_flat.items():+ key = f"{key_prefix}[{k}]" if key_prefix is not None else k+ if isinstance(v, dict):+ result.extend(traverse_query_dict(v, key))+ elif isinstance(v, list):+ for arr_v in v:+ if isinstance(arr_v, dict):+ result.extend(traverse_query_dict(arr_v, key))+ else:+ result.append((key, arr_v))+ else:+ result.append((key, v))+ return result+++def single_query_encoder(query_key: str, query_value: Any) -> List[Tuple[str, Any]]:+ if isinstance(query_value, pydantic.BaseModel) or isinstance(query_value, dict):+ if isinstance(query_value, pydantic.BaseModel):+ obj_dict = query_value.dict(by_alias=True)+ else:+ obj_dict = query_value+ return traverse_query_dict(obj_dict, query_key)+ elif isinstance(query_value, list):+ encoded_values: List[Tuple[str, Any]] = []+ for value in query_value:+ if isinstance(value, pydantic.BaseModel) or isinstance(value, dict):+ if isinstance(value, pydantic.BaseModel):+ obj_dict = value.dict(by_alias=True)+ elif isinstance(value, dict):+ obj_dict = value++ encoded_values.extend(single_query_encoder(query_key, obj_dict))+ else:+ encoded_values.append((query_key, value))++ return encoded_values++ return [(query_key, query_value)]+++def encode_query(query: Optional[Dict[str, Any]]) -> Optional[List[Tuple[str, Any]]]:+ if query is None:+ return None++ encoded_query = []+ for k, v in query.items():+ encoded_query.extend(single_query_encoder(k, v))+ return encoded_querydiff --git a/python/trueforge_sdk/src/trueforge_sdk/core/remove_none_from_dict.py b/python/trueforge_sdk/src/trueforge_sdk/core/remove_none_from_dict.pynew file mode 100644index 000000000..c2298143f--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/core/remove_none_from_dict.py@@ -0,0 +1,11 @@+# This file was auto-generated by Fern from our API Definition.++from typing import Any, Dict, Mapping, Optional+++def remove_none_from_dict(original: Mapping[str, Optional[Any]]) -> Dict[str, Any]:+ new: Dict[str, Any] = {}+ for key, value in original.items():+ if value is not None:+ new[key] = value+ return newdiff --git a/python/trueforge_sdk/src/trueforge_sdk/core/request_options.py b/python/trueforge_sdk/src/trueforge_sdk/core/request_options.pynew file mode 100644index 000000000..caa6f669b--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/core/request_options.py@@ -0,0 +1,40 @@+# This file was auto-generated by Fern from our API Definition.++import typing++try:+ from typing import NotRequired # type: ignore+except ImportError:+ from typing_extensions import NotRequired+++class RequestOptions(typing.TypedDict, total=False):+ """+ Additional options for request-specific configuration when calling APIs via the SDK.+ This is used primarily as an optional final parameter for service functions.++ Attributes:+ - timeout: float. The number of seconds to await an API call before timing out.++ - timeout_in_seconds: int. Deprecated alias for `timeout`; both are in seconds. Prefer `timeout`.++ - max_retries: int. The max number of retries to attempt if the API call fails.++ - additional_headers: typing.Dict[str, typing.Any]. A dictionary containing additional parameters to spread into the request's header dict++ - additional_query_parameters: typing.Dict[str, typing.Any]. A dictionary containing additional parameters to spread into the request's query parameters dict++ - additional_body_parameters: typing.Dict[str, typing.Any]. A dictionary containing additional parameters to spread into the request's body parameters dict++ - chunk_size: int. The size, in bytes, to process each chunk of data being streamed back within the response. This equates to leveraging `chunk_size` within `requests` or `httpx`, and is only leveraged for file downloads.+ """++ timeout: NotRequired[float]+ timeout_in_seconds: NotRequired[int]+ max_retries: NotRequired[int]+ additional_headers: NotRequired[typing.Dict[str, typing.Any]]+ additional_query_parameters: NotRequired[typing.Dict[str, typing.Any]]+ additional_body_parameters: NotRequired[typing.Dict[str, typing.Any]]+ chunk_size: NotRequired[int]+ stream_reconnection_enabled: NotRequired[bool]+ max_stream_reconnection_attempts: NotRequired[int]diff --git a/python/trueforge_sdk/src/trueforge_sdk/core/serialization.py b/python/trueforge_sdk/src/trueforge_sdk/core/serialization.pynew file mode 100644index 000000000..1d753e26f--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/core/serialization.py@@ -0,0 +1,347 @@+# This file was auto-generated by Fern from our API Definition.++import collections+import inspect+import typing++import pydantic+import typing_extensions+++class FieldMetadata:+ """+ Metadata class used to annotate fields to provide additional information.++ Example:+ class MyDict(TypedDict):+ field: typing.Annotated[str, FieldMetadata(alias="field_name")]++ Will serialize: `{"field": "value"}`+ To: `{"field_name": "value"}`+ """++ alias: str++ def __init__(self, *, alias: str) -> None:+ self.alias = alias+++# Resolving type hints (typing.get_type_hints) is expensive because it eval/compiles+# forward-reference annotations. The result is constant for a given type, so we cache it.+# This is critical for hot paths like SSE event parsing, where the same (often large+# discriminated-union) type is converted on every single event.+_type_hints_cache: typing.Dict[typing.Any, typing.Dict[str, typing.Any]] = {}+++def _get_cached_type_hints(expected_type: typing.Any) -> typing.Dict[str, typing.Any]:+ try:+ cached = _type_hints_cache.get(expected_type)+ except TypeError:+ # Unhashable type; resolve without caching.+ return _resolve_type_hints(expected_type)+ if cached is None:+ cached = _resolve_type_hints(expected_type)+ _type_hints_cache[expected_type] = cached+ return cached+++def _resolve_type_hints(expected_type: typing.Any) -> typing.Dict[str, typing.Any]:+ try:+ return typing_extensions.get_type_hints(expected_type, include_extras=True)+ except NameError:+ # The type contains a circular reference, so we use the __annotations__ attribute directly.+ return getattr(expected_type, "__annotations__", {})+++# Whether convert_and_respect_annotation_metadata can possibly rewrite anything for a given+# annotation, i.e. whether any reachable model/TypedDict field carries a FieldMetadata alias.+# This is constant per type, so we cache it and use it to short-circuit the recursive walk.+_requires_conversion_cache: typing.Dict[typing.Any, bool] = {}+++def _requires_conversion(type_: typing.Any) -> bool:+ try:+ cached = _requires_conversion_cache.get(type_)+ except TypeError:+ # Unhashable annotation; compute without caching.+ return _compute_requires_conversion(type_, set())+ if cached is None:+ cached = _compute_requires_conversion(type_, set())+ _requires_conversion_cache[type_] = cached+ return cached+++def _compute_requires_conversion(type_: typing.Any, seen: typing.Set[typing.Any]) -> bool:+ clean_type = _remove_annotations(type_)++ try:+ if clean_type in seen:+ return False+ seen = seen | {clean_type}+ except TypeError:+ # Unhashable type; skip cycle tracking (the type graph is finite in practice).+ pass++ # Models / TypedDicts: a field alias here means we must dealias; otherwise recurse into fields.+ if (inspect.isclass(clean_type) and issubclass(clean_type, pydantic.BaseModel)) or typing_extensions.is_typeddict(+ clean_type+ ):+ annotations = _get_cached_type_hints(clean_type)+ if _get_alias_to_field_name(annotations):+ return True+ return any(_compute_requires_conversion(hint, seen) for hint in annotations.values())++ # Containers / unions: recurse into the type arguments (List/Set/Sequence/Dict/Union/etc.).+ return any(_compute_requires_conversion(arg, seen) for arg in typing_extensions.get_args(clean_type))+++def convert_and_respect_annotation_metadata(+ *,+ object_: typing.Any,+ annotation: typing.Any,+ inner_type: typing.Optional[typing.Any] = None,+ direction: typing.Literal["read", "write"],+) -> typing.Any:+ """+ Respect the metadata annotations on a field, such as aliasing. This function effectively+ manipulates the dict-form of an object to respect the metadata annotations. This is primarily used for+ TypedDicts, which cannot support aliasing out of the box, and can be extended for additional+ utilities, such as defaults.++ Parameters+ ----------+ object_ : typing.Any++ annotation : type+ The type we're looking to apply typing annotations from++ inner_type : typing.Optional[type]++ Returns+ -------+ typing.Any+ """++ if object_ is None:+ return None+ if inner_type is None:+ inner_type = annotation+ # The only thing this function ever rewrites is keys that carry a FieldMetadata+ # alias. If nothing in the (cached) type graph has such an alias, the conversion is+ # a content-identity transform, so we can skip the entire recursive walk. This is+ # the hot path for SSE streaming, where a large discriminated union would otherwise+ # be traversed on every single event.+ if not _requires_conversion(annotation):+ return object_++ clean_type = _remove_annotations(inner_type)+ # Pydantic models+ if (+ inspect.isclass(clean_type)+ and issubclass(clean_type, pydantic.BaseModel)+ and isinstance(object_, typing.Mapping)+ ):+ return _convert_mapping(object_, clean_type, direction)+ # TypedDicts+ if typing_extensions.is_typeddict(clean_type) and isinstance(object_, typing.Mapping):+ return _convert_mapping(object_, clean_type, direction)++ if (+ typing_extensions.get_origin(clean_type) == typing.Dict+ or typing_extensions.get_origin(clean_type) == dict+ or clean_type == typing.Dict+ ) and isinstance(object_, typing.Dict):+ key_type = typing_extensions.get_args(clean_type)[0]+ value_type = typing_extensions.get_args(clean_type)[1]++ return {+ key: convert_and_respect_annotation_metadata(+ object_=value,+ annotation=annotation,+ inner_type=value_type,+ direction=direction,+ )+ for key, value in object_.items()+ }++ # If you're iterating on a string, do not bother to coerce it to a sequence.+ if not isinstance(object_, str):+ if (+ typing_extensions.get_origin(clean_type) == typing.Set+ or typing_extensions.get_origin(clean_type) == set+ or clean_type == typing.Set+ ) and isinstance(object_, typing.Set):+ inner_type = typing_extensions.get_args(clean_type)[0]+ return {+ convert_and_respect_annotation_metadata(+ object_=item,+ annotation=annotation,+ inner_type=inner_type,+ direction=direction,+ )+ for item in object_+ }+ elif (+ (+ typing_extensions.get_origin(clean_type) == typing.List+ or typing_extensions.get_origin(clean_type) == list+ or clean_type == typing.List+ )+ and isinstance(object_, typing.List)+ ) or (+ (+ typing_extensions.get_origin(clean_type) == typing.Sequence+ or typing_extensions.get_origin(clean_type) == collections.abc.Sequence+ or clean_type == typing.Sequence+ )+ and isinstance(object_, typing.Sequence)+ ):+ inner_type = typing_extensions.get_args(clean_type)[0]+ return [+ convert_and_respect_annotation_metadata(+ object_=item,+ annotation=annotation,+ inner_type=inner_type,+ direction=direction,+ )+ for item in object_+ ]++ if typing_extensions.get_origin(clean_type) == typing.Union:+ # We should be able to ~relatively~ safely try to convert keys against all+ # member types in the union, the edge case here is if one member aliases a field+ # of the same name to a different name from another member+ # Or if another member aliases a field of the same name that another member does not.+ for member in typing_extensions.get_args(clean_type):+ object_ = convert_and_respect_annotation_metadata(+ object_=object_,+ annotation=annotation,+ inner_type=member,+ direction=direction,+ )+ return object_++ annotated_type = _get_annotation(annotation)+ if annotated_type is None:+ return object_++ # If the object is not a TypedDict, a Union, or other container (list, set, sequence, etc.)+ # Then we can safely call it on the recursive conversion.+ return object_+++def _convert_mapping(+ object_: typing.Mapping[str, object],+ expected_type: typing.Any,+ direction: typing.Literal["read", "write"],+) -> typing.Mapping[str, object]:+ converted_object: typing.Dict[str, object] = {}+ annotations = _get_cached_type_hints(expected_type)+ aliases_to_field_names = _get_alias_to_field_name(annotations)+ for key, value in object_.items():+ if direction == "read" and key in aliases_to_field_names:+ dealiased_key = aliases_to_field_names.get(key)+ if dealiased_key is not None:+ type_ = annotations.get(dealiased_key)+ else:+ type_ = annotations.get(key)+ # Note you can't get the annotation by the field name if you're in read mode, so you must check the aliases map+ #+ # So this is effectively saying if we're in write mode, and we don't have a type, or if we're in read mode and we don't have an alias+ # then we can just pass the value through as is+ if type_ is None:+ converted_object[key] = value+ elif direction == "read" and key not in aliases_to_field_names:+ converted_object[key] = convert_and_respect_annotation_metadata(+ object_=value, annotation=type_, direction=direction+ )+ else:+ converted_object[_alias_key(key, type_, direction, aliases_to_field_names)] = (+ convert_and_respect_annotation_metadata(object_=value, annotation=type_, direction=direction)+ )+ return converted_object+++def _get_annotation(type_: typing.Any) -> typing.Optional[typing.Any]:+ maybe_annotated_type = typing_extensions.get_origin(type_)+ if maybe_annotated_type is None:+ return None++ if maybe_annotated_type == typing_extensions.NotRequired:+ type_ = typing_extensions.get_args(type_)[0]+ maybe_annotated_type = typing_extensions.get_origin(type_)++ if maybe_annotated_type == typing_extensions.Annotated:+ return type_++ return None+++def _remove_annotations(type_: typing.Any) -> typing.Any:+ maybe_annotated_type = typing_extensions.get_origin(type_)+ if maybe_annotated_type is None:+ return type_++ if maybe_annotated_type == typing_extensions.NotRequired:+ return _remove_annotations(typing_extensions.get_args(type_)[0])++ if maybe_annotated_type == typing_extensions.Annotated:+ return _remove_annotations(typing_extensions.get_args(type_)[0])++ return type_+++def get_alias_to_field_mapping(type_: typing.Any) -> typing.Dict[str, str]:+ annotations = _get_cached_type_hints(type_)+ return _get_alias_to_field_name(annotations)+++def get_field_to_alias_mapping(type_: typing.Any) -> typing.Dict[str, str]:+ annotations = _get_cached_type_hints(type_)+ return _get_field_to_alias_name(annotations)+++def _get_alias_to_field_name(+ field_to_hint: typing.Dict[str, typing.Any],+) -> typing.Dict[str, str]:+ aliases = {}+ for field, hint in field_to_hint.items():+ maybe_alias = _get_alias_from_type(hint)+ if maybe_alias is not None:+ aliases[maybe_alias] = field+ return aliases+++def _get_field_to_alias_name(+ field_to_hint: typing.Dict[str, typing.Any],+) -> typing.Dict[str, str]:+ aliases = {}+ for field, hint in field_to_hint.items():+ maybe_alias = _get_alias_from_type(hint)+ if maybe_alias is not None:+ aliases[field] = maybe_alias+ return aliases+++def _get_alias_from_type(type_: typing.Any) -> typing.Optional[str]:+ maybe_annotated_type = _get_annotation(type_)++ if maybe_annotated_type is not None:+ # The actual annotations are 1 onward, the first is the annotated type+ annotations = typing_extensions.get_args(maybe_annotated_type)[1:]++ for annotation in annotations:+ if isinstance(annotation, FieldMetadata) and annotation.alias is not None:+ return annotation.alias+ return None+++def _alias_key(+ key: str,+ type_: typing.Any,+ direction: typing.Literal["read", "write"],+ aliases_to_field_names: typing.Dict[str, str],+) -> str:+ if direction == "read":+ return aliases_to_field_names.get(key, key)+ return _get_alias_from_type(type_=type_) or keydiff --git a/python/trueforge_sdk/src/trueforge_sdk/core/stream.py b/python/trueforge_sdk/src/trueforge_sdk/core/stream.pynew file mode 100644index 000000000..9d57e5ed0--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/core/stream.py@@ -0,0 +1,148 @@+# This file was auto-generated by Fern from our API Definition.++# This file was auto-generated by Fern from our API Definition.++import types+import typing+from dataclasses import dataclass++T = typing.TypeVar("T")+++@dataclass(frozen=True)+class StreamEvent(typing.Generic[T]):+ """A single event of a stream, exposing the server-sent event metadata alongside the parsed payload.++ `id`, `event` and `retry` are only populated for server-sent event streams; for JSON and text+ streams, which have no event metadata, they are always `None`.+ """++ data: T+ id: typing.Optional[str] = None+ event: typing.Optional[str] = None+ retry: typing.Optional[int] = None+++class Stream(typing.Generic[T]):+ """A stream of parsed events.++ Iterating the stream yields the parsed payloads, while `with_metadata()` yields them wrapped in a+ `StreamEvent`, which also exposes the server-sent event `id`, `event` and `retry` fields:++ for chunk in client.service.stream(...):+ ...++ for event in client.service.stream(...).with_metadata():+ print(event.id, event.data)++ The HTTP request is only issued once the stream is first iterated. The response is released when+ the stream is exhausted, when iterating raises, when `close()` is called, when the stream is used+ as a context manager, and when the stream is garbage collected (closing the stream closes the+ underlying generator, which in turn closes the response).+ """++ def __init__(self, *, events: typing.Callable[[], typing.Generator[StreamEvent[T], None, None]]):+ self._open_events = events+ self._events: typing.Optional[typing.Generator[StreamEvent[T], None, None]] = None+ self._closed = False++ def with_metadata(self) -> typing.Iterator[StreamEvent[T]]:+ return self._events_generator()++ def close(self) -> None:+ self._closed = True+ events = self._events+ self._events = None+ if events is not None:+ events.close()++ def __iter__(self) -> "Stream[T]":+ return self++ def __next__(self) -> T:+ return next(self._events_generator()).data++ def __enter__(self) -> "Stream[T]":+ return self++ def __exit__(+ self,+ exc_type: typing.Optional[typing.Type[BaseException]],+ exc_value: typing.Optional[BaseException],+ traceback: typing.Optional[types.TracebackType],+ ) -> None:+ self.close()++ def _events_generator(self) -> typing.Generator[StreamEvent[T], None, None]:+ if self._closed:+ raise RuntimeError("The stream has already been closed.")+ if self._events is None:+ self._events = self._open_events()+ return self._events+++class AsyncStream(typing.Generic[T]):+ """An asynchronous stream of parsed events.++ Iterating the stream yields the parsed payloads, while `with_metadata()` yields them wrapped in a+ `StreamEvent`, which also exposes the server-sent event `id`, `event` and `retry` fields:++ async for chunk in client.service.stream(...):+ ...++ async for event in (await client.service.stream(...)).with_metadata():+ print(event.id, event.data)++ The HTTP request is only issued once the stream is first iterated. The response is released when+ the stream is exhausted, when iterating raises, when `close()` is called, when the stream is used+ as an asynchronous context manager, and when the event loop finalizes the underlying asynchronous+ generator.+ """++ def __init__(self, *, events: typing.Callable[[], typing.AsyncGenerator[StreamEvent[T], None]]):+ self._open_events = events+ self._events: typing.Optional[typing.AsyncGenerator[StreamEvent[T], None]] = None+ self._closed = False++ def with_metadata(self) -> typing.AsyncIterator[StreamEvent[T]]:+ return self._events_generator()++ async def close(self) -> None:+ self._closed = True+ events = self._events+ self._events = None+ if events is not None:+ await events.aclose()++ async def aclose(self) -> None:+ await self.close()++ def __aiter__(self) -> "AsyncStream[T]":+ return self++ async def __anext__(self) -> T:+ event = await self._events_generator().__anext__()+ return event.data++ async def __aenter__(self) -> "AsyncStream[T]":+ return self++ async def __aexit__(+ self,+ exc_type: typing.Optional[typing.Type[BaseException]],+ exc_value: typing.Optional[BaseException],+ traceback: typing.Optional[types.TracebackType],+ ) -> None:+ await self.close()++ def __await__(self) -> typing.Generator[None, None, "AsyncStream[T]"]:+ """Returns the stream itself, so that it can be awaited before being iterated."""+ yield from ()+ return self++ def _events_generator(self) -> typing.AsyncGenerator[StreamEvent[T], None]:+ if self._closed:+ raise RuntimeError("The stream has already been closed.")+ if self._events is None:+ self._events = self._open_events()+ return self._eventsdiff --git a/python/trueforge_sdk/src/trueforge_sdk/core/unchecked_base_model.py b/python/trueforge_sdk/src/trueforge_sdk/core/unchecked_base_model.pynew file mode 100644index 000000000..c5deec1f5--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/core/unchecked_base_model.py@@ -0,0 +1,494 @@+# This file was auto-generated by Fern from our API Definition.++import datetime as dt+import enum+import inspect+import sys+import typing+import uuid++import pydantic+import typing_extensions+from .pydantic_utilities import ( # type: ignore[attr-defined]+ IS_PYDANTIC_V2,+ ModelField,+ UniversalBaseModel,+ get_args,+ get_origin,+ is_literal_type,+ is_union,+ parse_date,+ parse_datetime,+ parse_obj_as,+)+from .serialization import get_field_to_alias_mapping+from pydantic_core import PydanticUndefined+++class UnionMetadata:+ discriminant: str++ def __init__(self, *, discriminant: str) -> None:+ self.discriminant = discriminant+++Model = typing.TypeVar("Model", bound=pydantic.BaseModel)+++def _maybe_resolve_forward_ref(+ type_: typing.Any,+ host: typing.Optional[typing.Type[typing.Any]],+) -> typing.Any:+ """Resolve a ForwardRef using the module where *host* is defined.++ Pydantic v2 + ``from __future__ import annotations`` can leave field+ annotations as ``list[ForwardRef('Block')]`` even after ``model_rebuild``.+ Without resolution, ``construct_type`` sees a ForwardRef (not a class) and+ skips recursive model construction, leaving nested data as raw dicts.+ """+ if host is None or not isinstance(type_, typing.ForwardRef):+ return type_+ mod = sys.modules.get(host.__module__)+ if mod is None:+ return type_+ try:+ return eval(type_.__forward_arg__, vars(mod))+ except Exception:+ return type_+++class UncheckedBaseModel(UniversalBaseModel):+ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ extra = pydantic.Extra.allow++ @classmethod+ def model_construct(+ cls: typing.Type["Model"],+ _fields_set: typing.Optional[typing.Set[str]] = None,+ **values: typing.Any,+ ) -> "Model":+ # Fallback construct function to the specified override below.+ return cls.construct(_fields_set=_fields_set, **values)++ # Allow construct to not validate model+ # Implementation taken from: https://github.com/pydantic/pydantic/issues/1168#issuecomment-817742836+ @classmethod+ def construct(+ cls: typing.Type["Model"],+ _fields_set: typing.Optional[typing.Set[str]] = None,+ **values: typing.Any,+ ) -> "Model":+ m = cls.__new__(cls)+ fields_values = {}++ if _fields_set is None:+ _fields_set = set(values.keys())++ fields = _get_model_fields(cls)+ populate_by_name = _get_is_populate_by_name(cls)+ field_aliases = get_field_to_alias_mapping(cls)++ for name, field in fields.items():+ # Key here is only used to pull data from the values dict+ # you should always use the NAME of the field to for field_values, etc.+ # because that's how the object is constructed from a pydantic perspective+ key = field.alias+ if (key is None or field.alias == name) and name in field_aliases:+ key = field_aliases[name]++ if key is None or (key not in values and populate_by_name): # Added this to allow population by field name+ key = name++ if key in values:+ if IS_PYDANTIC_V2:+ type_ = field.annotation # type: ignore # Pydantic v2+ else:+ type_ = typing.cast(typing.Type, field.outer_type_) # type: ignore # Pydantic < v1.10.15++ fields_values[name] = (+ construct_type(object_=values[key], type_=type_, host=cls) if type_ is not None else values[key]+ )+ _fields_set.add(name)+ else:+ default = _get_field_default(field)+ fields_values[name] = default++ # If the default values are non-null act like they've been set+ # This effectively allows exclude_unset to work like exclude_none where+ # the latter passes through intentionally set none values.+ if default != None and default != PydanticUndefined:+ _fields_set.add(name)++ # Add extras back in+ extras = {}+ pydantic_alias_fields = [field.alias for field in fields.values()]+ internal_alias_fields = list(field_aliases.values())+ for key, value in values.items():+ # If the key is not a field by name, nor an alias to a field, then it's extra+ if (key not in pydantic_alias_fields and key not in internal_alias_fields) and key not in fields:+ if IS_PYDANTIC_V2:+ extras[key] = value+ else:+ _fields_set.add(key)+ fields_values[key] = value++ object.__setattr__(m, "__dict__", fields_values)++ if IS_PYDANTIC_V2:+ object.__setattr__(m, "__pydantic_private__", None)+ object.__setattr__(m, "__pydantic_extra__", extras)+ object.__setattr__(m, "__pydantic_fields_set__", _fields_set)+ else:+ object.__setattr__(m, "__fields_set__", _fields_set)+ m._init_private_attributes() # type: ignore # Pydantic v1+ return m+++def _validate_collection_items_compatible(collection: typing.Any, target_type: typing.Type[typing.Any]) -> bool:+ """+ Validate that all items in a collection are compatible with the target type.++ Args:+ collection: The collection to validate (list, set, or dict values)+ target_type: The target type to validate against++ Returns:+ True if all items are compatible, False otherwise+ """+ if inspect.isclass(target_type) and issubclass(target_type, pydantic.BaseModel):+ for item in collection:+ try:+ # Try to validate the item against the target type+ if isinstance(item, dict):+ parse_obj_as(target_type, item)+ else:+ # If it's not a dict, it might already be the right type+ if not isinstance(item, target_type):+ return False+ except Exception:+ return False+ return True+++def _get_literal_field_value(+ inner_type: typing.Type[typing.Any], field_name: str, field: typing.Any, object_: typing.Any+) -> typing.Any:+ """Get the value of a Literal field from *object_*, checking both alias and field name."""+ name_or_alias = get_field_to_alias_mapping(inner_type).get(field_name, field_name)+ pydantic_alias = getattr(field, "alias", None)+ if isinstance(object_, dict):+ if name_or_alias in object_:+ return object_[name_or_alias]+ if pydantic_alias and pydantic_alias != name_or_alias and pydantic_alias in object_:+ return object_[pydantic_alias]+ return None+ return getattr(object_, name_or_alias, getattr(object_, pydantic_alias, None) if pydantic_alias else None)+++def _literal_fields_match_strict(inner_type: typing.Type[typing.Any], object_: typing.Any) -> bool:+ """Return True iff every Literal-typed field in *inner_type* is **present** in+ *object_* and its value equals the field's declared default.++ This prevents models whose fields are all optional (e.g. ``FigureDetails``)+ from vacuously matching inputs that don't carry the discriminant key at all+ (e.g. ``{}`` for text blocks). For types with no Literal fields this+ returns True unconditionally.+ """+ fields = _get_model_fields(inner_type)+ for field_name, field in fields.items():+ if IS_PYDANTIC_V2:+ field_type = field.annotation # type: ignore # Pydantic v2+ else:+ field_type = field.outer_type_ # type: ignore # Pydantic v1++ if is_literal_type(field_type): # type: ignore[arg-type]+ field_default = _get_field_default(field)+ object_value = _get_literal_field_value(inner_type, field_name, field, object_)+ if field_default != object_value:+ return False+ return True+++def _convert_undiscriminated_union_type(+ union_type: typing.Type[typing.Any],+ object_: typing.Any,+ host: typing.Optional[typing.Type[typing.Any]] = None,+) -> typing.Any:+ inner_types = get_args(union_type)+ if typing.Any in inner_types:+ return object_++ # When any union member carries a Literal discriminant field, require the+ # discriminant key to be present AND matching before accepting a candidate.+ # This prevents models with all-optional fields (e.g. FigureDetails) from+ # greedily matching inputs that belong to a different variant or to a+ # plain-dict fallback (e.g. EmptyBlockDetails = Dict[str, Any]).+ has_literal_discriminant = any(+ inspect.isclass(t)+ and issubclass(t, pydantic.BaseModel)+ and any(+ is_literal_type(+ f.annotation if IS_PYDANTIC_V2 else f.outer_type_ # type: ignore+ )+ for f in _get_model_fields(t).values()+ )+ for t in inner_types+ )++ for inner_type in inner_types:+ # Handle lists of objects that need parsing+ if get_origin(inner_type) is list and isinstance(object_, list):+ list_inner_type = _maybe_resolve_forward_ref(get_args(inner_type)[0], host)+ try:+ if inspect.isclass(list_inner_type) and issubclass(list_inner_type, pydantic.BaseModel):+ # Validate that all items in the list are compatible with the target type+ if _validate_collection_items_compatible(object_, list_inner_type):+ parsed_list = [parse_obj_as(object_=item, type_=list_inner_type) for item in object_]+ return parsed_list+ except Exception:+ pass++ try:+ if inspect.isclass(inner_type) and issubclass(inner_type, pydantic.BaseModel):+ if has_literal_discriminant and not _literal_fields_match_strict(inner_type, object_):+ continue+ # Attempt a validated parse until one works+ return parse_obj_as(inner_type, object_)+ except Exception:+ continue++ # First pass: try types where all literal fields match the object's values.+ for inner_type in inner_types:+ if inspect.isclass(inner_type) and issubclass(inner_type, pydantic.BaseModel):+ if has_literal_discriminant:+ if not _literal_fields_match_strict(inner_type, object_):+ continue+ else:+ # Legacy lenient check: skip only when a Literal value is+ # present but doesn't match (allows absent-discriminant inputs).+ fields = _get_model_fields(inner_type)+ literal_fields_match = True+ for field_name, field in fields.items():+ if IS_PYDANTIC_V2:+ field_type = field.annotation # type: ignore # Pydantic v2+ else:+ field_type = field.outer_type_ # type: ignore # Pydantic v1++ if is_literal_type(field_type): # type: ignore[arg-type]+ field_default = _get_field_default(field)+ object_value = _get_literal_field_value(inner_type, field_name, field, object_)+ if object_value is not None and field_default != object_value:+ literal_fields_match = False+ break++ if not literal_fields_match:+ continue++ try:+ return construct_type(object_=object_, type_=inner_type, host=host)+ except Exception:+ continue++ # Second pass: if no literal matches, return the first successful cast.+ # When a Literal discriminant is present, skip Pydantic models whose+ # discriminant doesn't match so that plain-dict fallback types are reached.+ for inner_type in inner_types:+ try:+ if has_literal_discriminant and inspect.isclass(inner_type) and issubclass(inner_type, pydantic.BaseModel):+ if not _literal_fields_match_strict(inner_type, object_):+ continue+ return construct_type(object_=object_, type_=inner_type, host=host)+ except Exception:+ continue+++def _convert_union_type(+ type_: typing.Type[typing.Any],+ object_: typing.Any,+ host: typing.Optional[typing.Type[typing.Any]] = None,+) -> typing.Any:+ base_type = get_origin(type_) or type_+ union_type = type_+ if base_type == typing_extensions.Annotated: # type: ignore[comparison-overlap]+ union_type = get_args(type_)[0]+ annotated_metadata = get_args(type_)[1:]+ for metadata in annotated_metadata:+ if isinstance(metadata, UnionMetadata):+ try:+ # Cast to the correct type, based on the discriminant+ for inner_type in get_args(union_type):+ try:+ objects_discriminant = getattr(object_, metadata.discriminant)+ except:+ objects_discriminant = object_[metadata.discriminant]+ if inner_type.__fields__[metadata.discriminant].default == objects_discriminant:+ return construct_type(object_=object_, type_=inner_type, host=host)+ except Exception:+ # Allow to fall through to our regular union handling+ pass+ return _convert_undiscriminated_union_type(union_type, object_, host)+++def construct_type(+ *,+ type_: typing.Type[typing.Any],+ object_: typing.Any,+ host: typing.Optional[typing.Type[typing.Any]] = None,+) -> typing.Any:+ """+ Here we are essentially creating the same `construct` method in spirit as the above, but for all types, not just+ Pydantic models.+ The idea is to essentially attempt to coerce object_ to type_ (recursively)+ """+ # Short circuit when dealing with optionals, don't try to coerces None to a type+ if object_ is None:+ return None++ base_type = get_origin(type_) or type_+ is_annotated = base_type == typing_extensions.Annotated # type: ignore[comparison-overlap]+ maybe_annotation_members = get_args(type_)+ is_annotated_union = is_annotated and is_union(get_origin(maybe_annotation_members[0]))++ if base_type == typing.Any: # type: ignore[comparison-overlap]+ return object_++ if base_type == dict:+ if not isinstance(object_, typing.Mapping):+ return object_++ type_args = get_args(type_)+ if not type_args:+ return object_+ key_type, items_type = type_args+ key_type = _maybe_resolve_forward_ref(key_type, host)+ items_type = _maybe_resolve_forward_ref(items_type, host)+ d = {+ construct_type(object_=key, type_=key_type, host=host): construct_type(+ object_=item, type_=items_type, host=host+ )+ for key, item in object_.items()+ }+ return d++ if base_type == list:+ if not isinstance(object_, list):+ return object_++ type_args = get_args(type_)+ if not type_args:+ return object_+ inner_type = _maybe_resolve_forward_ref(type_args[0], host)+ return [construct_type(object_=entry, type_=inner_type, host=host) for entry in object_]++ if base_type == set:+ if not isinstance(object_, set) and not isinstance(object_, list):+ return object_++ type_args = get_args(type_)+ if not type_args:+ return object_+ inner_type = _maybe_resolve_forward_ref(type_args[0], host)+ return {construct_type(object_=entry, type_=inner_type, host=host) for entry in object_}++ if is_union(base_type) or is_annotated_union:+ return _convert_union_type(type_, object_, host)++ # Cannot do an `issubclass` with a literal type, let's also just confirm we have a class before this call+ if (+ object_ is not None+ and not is_literal_type(type_)+ and (+ (inspect.isclass(base_type) and issubclass(base_type, pydantic.BaseModel))+ or (+ is_annotated+ and inspect.isclass(maybe_annotation_members[0])+ and issubclass(maybe_annotation_members[0], pydantic.BaseModel)+ )+ )+ ):+ if IS_PYDANTIC_V2:+ return type_.model_construct(**object_)+ else:+ return type_.construct(**object_)++ if base_type == dt.datetime:+ try:+ return parse_datetime(object_)+ except Exception:+ return object_++ if base_type == dt.date:+ try:+ return parse_date(object_)+ except Exception:+ return object_++ if base_type == uuid.UUID:+ try:+ return uuid.UUID(object_)+ except Exception:+ return object_++ if base_type == int:+ try:+ return int(object_)+ except Exception:+ return object_++ if base_type == bool:+ try:+ if isinstance(object_, str):+ stringified_object = object_.lower()+ return stringified_object == "true" or stringified_object == "1"++ return bool(object_)+ except Exception:+ return object_++ if inspect.isclass(base_type) and issubclass(base_type, enum.Enum):+ try:+ return base_type(object_)+ except (ValueError, KeyError):+ return object_++ return object_+++def _get_is_populate_by_name(model: typing.Type["Model"]) -> bool:+ if IS_PYDANTIC_V2:+ return model.model_config.get("populate_by_name", False) # type: ignore # Pydantic v2+ return model.__config__.allow_population_by_field_name # type: ignore # Pydantic v1+++from pydantic.fields import FieldInfo as _FieldInfo++PydanticField = typing.Union[ModelField, _FieldInfo]+++# Pydantic V1 swapped the typing of __fields__'s values from ModelField to FieldInfo+# And so we try to handle both V1 cases, as well as V2 (FieldInfo from model.model_fields)+def _get_model_fields(+ model: typing.Type["Model"],+) -> typing.Mapping[str, PydanticField]:+ if IS_PYDANTIC_V2:+ return model.model_fields # type: ignore # Pydantic v2+ else:+ return model.__fields__ # type: ignore # Pydantic v1+++def _get_field_default(field: PydanticField) -> typing.Any:+ try:+ value = field.get_default() # type: ignore # Pydantic < v1.10.15+ except:+ value = field.default+ if IS_PYDANTIC_V2:+ from pydantic_core import PydanticUndefined++ if value == PydanticUndefined:+ return None+ return value+ return valuediff --git a/python/trueforge_sdk/src/trueforge_sdk/errors/__init__.py b/python/trueforge_sdk/src/trueforge_sdk/errors/__init__.pynew file mode 100644index 000000000..07f9aa6be--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/errors/__init__.py@@ -0,0 +1,71 @@+# This file was auto-generated by Fern from our API Definition.++# isort: skip_file++import typing+from importlib import import_module++if typing.TYPE_CHECKING:+ from .bad_gateway_error import BadGatewayError+ from .bad_request_error import BadRequestError+ from .conflict_error import ConflictError+ from .content_too_large_error import ContentTooLargeError+ from .failed_dependency_error import FailedDependencyError+ from .forbidden_error import ForbiddenError+ from .gone_error import GoneError+ from .internal_server_error import InternalServerError+ from .not_found_error import NotFoundError+ from .precondition_failed_error import PreconditionFailedError+ from .unauthorized_error import UnauthorizedError+ from .unprocessable_entity_error import UnprocessableEntityError+_dynamic_imports: typing.Dict[str, str] = {+ "BadGatewayError": ".bad_gateway_error",+ "BadRequestError": ".bad_request_error",+ "ConflictError": ".conflict_error",+ "ContentTooLargeError": ".content_too_large_error",+ "FailedDependencyError": ".failed_dependency_error",+ "ForbiddenError": ".forbidden_error",+ "GoneError": ".gone_error",+ "InternalServerError": ".internal_server_error",+ "NotFoundError": ".not_found_error",+ "PreconditionFailedError": ".precondition_failed_error",+ "UnauthorizedError": ".unauthorized_error",+ "UnprocessableEntityError": ".unprocessable_entity_error",+}+++def __getattr__(attr_name: str) -> typing.Any:+ module_name = _dynamic_imports.get(attr_name)+ if module_name is None:+ raise AttributeError(f"No {attr_name} found in _dynamic_imports for module name -> {__name__}")+ try:+ module = import_module(module_name, __package__)+ if module_name == f".{attr_name}":+ return module+ else:+ return getattr(module, attr_name)+ except ImportError as e:+ raise ImportError(f"Failed to import {attr_name} from {module_name}: {e}") from e+ except AttributeError as e:+ raise AttributeError(f"Failed to get {attr_name} from {module_name}: {e}") from e+++def __dir__():+ lazy_attrs = list(_dynamic_imports.keys())+ return sorted(lazy_attrs)+++__all__ = [+ "BadGatewayError",+ "BadRequestError",+ "ConflictError",+ "ContentTooLargeError",+ "FailedDependencyError",+ "ForbiddenError",+ "GoneError",+ "InternalServerError",+ "NotFoundError",+ "PreconditionFailedError",+ "UnauthorizedError",+ "UnprocessableEntityError",+]diff --git a/python/trueforge_sdk/src/trueforge_sdk/errors/bad_gateway_error.py b/python/trueforge_sdk/src/trueforge_sdk/errors/bad_gateway_error.pynew file mode 100644index 000000000..b72b76953--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/errors/bad_gateway_error.py@@ -0,0 +1,11 @@+# This file was auto-generated by Fern from our API Definition.++import typing++from ..core.api_error import ApiError+from ..types.request_error_response import RequestErrorResponse+++class BadGatewayError(ApiError):+ def __init__(self, body: RequestErrorResponse, headers: typing.Optional[typing.Dict[str, str]] = None):+ super().__init__(status_code=502, headers=headers, body=body)diff --git a/python/trueforge_sdk/src/trueforge_sdk/errors/bad_request_error.py b/python/trueforge_sdk/src/trueforge_sdk/errors/bad_request_error.pynew file mode 100644index 000000000..11e1516bf--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/errors/bad_request_error.py@@ -0,0 +1,11 @@+# This file was auto-generated by Fern from our API Definition.++import typing++from ..core.api_error import ApiError+from ..types.request_error_response import RequestErrorResponse+++class BadRequestError(ApiError):+ def __init__(self, body: RequestErrorResponse, headers: typing.Optional[typing.Dict[str, str]] = None):+ super().__init__(status_code=400, headers=headers, body=body)diff --git a/python/trueforge_sdk/src/trueforge_sdk/errors/conflict_error.py b/python/trueforge_sdk/src/trueforge_sdk/errors/conflict_error.pynew file mode 100644index 000000000..5f845f61a--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/errors/conflict_error.py@@ -0,0 +1,11 @@+# This file was auto-generated by Fern from our API Definition.++import typing++from ..core.api_error import ApiError+from ..types.request_error_response import RequestErrorResponse+++class ConflictError(ApiError):+ def __init__(self, body: RequestErrorResponse, headers: typing.Optional[typing.Dict[str, str]] = None):+ super().__init__(status_code=409, headers=headers, body=body)diff --git a/python/trueforge_sdk/src/trueforge_sdk/errors/content_too_large_error.py b/python/trueforge_sdk/src/trueforge_sdk/errors/content_too_large_error.pynew file mode 100644index 000000000..3e5ae1c53--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/errors/content_too_large_error.py@@ -0,0 +1,11 @@+# This file was auto-generated by Fern from our API Definition.++import typing++from ..core.api_error import ApiError+from ..types.request_error_response import RequestErrorResponse+++class ContentTooLargeError(ApiError):+ def __init__(self, body: RequestErrorResponse, headers: typing.Optional[typing.Dict[str, str]] = None):+ super().__init__(status_code=413, headers=headers, body=body)diff --git a/python/trueforge_sdk/src/trueforge_sdk/errors/failed_dependency_error.py b/python/trueforge_sdk/src/trueforge_sdk/errors/failed_dependency_error.pynew file mode 100644index 000000000..eeb40eb78--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/errors/failed_dependency_error.py@@ -0,0 +1,11 @@+# This file was auto-generated by Fern from our API Definition.++import typing++from ..core.api_error import ApiError+from ..types.request_error_response import RequestErrorResponse+++class FailedDependencyError(ApiError):+ def __init__(self, body: RequestErrorResponse, headers: typing.Optional[typing.Dict[str, str]] = None):+ super().__init__(status_code=424, headers=headers, body=body)diff --git a/python/trueforge_sdk/src/trueforge_sdk/errors/forbidden_error.py b/python/trueforge_sdk/src/trueforge_sdk/errors/forbidden_error.pynew file mode 100644index 000000000..dce44d239--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/errors/forbidden_error.py@@ -0,0 +1,11 @@+# This file was auto-generated by Fern from our API Definition.++import typing++from ..core.api_error import ApiError+from ..types.request_error_response import RequestErrorResponse+++class ForbiddenError(ApiError):+ def __init__(self, body: RequestErrorResponse, headers: typing.Optional[typing.Dict[str, str]] = None):+ super().__init__(status_code=403, headers=headers, body=body)diff --git a/python/trueforge_sdk/src/trueforge_sdk/errors/gone_error.py b/python/trueforge_sdk/src/trueforge_sdk/errors/gone_error.pynew file mode 100644index 000000000..454cd614a--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/errors/gone_error.py@@ -0,0 +1,11 @@+# This file was auto-generated by Fern from our API Definition.++import typing++from ..core.api_error import ApiError+from ..types.request_error_response import RequestErrorResponse+++class GoneError(ApiError):+ def __init__(self, body: RequestErrorResponse, headers: typing.Optional[typing.Dict[str, str]] = None):+ super().__init__(status_code=410, headers=headers, body=body)diff --git a/python/trueforge_sdk/src/trueforge_sdk/errors/internal_server_error.py b/python/trueforge_sdk/src/trueforge_sdk/errors/internal_server_error.pynew file mode 100644index 000000000..b71e2969f--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/errors/internal_server_error.py@@ -0,0 +1,11 @@+# This file was auto-generated by Fern from our API Definition.++import typing++from ..core.api_error import ApiError+from ..types.request_error_response import RequestErrorResponse+++class InternalServerError(ApiError):+ def __init__(self, body: RequestErrorResponse, headers: typing.Optional[typing.Dict[str, str]] = None):+ super().__init__(status_code=500, headers=headers, body=body)diff --git a/python/trueforge_sdk/src/trueforge_sdk/errors/not_found_error.py b/python/trueforge_sdk/src/trueforge_sdk/errors/not_found_error.pynew file mode 100644index 000000000..d945c7b1d--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/errors/not_found_error.py@@ -0,0 +1,11 @@+# This file was auto-generated by Fern from our API Definition.++import typing++from ..core.api_error import ApiError+from ..types.request_error_response import RequestErrorResponse+++class NotFoundError(ApiError):+ def __init__(self, body: RequestErrorResponse, headers: typing.Optional[typing.Dict[str, str]] = None):+ super().__init__(status_code=404, headers=headers, body=body)diff --git a/python/trueforge_sdk/src/trueforge_sdk/errors/precondition_failed_error.py b/python/trueforge_sdk/src/trueforge_sdk/errors/precondition_failed_error.pynew file mode 100644index 000000000..d0c170180--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/errors/precondition_failed_error.py@@ -0,0 +1,11 @@+# This file was auto-generated by Fern from our API Definition.++import typing++from ..core.api_error import ApiError+from ..types.request_error_response import RequestErrorResponse+++class PreconditionFailedError(ApiError):+ def __init__(self, body: RequestErrorResponse, headers: typing.Optional[typing.Dict[str, str]] = None):+ super().__init__(status_code=412, headers=headers, body=body)diff --git a/python/trueforge_sdk/src/trueforge_sdk/errors/unauthorized_error.py b/python/trueforge_sdk/src/trueforge_sdk/errors/unauthorized_error.pynew file mode 100644index 000000000..e7af6a298--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/errors/unauthorized_error.py@@ -0,0 +1,11 @@+# This file was auto-generated by Fern from our API Definition.++import typing++from ..core.api_error import ApiError+from ..types.request_error_response import RequestErrorResponse+++class UnauthorizedError(ApiError):+ def __init__(self, body: RequestErrorResponse, headers: typing.Optional[typing.Dict[str, str]] = None):+ super().__init__(status_code=401, headers=headers, body=body)diff --git a/python/trueforge_sdk/src/trueforge_sdk/errors/unprocessable_entity_error.py b/python/trueforge_sdk/src/trueforge_sdk/errors/unprocessable_entity_error.pynew file mode 100644index 000000000..802dbabe2--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/errors/unprocessable_entity_error.py@@ -0,0 +1,11 @@+# This file was auto-generated by Fern from our API Definition.++import typing++from ..core.api_error import ApiError+from ..types.request_error_response import RequestErrorResponse+++class UnprocessableEntityError(ApiError):+ def __init__(self, body: RequestErrorResponse, headers: typing.Optional[typing.Dict[str, str]] = None):+ super().__init__(status_code=422, headers=headers, body=body)diff --git a/python/trueforge_sdk/src/trueforge_sdk/internal/__init__.py b/python/trueforge_sdk/src/trueforge_sdk/internal/__init__.pynew file mode 100644index 000000000..c58f0faa0--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/internal/__init__.py@@ -0,0 +1,39 @@+# This file was auto-generated by Fern from our API Definition.++# isort: skip_file++import typing+from importlib import import_module++if typing.TYPE_CHECKING:+ from . import agents, metrics, schedules, sessions+_dynamic_imports: typing.Dict[str, str] = {+ "agents": ".agents",+ "metrics": ".metrics",+ "schedules": ".schedules",+ "sessions": ".sessions",+}+++def __getattr__(attr_name: str) -> typing.Any:+ module_name = _dynamic_imports.get(attr_name)+ if module_name is None:+ raise AttributeError(f"No {attr_name} found in _dynamic_imports for module name -> {__name__}")+ try:+ module = import_module(module_name, __package__)+ if module_name == f".{attr_name}":+ return module+ else:+ return getattr(module, attr_name)+ except ImportError as e:+ raise ImportError(f"Failed to import {attr_name} from {module_name}: {e}") from e+ except AttributeError as e:+ raise AttributeError(f"Failed to get {attr_name} from {module_name}: {e}") from e+++def __dir__():+ lazy_attrs = list(_dynamic_imports.keys())+ return sorted(lazy_attrs)+++__all__ = ["agents", "metrics", "schedules", "sessions"]diff --git a/python/trueforge_sdk/src/trueforge_sdk/internal/agents/__init__.py b/python/trueforge_sdk/src/trueforge_sdk/internal/agents/__init__.pynew file mode 100644index 000000000..5cde0202d--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/internal/agents/__init__.py@@ -0,0 +1,4 @@+# This file was auto-generated by Fern from our API Definition.++# isort: skip_file+diff --git a/python/trueforge_sdk/src/trueforge_sdk/internal/agents/client.py b/python/trueforge_sdk/src/trueforge_sdk/internal/agents/client.pynew file mode 100644index 000000000..d9aed5f35--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/internal/agents/client.py@@ -0,0 +1,134 @@+# This file was auto-generated by Fern from our API Definition.++import typing++from ...core.client_wrapper import AsyncClientWrapper, SyncClientWrapper+from ...core.request_options import RequestOptions+from ...types.get_agent_code_snippets_response import GetAgentCodeSnippetsResponse+from .raw_client import AsyncRawAgentsClient, RawAgentsClient+++class AgentsClient:+ def __init__(self, *, client_wrapper: SyncClientWrapper):+ self._raw_client = RawAgentsClient(client_wrapper=client_wrapper)++ @property+ def with_raw_response(self) -> RawAgentsClient:+ """+ Retrieves a raw implementation of this client that returns raw responses.++ Returns+ -------+ RawAgentsClient+ """+ return self._raw_client++ def get_code_snippets(+ self,+ *,+ agent_id: str,+ base_url: typing.Optional[str] = None,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> GetAgentCodeSnippetsResponse:+ """+ TypeScript TrueForge SDK samples (stream and non-stream) for creating a session and turn against this agent.++ Parameters+ ----------+ agent_id : str+ Immutable agent identifier.++ base_url : typing.Optional[str]+ Public SDK base URL from the browser. When omitted, derived from the request origin and PUBLIC_BASE_URL.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ GetAgentCodeSnippetsResponse+ TypeScript SDK samples.++ Examples+ --------+ from trueforge_sdk import TrueForge++ client = TrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+ client.internal.agents.get_code_snippets(+ agent_id="agent_id",+ )+ """+ _response = self._raw_client.get_code_snippets(+ agent_id=agent_id, base_url=base_url, request_options=request_options+ )+ return _response.data+++class AsyncAgentsClient:+ def __init__(self, *, client_wrapper: AsyncClientWrapper):+ self._raw_client = AsyncRawAgentsClient(client_wrapper=client_wrapper)++ @property+ def with_raw_response(self) -> AsyncRawAgentsClient:+ """+ Retrieves a raw implementation of this client that returns raw responses.++ Returns+ -------+ AsyncRawAgentsClient+ """+ return self._raw_client++ async def get_code_snippets(+ self,+ *,+ agent_id: str,+ base_url: typing.Optional[str] = None,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> GetAgentCodeSnippetsResponse:+ """+ TypeScript TrueForge SDK samples (stream and non-stream) for creating a session and turn against this agent.++ Parameters+ ----------+ agent_id : str+ Immutable agent identifier.++ base_url : typing.Optional[str]+ Public SDK base URL from the browser. When omitted, derived from the request origin and PUBLIC_BASE_URL.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ GetAgentCodeSnippetsResponse+ TypeScript SDK samples.++ Examples+ --------+ import asyncio++ from trueforge_sdk import AsyncTrueForge++ client = AsyncTrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+++ async def main() -> None:+ await client.internal.agents.get_code_snippets(+ agent_id="agent_id",+ )+++ asyncio.run(main())+ """+ _response = await self._raw_client.get_code_snippets(+ agent_id=agent_id, base_url=base_url, request_options=request_options+ )+ return _response.datadiff --git a/python/trueforge_sdk/src/trueforge_sdk/internal/agents/raw_client.py b/python/trueforge_sdk/src/trueforge_sdk/internal/agents/raw_client.pynew file mode 100644index 000000000..9dbfe6ca7--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/internal/agents/raw_client.py@@ -0,0 +1,154 @@+# 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.jsonable_encoder import encode_path_param+from ...core.parse_error import ParsingError+from ...core.request_options import RequestOptions+from ...core.unchecked_base_model import construct_type+from ...errors.not_found_error import NotFoundError+from ...types.get_agent_code_snippets_response import GetAgentCodeSnippetsResponse+from ...types.request_error_response import RequestErrorResponse+from pydantic import ValidationError+++class RawAgentsClient:+ def __init__(self, *, client_wrapper: SyncClientWrapper):+ self._client_wrapper = client_wrapper++ def get_code_snippets(+ self,+ *,+ agent_id: str,+ base_url: typing.Optional[str] = None,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> HttpResponse[GetAgentCodeSnippetsResponse]:+ """+ TypeScript TrueForge SDK samples (stream and non-stream) for creating a session and turn against this agent.++ Parameters+ ----------+ agent_id : str+ Immutable agent identifier.++ base_url : typing.Optional[str]+ Public SDK base URL from the browser. When omitted, derived from the request origin and PUBLIC_BASE_URL.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[GetAgentCodeSnippetsResponse]+ TypeScript SDK samples.+ """+ _response = self._client_wrapper.httpx_client.request(+ f"api/v1/agents/{encode_path_param(agent_id)}/code-snippets",+ method="GET",+ params={+ "base_url": base_url,+ },+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ GetAgentCodeSnippetsResponse,+ construct_type(+ type_=GetAgentCodeSnippetsResponse, # type: ignore+ object_=_response.json(),+ ),+ )+ return HttpResponse(response=_response, data=_data)+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)+++class AsyncRawAgentsClient:+ def __init__(self, *, client_wrapper: AsyncClientWrapper):+ self._client_wrapper = client_wrapper++ async def get_code_snippets(+ self,+ *,+ agent_id: str,+ base_url: typing.Optional[str] = None,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> AsyncHttpResponse[GetAgentCodeSnippetsResponse]:+ """+ TypeScript TrueForge SDK samples (stream and non-stream) for creating a session and turn against this agent.++ Parameters+ ----------+ agent_id : str+ Immutable agent identifier.++ base_url : typing.Optional[str]+ Public SDK base URL from the browser. When omitted, derived from the request origin and PUBLIC_BASE_URL.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ AsyncHttpResponse[GetAgentCodeSnippetsResponse]+ TypeScript SDK samples.+ """+ _response = await self._client_wrapper.httpx_client.request(+ f"api/v1/agents/{encode_path_param(agent_id)}/code-snippets",+ method="GET",+ params={+ "base_url": base_url,+ },+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ GetAgentCodeSnippetsResponse,+ construct_type(+ type_=GetAgentCodeSnippetsResponse, # type: ignore+ object_=_response.json(),+ ),+ )+ return AsyncHttpResponse(response=_response, data=_data)+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)diff --git a/python/trueforge_sdk/src/trueforge_sdk/internal/client.py b/python/trueforge_sdk/src/trueforge_sdk/internal/client.pynew file mode 100644index 000000000..36f835c32--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/internal/client.py@@ -0,0 +1,219 @@+# This file was auto-generated by Fern from our API Definition.++from __future__ import annotations++import typing++from ..core.client_wrapper import AsyncClientWrapper, SyncClientWrapper+from ..core.request_options import RequestOptions+from ..types.list_permissions_response import ListPermissionsResponse+from ..types.permission_resource_type import PermissionResourceType+from .raw_client import AsyncRawInternalClient, RawInternalClient++if typing.TYPE_CHECKING:+ from .agents.client import AgentsClient, AsyncAgentsClient+ from .metrics.client import AsyncMetricsClient, MetricsClient+ from .schedules.client import AsyncSchedulesClient, SchedulesClient+ from .sessions.client import AsyncSessionsClient, SessionsClient+# this is used as the default value for optional parameters+OMIT = typing.cast(typing.Any, ...)+++class InternalClient:+ def __init__(self, *, client_wrapper: SyncClientWrapper):+ self._raw_client = RawInternalClient(client_wrapper=client_wrapper)+ self._client_wrapper = client_wrapper+ self._metrics: typing.Optional[MetricsClient] = None+ self._schedules: typing.Optional[SchedulesClient] = None+ self._sessions: typing.Optional[SessionsClient] = None+ self._agents: typing.Optional[AgentsClient] = None++ @property+ def with_raw_response(self) -> RawInternalClient:+ """+ Retrieves a raw implementation of this client that returns raw responses.++ Returns+ -------+ RawInternalClient+ """+ return self._raw_client++ def list_permissions(+ self,+ *,+ resource_ids: typing.Sequence[str],+ resource_type: PermissionResourceType,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> ListPermissionsResponse:+ """+ Return granted actions for each requested agent, schedule, or session id.++ Parameters+ ----------+ resource_ids : typing.Sequence[str]+ Resource ids of `resource_type` to evaluate for the caller.++ resource_type : PermissionResourceType++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ ListPermissionsResponse+ Permissions keyed by resource id.++ Examples+ --------+ from trueforge_sdk import PermissionResourceType, TrueForge++ client = TrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+ client.internal.list_permissions(+ resource_ids=["resource_ids"],+ resource_type=PermissionResourceType.AGENT,+ )+ """+ _response = self._raw_client.list_permissions(+ resource_ids=resource_ids, resource_type=resource_type, request_options=request_options+ )+ return _response.data++ @property+ def metrics(self):+ if self._metrics is None:+ from .metrics.client import MetricsClient # noqa: E402++ self._metrics = MetricsClient(client_wrapper=self._client_wrapper)+ return self._metrics++ @property+ def schedules(self):+ if self._schedules is None:+ from .schedules.client import SchedulesClient # noqa: E402++ self._schedules = SchedulesClient(client_wrapper=self._client_wrapper)+ return self._schedules++ @property+ def sessions(self):+ if self._sessions is None:+ from .sessions.client import SessionsClient # noqa: E402++ self._sessions = SessionsClient(client_wrapper=self._client_wrapper)+ return self._sessions++ @property+ def agents(self):+ if self._agents is None:+ from .agents.client import AgentsClient # noqa: E402++ self._agents = AgentsClient(client_wrapper=self._client_wrapper)+ return self._agents+++class AsyncInternalClient:+ def __init__(self, *, client_wrapper: AsyncClientWrapper):+ self._raw_client = AsyncRawInternalClient(client_wrapper=client_wrapper)+ self._client_wrapper = client_wrapper+ self._metrics: typing.Optional[AsyncMetricsClient] = None+ self._schedules: typing.Optional[AsyncSchedulesClient] = None+ self._sessions: typing.Optional[AsyncSessionsClient] = None+ self._agents: typing.Optional[AsyncAgentsClient] = None++ @property+ def with_raw_response(self) -> AsyncRawInternalClient:+ """+ Retrieves a raw implementation of this client that returns raw responses.++ Returns+ -------+ AsyncRawInternalClient+ """+ return self._raw_client++ async def list_permissions(+ self,+ *,+ resource_ids: typing.Sequence[str],+ resource_type: PermissionResourceType,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> ListPermissionsResponse:+ """+ Return granted actions for each requested agent, schedule, or session id.++ Parameters+ ----------+ resource_ids : typing.Sequence[str]+ Resource ids of `resource_type` to evaluate for the caller.++ resource_type : PermissionResourceType++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ ListPermissionsResponse+ Permissions keyed by resource id.++ Examples+ --------+ import asyncio++ from trueforge_sdk import AsyncTrueForge, PermissionResourceType++ client = AsyncTrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+++ async def main() -> None:+ await client.internal.list_permissions(+ resource_ids=["resource_ids"],+ resource_type=PermissionResourceType.AGENT,+ )+++ asyncio.run(main())+ """+ _response = await self._raw_client.list_permissions(+ resource_ids=resource_ids, resource_type=resource_type, request_options=request_options+ )+ return _response.data++ @property+ def metrics(self):+ if self._metrics is None:+ from .metrics.client import AsyncMetricsClient # noqa: E402++ self._metrics = AsyncMetricsClient(client_wrapper=self._client_wrapper)+ return self._metrics++ @property+ def schedules(self):+ if self._schedules is None:+ from .schedules.client import AsyncSchedulesClient # noqa: E402++ self._schedules = AsyncSchedulesClient(client_wrapper=self._client_wrapper)+ return self._schedules++ @property+ def sessions(self):+ if self._sessions is None:+ from .sessions.client import AsyncSessionsClient # noqa: E402++ self._sessions = AsyncSessionsClient(client_wrapper=self._client_wrapper)+ return self._sessions++ @property+ def agents(self):+ if self._agents is None:+ from .agents.client import AsyncAgentsClient # noqa: E402++ self._agents = AsyncAgentsClient(client_wrapper=self._client_wrapper)+ return self._agentsdiff --git a/python/trueforge_sdk/src/trueforge_sdk/internal/metrics/__init__.py b/python/trueforge_sdk/src/trueforge_sdk/internal/metrics/__init__.pynew file mode 100644index 000000000..5cde0202d--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/internal/metrics/__init__.py@@ -0,0 +1,4 @@+# This file was auto-generated by Fern from our API Definition.++# isort: skip_file+diff --git a/python/trueforge_sdk/src/trueforge_sdk/internal/metrics/client.py b/python/trueforge_sdk/src/trueforge_sdk/internal/metrics/client.pynew file mode 100644index 000000000..d063531fe--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/internal/metrics/client.py@@ -0,0 +1,366 @@+# This file was auto-generated by Fern from our API Definition.++import datetime as dt+import typing++from ...core.client_wrapper import AsyncClientWrapper, SyncClientWrapper+from ...core.request_options import RequestOptions+from ...types.get_session_metrics_chart_data_response import GetSessionMetricsChartDataResponse+from ...types.get_session_metrics_chart_response import GetSessionMetricsChartResponse+from ...types.get_session_metrics_meter_response import GetSessionMetricsMeterResponse+from ...types.session_metrics_chart_name import SessionMetricsChartName+from .raw_client import AsyncRawMetricsClient, RawMetricsClient+++class MetricsClient:+ def __init__(self, *, client_wrapper: SyncClientWrapper):+ self._raw_client = RawMetricsClient(client_wrapper=client_wrapper)++ @property+ def with_raw_response(self) -> RawMetricsClient:+ """+ Retrieves a raw implementation of this client that returns raw responses.++ Returns+ -------+ RawMetricsClient+ """+ return self._raw_client++ def list_charts(self, *, request_options: typing.Optional[RequestOptions] = None) -> GetSessionMetricsChartResponse:+ """+ List available session metric charts.++ Parameters+ ----------+ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ GetSessionMetricsChartResponse+ Available session metric charts.++ Examples+ --------+ from trueforge_sdk import TrueForge++ client = TrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+ client.internal.metrics.list_charts()+ """+ _response = self._raw_client.list_charts(request_options=request_options)+ return _response.data++ def get_chart_data(+ self,+ *,+ agent_id: str,+ start_timestamp: dt.datetime,+ end_timestamp: dt.datetime,+ chart_name: SessionMetricsChartName,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> GetSessionMetricsChartDataResponse:+ """+ Return one chart for the caller's sessions on a named agent over an inclusive creation-time window. Uses hourly buckets for windows up to 24 hours and daily UTC buckets otherwise.++ Parameters+ ----------+ agent_id : str+ Named agent identifier.++ start_timestamp : dt.datetime+ Inclusive lower bound on session `created_at`.++ end_timestamp : dt.datetime+ Inclusive upper bound on session `created_at`.++ chart_name : SessionMetricsChartName+ Session metrics chart to return.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ GetSessionMetricsChartDataResponse+ Zero-filled time series for one chart.++ Examples+ --------+ import datetime++ from trueforge_sdk import SessionMetricsChartName, TrueForge++ client = TrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+ client.internal.metrics.get_chart_data(+ agent_id="agent_id",+ start_timestamp=datetime.datetime.fromisoformat(+ "2024-01-15 09:30:00+00:00",+ ),+ end_timestamp=datetime.datetime.fromisoformat(+ "2024-01-15 09:30:00+00:00",+ ),+ chart_name=SessionMetricsChartName.SESSIONS_OVER_TIME,+ )+ """+ _response = self._raw_client.get_chart_data(+ agent_id=agent_id,+ start_timestamp=start_timestamp,+ end_timestamp=end_timestamp,+ chart_name=chart_name,+ request_options=request_options,+ )+ return _response.data++ def get_meters(+ self,+ *,+ agent_id: str,+ start_timestamp: dt.datetime,+ end_timestamp: dt.datetime,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> GetSessionMetricsMeterResponse:+ """+ Aggregate the caller's session meters for a named agent over an inclusive creation-time window.++ Parameters+ ----------+ agent_id : str+ Named agent identifier.++ start_timestamp : dt.datetime+ Inclusive lower bound on session `created_at`.++ end_timestamp : dt.datetime+ Inclusive upper bound on session `created_at`.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ GetSessionMetricsMeterResponse+ Session metric meters.++ Examples+ --------+ import datetime++ from trueforge_sdk import TrueForge++ client = TrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+ client.internal.metrics.get_meters(+ agent_id="agent_id",+ start_timestamp=datetime.datetime.fromisoformat(+ "2024-01-15 09:30:00+00:00",+ ),+ end_timestamp=datetime.datetime.fromisoformat(+ "2024-01-15 09:30:00+00:00",+ ),+ )+ """+ _response = self._raw_client.get_meters(+ agent_id=agent_id,+ start_timestamp=start_timestamp,+ end_timestamp=end_timestamp,+ request_options=request_options,+ )+ return _response.data+++class AsyncMetricsClient:+ def __init__(self, *, client_wrapper: AsyncClientWrapper):+ self._raw_client = AsyncRawMetricsClient(client_wrapper=client_wrapper)++ @property+ def with_raw_response(self) -> AsyncRawMetricsClient:+ """+ Retrieves a raw implementation of this client that returns raw responses.++ Returns+ -------+ AsyncRawMetricsClient+ """+ return self._raw_client++ async def list_charts(+ self, *, request_options: typing.Optional[RequestOptions] = None+ ) -> GetSessionMetricsChartResponse:+ """+ List available session metric charts.++ Parameters+ ----------+ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ GetSessionMetricsChartResponse+ Available session metric charts.++ Examples+ --------+ import asyncio++ from trueforge_sdk import AsyncTrueForge++ client = AsyncTrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+++ async def main() -> None:+ await client.internal.metrics.list_charts()+++ asyncio.run(main())+ """+ _response = await self._raw_client.list_charts(request_options=request_options)+ return _response.data++ async def get_chart_data(+ self,+ *,+ agent_id: str,+ start_timestamp: dt.datetime,+ end_timestamp: dt.datetime,+ chart_name: SessionMetricsChartName,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> GetSessionMetricsChartDataResponse:+ """+ Return one chart for the caller's sessions on a named agent over an inclusive creation-time window. Uses hourly buckets for windows up to 24 hours and daily UTC buckets otherwise.++ Parameters+ ----------+ agent_id : str+ Named agent identifier.++ start_timestamp : dt.datetime+ Inclusive lower bound on session `created_at`.++ end_timestamp : dt.datetime+ Inclusive upper bound on session `created_at`.++ chart_name : SessionMetricsChartName+ Session metrics chart to return.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ GetSessionMetricsChartDataResponse+ Zero-filled time series for one chart.++ Examples+ --------+ import asyncio+ import datetime++ from trueforge_sdk import AsyncTrueForge, SessionMetricsChartName++ client = AsyncTrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+++ async def main() -> None:+ await client.internal.metrics.get_chart_data(+ agent_id="agent_id",+ start_timestamp=datetime.datetime.fromisoformat(+ "2024-01-15 09:30:00+00:00",+ ),+ end_timestamp=datetime.datetime.fromisoformat(+ "2024-01-15 09:30:00+00:00",+ ),+ chart_name=SessionMetricsChartName.SESSIONS_OVER_TIME,+ )+++ asyncio.run(main())+ """+ _response = await self._raw_client.get_chart_data(+ agent_id=agent_id,+ start_timestamp=start_timestamp,+ end_timestamp=end_timestamp,+ chart_name=chart_name,+ request_options=request_options,+ )+ return _response.data++ async def get_meters(+ self,+ *,+ agent_id: str,+ start_timestamp: dt.datetime,+ end_timestamp: dt.datetime,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> GetSessionMetricsMeterResponse:+ """+ Aggregate the caller's session meters for a named agent over an inclusive creation-time window.++ Parameters+ ----------+ agent_id : str+ Named agent identifier.++ start_timestamp : dt.datetime+ Inclusive lower bound on session `created_at`.++ end_timestamp : dt.datetime+ Inclusive upper bound on session `created_at`.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ GetSessionMetricsMeterResponse+ Session metric meters.++ Examples+ --------+ import asyncio+ import datetime++ from trueforge_sdk import AsyncTrueForge++ client = AsyncTrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+++ async def main() -> None:+ await client.internal.metrics.get_meters(+ agent_id="agent_id",+ start_timestamp=datetime.datetime.fromisoformat(+ "2024-01-15 09:30:00+00:00",+ ),+ end_timestamp=datetime.datetime.fromisoformat(+ "2024-01-15 09:30:00+00:00",+ ),+ )+++ asyncio.run(main())+ """+ _response = await self._raw_client.get_meters(+ agent_id=agent_id,+ start_timestamp=start_timestamp,+ end_timestamp=end_timestamp,+ request_options=request_options,+ )+ return _response.datadiff --git a/python/trueforge_sdk/src/trueforge_sdk/internal/metrics/raw_client.py b/python/trueforge_sdk/src/trueforge_sdk/internal/metrics/raw_client.pynew file mode 100644index 000000000..2ab0ab383--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/internal/metrics/raw_client.py@@ -0,0 +1,400 @@+# This file was auto-generated by Fern from our API Definition.++import datetime as dt+import typing+from json.decoder import JSONDecodeError++from ...core.api_error import ApiError+from ...core.client_wrapper import AsyncClientWrapper, SyncClientWrapper+from ...core.datetime_utils import serialize_datetime+from ...core.http_response import AsyncHttpResponse, HttpResponse+from ...core.parse_error import ParsingError+from ...core.request_options import RequestOptions+from ...core.unchecked_base_model import construct_type+from ...errors.bad_request_error import BadRequestError+from ...types.get_session_metrics_chart_data_response import GetSessionMetricsChartDataResponse+from ...types.get_session_metrics_chart_response import GetSessionMetricsChartResponse+from ...types.get_session_metrics_meter_response import GetSessionMetricsMeterResponse+from ...types.request_error_response import RequestErrorResponse+from ...types.session_metrics_chart_name import SessionMetricsChartName+from pydantic import ValidationError+++class RawMetricsClient:+ def __init__(self, *, client_wrapper: SyncClientWrapper):+ self._client_wrapper = client_wrapper++ def list_charts(+ self, *, request_options: typing.Optional[RequestOptions] = None+ ) -> HttpResponse[GetSessionMetricsChartResponse]:+ """+ List available session metric charts.++ Parameters+ ----------+ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[GetSessionMetricsChartResponse]+ Available session metric charts.+ """+ _response = self._client_wrapper.httpx_client.request(+ "api/internal/metrics/charts",+ method="GET",+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ GetSessionMetricsChartResponse,+ construct_type(+ type_=GetSessionMetricsChartResponse, # type: ignore+ object_=_response.json(),+ ),+ )+ return HttpResponse(response=_response, data=_data)+ _response_json = _response.json()+ except JSONDecodeError:+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ def get_chart_data(+ self,+ *,+ agent_id: str,+ start_timestamp: dt.datetime,+ end_timestamp: dt.datetime,+ chart_name: SessionMetricsChartName,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> HttpResponse[GetSessionMetricsChartDataResponse]:+ """+ Return one chart for the caller's sessions on a named agent over an inclusive creation-time window. Uses hourly buckets for windows up to 24 hours and daily UTC buckets otherwise.++ Parameters+ ----------+ agent_id : str+ Named agent identifier.++ start_timestamp : dt.datetime+ Inclusive lower bound on session `created_at`.++ end_timestamp : dt.datetime+ Inclusive upper bound on session `created_at`.++ chart_name : SessionMetricsChartName+ Session metrics chart to return.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[GetSessionMetricsChartDataResponse]+ Zero-filled time series for one chart.+ """+ _response = self._client_wrapper.httpx_client.request(+ "api/internal/metrics/charts-data",+ method="GET",+ params={+ "agent_id": agent_id,+ "start_timestamp": serialize_datetime(start_timestamp),+ "end_timestamp": serialize_datetime(end_timestamp),+ "chart_name": chart_name,+ },+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ GetSessionMetricsChartDataResponse,+ construct_type(+ type_=GetSessionMetricsChartDataResponse, # 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(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ def get_meters(+ self,+ *,+ agent_id: str,+ start_timestamp: dt.datetime,+ end_timestamp: dt.datetime,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> HttpResponse[GetSessionMetricsMeterResponse]:+ """+ Aggregate the caller's session meters for a named agent over an inclusive creation-time window.++ Parameters+ ----------+ agent_id : str+ Named agent identifier.++ start_timestamp : dt.datetime+ Inclusive lower bound on session `created_at`.++ end_timestamp : dt.datetime+ Inclusive upper bound on session `created_at`.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[GetSessionMetricsMeterResponse]+ Session metric meters.+ """+ _response = self._client_wrapper.httpx_client.request(+ "api/internal/metrics/meters",+ method="GET",+ params={+ "agent_id": agent_id,+ "start_timestamp": serialize_datetime(start_timestamp),+ "end_timestamp": serialize_datetime(end_timestamp),+ },+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ GetSessionMetricsMeterResponse,+ construct_type(+ type_=GetSessionMetricsMeterResponse, # 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(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)+++class AsyncRawMetricsClient:+ def __init__(self, *, client_wrapper: AsyncClientWrapper):+ self._client_wrapper = client_wrapper++ async def list_charts(+ self, *, request_options: typing.Optional[RequestOptions] = None+ ) -> AsyncHttpResponse[GetSessionMetricsChartResponse]:+ """+ List available session metric charts.++ Parameters+ ----------+ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ AsyncHttpResponse[GetSessionMetricsChartResponse]+ Available session metric charts.+ """+ _response = await self._client_wrapper.httpx_client.request(+ "api/internal/metrics/charts",+ method="GET",+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ GetSessionMetricsChartResponse,+ construct_type(+ type_=GetSessionMetricsChartResponse, # type: ignore+ object_=_response.json(),+ ),+ )+ return AsyncHttpResponse(response=_response, data=_data)+ _response_json = _response.json()+ except JSONDecodeError:+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ async def get_chart_data(+ self,+ *,+ agent_id: str,+ start_timestamp: dt.datetime,+ end_timestamp: dt.datetime,+ chart_name: SessionMetricsChartName,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> AsyncHttpResponse[GetSessionMetricsChartDataResponse]:+ """+ Return one chart for the caller's sessions on a named agent over an inclusive creation-time window. Uses hourly buckets for windows up to 24 hours and daily UTC buckets otherwise.++ Parameters+ ----------+ agent_id : str+ Named agent identifier.++ start_timestamp : dt.datetime+ Inclusive lower bound on session `created_at`.++ end_timestamp : dt.datetime+ Inclusive upper bound on session `created_at`.++ chart_name : SessionMetricsChartName+ Session metrics chart to return.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ AsyncHttpResponse[GetSessionMetricsChartDataResponse]+ Zero-filled time series for one chart.+ """+ _response = await self._client_wrapper.httpx_client.request(+ "api/internal/metrics/charts-data",+ method="GET",+ params={+ "agent_id": agent_id,+ "start_timestamp": serialize_datetime(start_timestamp),+ "end_timestamp": serialize_datetime(end_timestamp),+ "chart_name": chart_name,+ },+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ GetSessionMetricsChartDataResponse,+ construct_type(+ type_=GetSessionMetricsChartDataResponse, # 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(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ async def get_meters(+ self,+ *,+ agent_id: str,+ start_timestamp: dt.datetime,+ end_timestamp: dt.datetime,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> AsyncHttpResponse[GetSessionMetricsMeterResponse]:+ """+ Aggregate the caller's session meters for a named agent over an inclusive creation-time window.++ Parameters+ ----------+ agent_id : str+ Named agent identifier.++ start_timestamp : dt.datetime+ Inclusive lower bound on session `created_at`.++ end_timestamp : dt.datetime+ Inclusive upper bound on session `created_at`.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ AsyncHttpResponse[GetSessionMetricsMeterResponse]+ Session metric meters.+ """+ _response = await self._client_wrapper.httpx_client.request(+ "api/internal/metrics/meters",+ method="GET",+ params={+ "agent_id": agent_id,+ "start_timestamp": serialize_datetime(start_timestamp),+ "end_timestamp": serialize_datetime(end_timestamp),+ },+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ GetSessionMetricsMeterResponse,+ construct_type(+ type_=GetSessionMetricsMeterResponse, # 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(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)diff --git a/python/trueforge_sdk/src/trueforge_sdk/internal/raw_client.py b/python/trueforge_sdk/src/trueforge_sdk/internal/raw_client.pynew file mode 100644index 000000000..7cb7947e6--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/internal/raw_client.py@@ -0,0 +1,188 @@+# 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.parse_error import ParsingError+from ..core.request_options import RequestOptions+from ..core.unchecked_base_model import construct_type+from ..errors.bad_request_error import BadRequestError+from ..errors.unauthorized_error import UnauthorizedError+from ..types.list_permissions_response import ListPermissionsResponse+from ..types.permission_resource_type import PermissionResourceType+from ..types.request_error_response import RequestErrorResponse+from pydantic import ValidationError++# this is used as the default value for optional parameters+OMIT = typing.cast(typing.Any, ...)+++class RawInternalClient:+ def __init__(self, *, client_wrapper: SyncClientWrapper):+ self._client_wrapper = client_wrapper++ def list_permissions(+ self,+ *,+ resource_ids: typing.Sequence[str],+ resource_type: PermissionResourceType,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> HttpResponse[ListPermissionsResponse]:+ """+ Return granted actions for each requested agent, schedule, or session id.++ Parameters+ ----------+ resource_ids : typing.Sequence[str]+ Resource ids of `resource_type` to evaluate for the caller.++ resource_type : PermissionResourceType++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[ListPermissionsResponse]+ Permissions keyed by resource id.+ """+ _response = self._client_wrapper.httpx_client.request(+ "api/internal/list-permissions",+ method="POST",+ json={+ "resource_ids": resource_ids,+ "resource_type": resource_type,+ },+ headers={+ "content-type": "application/json",+ },+ request_options=request_options,+ omit=OMIT,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ ListPermissionsResponse,+ construct_type(+ type_=ListPermissionsResponse, # 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(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 401:+ raise UnauthorizedError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)+++class AsyncRawInternalClient:+ def __init__(self, *, client_wrapper: AsyncClientWrapper):+ self._client_wrapper = client_wrapper++ async def list_permissions(+ self,+ *,+ resource_ids: typing.Sequence[str],+ resource_type: PermissionResourceType,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> AsyncHttpResponse[ListPermissionsResponse]:+ """+ Return granted actions for each requested agent, schedule, or session id.++ Parameters+ ----------+ resource_ids : typing.Sequence[str]+ Resource ids of `resource_type` to evaluate for the caller.++ resource_type : PermissionResourceType++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ AsyncHttpResponse[ListPermissionsResponse]+ Permissions keyed by resource id.+ """+ _response = await self._client_wrapper.httpx_client.request(+ "api/internal/list-permissions",+ method="POST",+ json={+ "resource_ids": resource_ids,+ "resource_type": resource_type,+ },+ headers={+ "content-type": "application/json",+ },+ request_options=request_options,+ omit=OMIT,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ ListPermissionsResponse,+ construct_type(+ type_=ListPermissionsResponse, # 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(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 401:+ raise UnauthorizedError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)diff --git a/python/trueforge_sdk/src/trueforge_sdk/internal/schedules/__init__.py b/python/trueforge_sdk/src/trueforge_sdk/internal/schedules/__init__.pynew file mode 100644index 000000000..5cde0202d--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/internal/schedules/__init__.py@@ -0,0 +1,4 @@+# This file was auto-generated by Fern from our API Definition.++# isort: skip_file+diff --git a/python/trueforge_sdk/src/trueforge_sdk/internal/schedules/client.py b/python/trueforge_sdk/src/trueforge_sdk/internal/schedules/client.pynew file mode 100644index 000000000..659200af3--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/internal/schedules/client.py@@ -0,0 +1,114 @@+# This file was auto-generated by Fern from our API Definition.++import typing++from ...core.client_wrapper import AsyncClientWrapper, SyncClientWrapper+from ...core.request_options import RequestOptions+from .raw_client import AsyncRawSchedulesClient, RawSchedulesClient++# this is used as the default value for optional parameters+OMIT = typing.cast(typing.Any, ...)+++class SchedulesClient:+ def __init__(self, *, client_wrapper: SyncClientWrapper):+ self._raw_client = RawSchedulesClient(client_wrapper=client_wrapper)++ @property+ def with_raw_response(self) -> RawSchedulesClient:+ """+ Retrieves a raw implementation of this client that returns raw responses.++ Returns+ -------+ RawSchedulesClient+ """+ return self._raw_client++ def execute_run(self, *, schedule_run_id: str, request_options: typing.Optional[RequestOptions] = None) -> None:+ """+ Execute a persisted schedule run using its saved schedule and agent.++ Parameters+ ----------+ schedule_run_id : str+ Immutable schedule run identifier.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ None++ Examples+ --------+ from trueforge_sdk import TrueForge++ client = TrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+ client.internal.schedules.execute_run(+ schedule_run_id="schedule_run_id",+ )+ """+ _response = self._raw_client.execute_run(schedule_run_id=schedule_run_id, request_options=request_options)+ return _response.data+++class AsyncSchedulesClient:+ def __init__(self, *, client_wrapper: AsyncClientWrapper):+ self._raw_client = AsyncRawSchedulesClient(client_wrapper=client_wrapper)++ @property+ def with_raw_response(self) -> AsyncRawSchedulesClient:+ """+ Retrieves a raw implementation of this client that returns raw responses.++ Returns+ -------+ AsyncRawSchedulesClient+ """+ return self._raw_client++ async def execute_run(+ self, *, schedule_run_id: str, request_options: typing.Optional[RequestOptions] = None+ ) -> None:+ """+ Execute a persisted schedule run using its saved schedule and agent.++ Parameters+ ----------+ schedule_run_id : str+ Immutable schedule run identifier.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ None++ Examples+ --------+ import asyncio++ from trueforge_sdk import AsyncTrueForge++ client = AsyncTrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+++ async def main() -> None:+ await client.internal.schedules.execute_run(+ schedule_run_id="schedule_run_id",+ )+++ asyncio.run(main())+ """+ _response = await self._raw_client.execute_run(schedule_run_id=schedule_run_id, request_options=request_options)+ return _response.datadiff --git a/python/trueforge_sdk/src/trueforge_sdk/internal/schedules/raw_client.py b/python/trueforge_sdk/src/trueforge_sdk/internal/schedules/raw_client.pynew file mode 100644index 000000000..079cb3890--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/internal/schedules/raw_client.py@@ -0,0 +1,179 @@+# 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.parse_error import ParsingError+from ...core.request_options import RequestOptions+from ...core.unchecked_base_model import construct_type+from ...errors.not_found_error import NotFoundError+from ...errors.unauthorized_error import UnauthorizedError+from ...errors.unprocessable_entity_error import UnprocessableEntityError+from ...types.request_error_response import RequestErrorResponse+from pydantic import ValidationError++# this is used as the default value for optional parameters+OMIT = typing.cast(typing.Any, ...)+++class RawSchedulesClient:+ def __init__(self, *, client_wrapper: SyncClientWrapper):+ self._client_wrapper = client_wrapper++ def execute_run(+ self, *, schedule_run_id: str, request_options: typing.Optional[RequestOptions] = None+ ) -> HttpResponse[None]:+ """+ Execute a persisted schedule run using its saved schedule and agent.++ Parameters+ ----------+ schedule_run_id : str+ Immutable schedule run identifier.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[None]+ """+ _response = self._client_wrapper.httpx_client.request(+ "api/internal/schedules/runs/execute",+ method="POST",+ json={+ "schedule_run_id": schedule_run_id,+ },+ headers={+ "content-type": "application/json",+ },+ request_options=request_options,+ omit=OMIT,+ )+ try:+ if 200 <= _response.status_code < 300:+ return HttpResponse(response=_response, data=None)+ if _response.status_code == 401:+ raise UnauthorizedError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 422:+ raise UnprocessableEntityError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)+++class AsyncRawSchedulesClient:+ def __init__(self, *, client_wrapper: AsyncClientWrapper):+ self._client_wrapper = client_wrapper++ async def execute_run(+ self, *, schedule_run_id: str, request_options: typing.Optional[RequestOptions] = None+ ) -> AsyncHttpResponse[None]:+ """+ Execute a persisted schedule run using its saved schedule and agent.++ Parameters+ ----------+ schedule_run_id : str+ Immutable schedule run identifier.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ AsyncHttpResponse[None]+ """+ _response = await self._client_wrapper.httpx_client.request(+ "api/internal/schedules/runs/execute",+ method="POST",+ json={+ "schedule_run_id": schedule_run_id,+ },+ headers={+ "content-type": "application/json",+ },+ request_options=request_options,+ omit=OMIT,+ )+ try:+ if 200 <= _response.status_code < 300:+ return AsyncHttpResponse(response=_response, data=None)+ if _response.status_code == 401:+ raise UnauthorizedError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 422:+ raise UnprocessableEntityError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)diff --git a/python/trueforge_sdk/src/trueforge_sdk/internal/sessions/__init__.py b/python/trueforge_sdk/src/trueforge_sdk/internal/sessions/__init__.pynew file mode 100644index 000000000..5cde0202d--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/internal/sessions/__init__.py@@ -0,0 +1,4 @@+# This file was auto-generated by Fern from our API Definition.++# isort: skip_file+diff --git a/python/trueforge_sdk/src/trueforge_sdk/internal/sessions/client.py b/python/trueforge_sdk/src/trueforge_sdk/internal/sessions/client.pynew file mode 100644index 000000000..3c155cf6b--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/internal/sessions/client.py@@ -0,0 +1,149 @@+# This file was auto-generated by Fern from our API Definition.++import typing++from ...core.client_wrapper import AsyncClientWrapper, SyncClientWrapper+from ...core.request_options import RequestOptions+from ...types.create_session_agent import CreateSessionAgent+from ...types.get_session_response import GetSessionResponse+from ...types.session_source_schedule import SessionSourceSchedule+from .raw_client import AsyncRawSessionsClient, RawSessionsClient++# this is used as the default value for optional parameters+OMIT = typing.cast(typing.Any, ...)+++class SessionsClient:+ def __init__(self, *, client_wrapper: SyncClientWrapper):+ self._raw_client = RawSessionsClient(client_wrapper=client_wrapper)++ @property+ def with_raw_response(self) -> RawSessionsClient:+ """+ Retrieves a raw implementation of this client that returns raw responses.++ Returns+ -------+ RawSessionsClient+ """+ return self._raw_client++ def get_or_create_by_external_id(+ self,+ *,+ agent: CreateSessionAgent,+ external_id: str,+ source: typing.Optional[SessionSourceSchedule] = OMIT,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> GetSessionResponse:+ """+ Idempotent get-or-create: returns the existing session for this `external_id`, or creates one++ Parameters+ ----------+ agent : CreateSessionAgent++ external_id : str+ Caller-supplied id unique within the tenant.++ source : typing.Optional[SessionSourceSchedule]++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ GetSessionResponse+ Session already existed for this external id.++ Examples+ --------+ from trueforge_sdk import SessionAgentNameRef, TrueForge++ client = TrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+ client.internal.sessions.get_or_create_by_external_id(+ agent=SessionAgentNameRef(+ name="name",+ ),+ external_id="external_id",+ )+ """+ _response = self._raw_client.get_or_create_by_external_id(+ agent=agent, external_id=external_id, source=source, request_options=request_options+ )+ return _response.data+++class AsyncSessionsClient:+ def __init__(self, *, client_wrapper: AsyncClientWrapper):+ self._raw_client = AsyncRawSessionsClient(client_wrapper=client_wrapper)++ @property+ def with_raw_response(self) -> AsyncRawSessionsClient:+ """+ Retrieves a raw implementation of this client that returns raw responses.++ Returns+ -------+ AsyncRawSessionsClient+ """+ return self._raw_client++ async def get_or_create_by_external_id(+ self,+ *,+ agent: CreateSessionAgent,+ external_id: str,+ source: typing.Optional[SessionSourceSchedule] = OMIT,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> GetSessionResponse:+ """+ Idempotent get-or-create: returns the existing session for this `external_id`, or creates one++ Parameters+ ----------+ agent : CreateSessionAgent++ external_id : str+ Caller-supplied id unique within the tenant.++ source : typing.Optional[SessionSourceSchedule]++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ GetSessionResponse+ Session already existed for this external id.++ Examples+ --------+ import asyncio++ from trueforge_sdk import AsyncTrueForge, SessionAgentNameRef++ client = AsyncTrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+++ async def main() -> None:+ await client.internal.sessions.get_or_create_by_external_id(+ agent=SessionAgentNameRef(+ name="name",+ ),+ external_id="external_id",+ )+++ asyncio.run(main())+ """+ _response = await self._raw_client.get_or_create_by_external_id(+ agent=agent, external_id=external_id, source=source, request_options=request_options+ )+ return _response.datadiff --git a/python/trueforge_sdk/src/trueforge_sdk/internal/sessions/raw_client.py b/python/trueforge_sdk/src/trueforge_sdk/internal/sessions/raw_client.pynew file mode 100644index 000000000..b2088667a--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/internal/sessions/raw_client.py@@ -0,0 +1,252 @@+# 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.parse_error import ParsingError+from ...core.request_options import RequestOptions+from ...core.serialization import convert_and_respect_annotation_metadata+from ...core.unchecked_base_model import construct_type+from ...errors.bad_request_error import BadRequestError+from ...errors.forbidden_error import ForbiddenError+from ...errors.not_found_error import NotFoundError+from ...errors.unprocessable_entity_error import UnprocessableEntityError+from ...types.create_session_agent import CreateSessionAgent+from ...types.get_session_response import GetSessionResponse+from ...types.request_error_response import RequestErrorResponse+from ...types.session_source_schedule import SessionSourceSchedule+from pydantic import ValidationError++# this is used as the default value for optional parameters+OMIT = typing.cast(typing.Any, ...)+++class RawSessionsClient:+ def __init__(self, *, client_wrapper: SyncClientWrapper):+ self._client_wrapper = client_wrapper++ def get_or_create_by_external_id(+ self,+ *,+ agent: CreateSessionAgent,+ external_id: str,+ source: typing.Optional[SessionSourceSchedule] = OMIT,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> HttpResponse[GetSessionResponse]:+ """+ Idempotent get-or-create: returns the existing session for this `external_id`, or creates one++ Parameters+ ----------+ agent : CreateSessionAgent++ external_id : str+ Caller-supplied id unique within the tenant.++ source : typing.Optional[SessionSourceSchedule]++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[GetSessionResponse]+ Session already existed for this external id.+ """+ _response = self._client_wrapper.httpx_client.request(+ "api/internal/sessions/get-or-create-by-external-id",+ method="POST",+ json={+ "agent": convert_and_respect_annotation_metadata(+ object_=agent, annotation=CreateSessionAgent, direction="write"+ ),+ "external_id": external_id,+ "source": convert_and_respect_annotation_metadata(+ object_=source, annotation=SessionSourceSchedule, direction="write"+ ),+ },+ headers={+ "content-type": "application/json",+ },+ request_options=request_options,+ omit=OMIT,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ GetSessionResponse,+ construct_type(+ type_=GetSessionResponse, # 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(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 403:+ raise ForbiddenError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 422:+ raise UnprocessableEntityError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)+++class AsyncRawSessionsClient:+ def __init__(self, *, client_wrapper: AsyncClientWrapper):+ self._client_wrapper = client_wrapper++ async def get_or_create_by_external_id(+ self,+ *,+ agent: CreateSessionAgent,+ external_id: str,+ source: typing.Optional[SessionSourceSchedule] = OMIT,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> AsyncHttpResponse[GetSessionResponse]:+ """+ Idempotent get-or-create: returns the existing session for this `external_id`, or creates one++ Parameters+ ----------+ agent : CreateSessionAgent++ external_id : str+ Caller-supplied id unique within the tenant.++ source : typing.Optional[SessionSourceSchedule]++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ AsyncHttpResponse[GetSessionResponse]+ Session already existed for this external id.+ """+ _response = await self._client_wrapper.httpx_client.request(+ "api/internal/sessions/get-or-create-by-external-id",+ method="POST",+ json={+ "agent": convert_and_respect_annotation_metadata(+ object_=agent, annotation=CreateSessionAgent, direction="write"+ ),+ "external_id": external_id,+ "source": convert_and_respect_annotation_metadata(+ object_=source, annotation=SessionSourceSchedule, direction="write"+ ),+ },+ headers={+ "content-type": "application/json",+ },+ request_options=request_options,+ omit=OMIT,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ GetSessionResponse,+ construct_type(+ type_=GetSessionResponse, # 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(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 403:+ raise ForbiddenError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 422:+ raise UnprocessableEntityError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)diff --git a/python/trueforge_sdk/src/trueforge_sdk/mcp_servers/__init__.py b/python/trueforge_sdk/src/trueforge_sdk/mcp_servers/__init__.pynew file mode 100644index 000000000..5cde0202d--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/mcp_servers/__init__.py@@ -0,0 +1,4 @@+# This file was auto-generated by Fern from our API Definition.++# isort: skip_file+diff --git a/python/trueforge_sdk/src/trueforge_sdk/mcp_servers/client.py b/python/trueforge_sdk/src/trueforge_sdk/mcp_servers/client.pynew file mode 100644index 000000000..4bb0e997b--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/mcp_servers/client.py@@ -0,0 +1,424 @@+# This file was auto-generated by Fern from our API Definition.++import typing++from ..core.client_wrapper import AsyncClientWrapper, SyncClientWrapper+from ..core.request_options import RequestOptions+from ..types.get_available_mcp_server_response import GetAvailableMcpServerResponse+from ..types.get_mcp_server_response import GetMcpServerResponse+from ..types.list_available_mcp_servers_response import ListAvailableMcpServersResponse+from ..types.list_mcp_server_tools_response import ListMcpServerToolsResponse+from ..types.mcp_auth_status import McpAuthStatus+from .raw_client import AsyncRawMcpServersClient, RawMcpServersClient+++class McpServersClient:+ def __init__(self, *, client_wrapper: SyncClientWrapper):+ self._raw_client = RawMcpServersClient(client_wrapper=client_wrapper)++ @property+ def with_raw_response(self) -> RawMcpServersClient:+ """+ Retrieves a raw implementation of this client that returns raw responses.++ Returns+ -------+ RawMcpServersClient+ """+ return self._raw_client++ def list(self, *, request_options: typing.Optional[RequestOptions] = None) -> ListAvailableMcpServersResponse:+ """+ Configured MCP servers as a slim name/url list for the composer.++ Parameters+ ----------+ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ ListAvailableMcpServersResponse+ All configured MCP servers (chat projection).++ Examples+ --------+ from trueforge_sdk import TrueForge++ client = TrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+ client.mcp_servers.list()+ """+ _response = self._raw_client.list(request_options=request_options)+ return _response.data++ def get(+ self, *, name: str, request_options: typing.Optional[RequestOptions] = None+ ) -> GetAvailableMcpServerResponse:+ """+ A single MCP server as the slim chat projection, with live per-user auth_status.++ Parameters+ ----------+ name : str+ MCP server name.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ GetAvailableMcpServerResponse+ The MCP server (chat projection).++ Examples+ --------+ from trueforge_sdk import TrueForge++ client = TrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+ client.mcp_servers.get(+ name="name",+ )+ """+ _response = self._raw_client.get(name=name, request_options=request_options)+ return _response.data++ def authorize(+ self,+ *,+ name: str,+ return_to: typing.Optional[str] = None,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> McpAuthStatus:+ """+ Returns current auth status. When OAuth is required, includes an authorization URL. Optional return_to is the post-consent landing path.++ Parameters+ ----------+ name : str+ MCP server name.++ return_to : typing.Optional[str]+ Same-origin path to land in the browser after consent.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ McpAuthStatus+ Either already authenticated, or an authorization URL to redirect to.++ Examples+ --------+ from trueforge_sdk import TrueForge++ client = TrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+ client.mcp_servers.authorize(+ name="name",+ )+ """+ _response = self._raw_client.authorize(name=name, return_to=return_to, request_options=request_options)+ return _response.data++ def delete_authorization(+ self, *, name: str, request_options: typing.Optional[RequestOptions] = None+ ) -> GetMcpServerResponse:+ """+ Disconnects OAuth for the MCP server when applicable and returns the updated server with auth_status. No-op when the server does not use stored OAuth tokens.++ Parameters+ ----------+ name : str+ MCP server name.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ GetMcpServerResponse+ The MCP server after disconnect.++ Examples+ --------+ from trueforge_sdk import TrueForge++ client = TrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+ client.mcp_servers.delete_authorization(+ name="name",+ )+ """+ _response = self._raw_client.delete_authorization(name=name, request_options=request_options)+ return _response.data++ def list_tools(+ self, *, name: str, request_options: typing.Optional[RequestOptions] = None+ ) -> ListMcpServerToolsResponse:+ """+ All tools exposed by the given MCP server (non-paginated), as returned by the MCP `tools/list` call.++ Parameters+ ----------+ name : str+ MCP server name.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ ListMcpServerToolsResponse+ All tools of the MCP server.++ Examples+ --------+ from trueforge_sdk import TrueForge++ client = TrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+ client.mcp_servers.list_tools(+ name="name",+ )+ """+ _response = self._raw_client.list_tools(name=name, request_options=request_options)+ return _response.data+++class AsyncMcpServersClient:+ def __init__(self, *, client_wrapper: AsyncClientWrapper):+ self._raw_client = AsyncRawMcpServersClient(client_wrapper=client_wrapper)++ @property+ def with_raw_response(self) -> AsyncRawMcpServersClient:+ """+ Retrieves a raw implementation of this client that returns raw responses.++ Returns+ -------+ AsyncRawMcpServersClient+ """+ return self._raw_client++ async def list(self, *, request_options: typing.Optional[RequestOptions] = None) -> ListAvailableMcpServersResponse:+ """+ Configured MCP servers as a slim name/url list for the composer.++ Parameters+ ----------+ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ ListAvailableMcpServersResponse+ All configured MCP servers (chat projection).++ Examples+ --------+ import asyncio++ from trueforge_sdk import AsyncTrueForge++ client = AsyncTrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+++ async def main() -> None:+ await client.mcp_servers.list()+++ asyncio.run(main())+ """+ _response = await self._raw_client.list(request_options=request_options)+ return _response.data++ async def get(+ self, *, name: str, request_options: typing.Optional[RequestOptions] = None+ ) -> GetAvailableMcpServerResponse:+ """+ A single MCP server as the slim chat projection, with live per-user auth_status.++ Parameters+ ----------+ name : str+ MCP server name.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ GetAvailableMcpServerResponse+ The MCP server (chat projection).++ Examples+ --------+ import asyncio++ from trueforge_sdk import AsyncTrueForge++ client = AsyncTrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+++ async def main() -> None:+ await client.mcp_servers.get(+ name="name",+ )+++ asyncio.run(main())+ """+ _response = await self._raw_client.get(name=name, request_options=request_options)+ return _response.data++ async def authorize(+ self,+ *,+ name: str,+ return_to: typing.Optional[str] = None,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> McpAuthStatus:+ """+ Returns current auth status. When OAuth is required, includes an authorization URL. Optional return_to is the post-consent landing path.++ Parameters+ ----------+ name : str+ MCP server name.++ return_to : typing.Optional[str]+ Same-origin path to land in the browser after consent.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ McpAuthStatus+ Either already authenticated, or an authorization URL to redirect to.++ Examples+ --------+ import asyncio++ from trueforge_sdk import AsyncTrueForge++ client = AsyncTrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+++ async def main() -> None:+ await client.mcp_servers.authorize(+ name="name",+ )+++ asyncio.run(main())+ """+ _response = await self._raw_client.authorize(name=name, return_to=return_to, request_options=request_options)+ return _response.data++ async def delete_authorization(+ self, *, name: str, request_options: typing.Optional[RequestOptions] = None+ ) -> GetMcpServerResponse:+ """+ Disconnects OAuth for the MCP server when applicable and returns the updated server with auth_status. No-op when the server does not use stored OAuth tokens.++ Parameters+ ----------+ name : str+ MCP server name.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ GetMcpServerResponse+ The MCP server after disconnect.++ Examples+ --------+ import asyncio++ from trueforge_sdk import AsyncTrueForge++ client = AsyncTrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+++ async def main() -> None:+ await client.mcp_servers.delete_authorization(+ name="name",+ )+++ asyncio.run(main())+ """+ _response = await self._raw_client.delete_authorization(name=name, request_options=request_options)+ return _response.data++ async def list_tools(+ self, *, name: str, request_options: typing.Optional[RequestOptions] = None+ ) -> ListMcpServerToolsResponse:+ """+ All tools exposed by the given MCP server (non-paginated), as returned by the MCP `tools/list` call.++ Parameters+ ----------+ name : str+ MCP server name.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ ListMcpServerToolsResponse+ All tools of the MCP server.++ Examples+ --------+ import asyncio++ from trueforge_sdk import AsyncTrueForge++ client = AsyncTrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+++ async def main() -> None:+ await client.mcp_servers.list_tools(+ name="name",+ )+++ asyncio.run(main())+ """+ _response = await self._raw_client.list_tools(name=name, request_options=request_options)+ return _response.datadiff --git a/python/trueforge_sdk/src/trueforge_sdk/mcp_servers/raw_client.py b/python/trueforge_sdk/src/trueforge_sdk/mcp_servers/raw_client.pynew file mode 100644index 000000000..a4c0cb917--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/mcp_servers/raw_client.py@@ -0,0 +1,766 @@+# 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.jsonable_encoder import encode_path_param+from ..core.parse_error import ParsingError+from ..core.request_options import RequestOptions+from ..core.unchecked_base_model import construct_type+from ..errors.bad_gateway_error import BadGatewayError+from ..errors.bad_request_error import BadRequestError+from ..errors.failed_dependency_error import FailedDependencyError+from ..errors.internal_server_error import InternalServerError+from ..errors.not_found_error import NotFoundError+from ..errors.unauthorized_error import UnauthorizedError+from ..errors.unprocessable_entity_error import UnprocessableEntityError+from ..types.get_available_mcp_server_response import GetAvailableMcpServerResponse+from ..types.get_mcp_server_response import GetMcpServerResponse+from ..types.list_available_mcp_servers_response import ListAvailableMcpServersResponse+from ..types.list_mcp_server_tools_response import ListMcpServerToolsResponse+from ..types.mcp_auth_status import McpAuthStatus+from ..types.request_error_response import RequestErrorResponse+from pydantic import ValidationError+++class RawMcpServersClient:+ def __init__(self, *, client_wrapper: SyncClientWrapper):+ self._client_wrapper = client_wrapper++ def list(+ self, *, request_options: typing.Optional[RequestOptions] = None+ ) -> HttpResponse[ListAvailableMcpServersResponse]:+ """+ Configured MCP servers as a slim name/url list for the composer.++ Parameters+ ----------+ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[ListAvailableMcpServersResponse]+ All configured MCP servers (chat projection).+ """+ _response = self._client_wrapper.httpx_client.request(+ "api/v1/mcp-servers",+ method="GET",+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ ListAvailableMcpServersResponse,+ construct_type(+ type_=ListAvailableMcpServersResponse, # type: ignore+ object_=_response.json(),+ ),+ )+ return HttpResponse(response=_response, data=_data)+ if _response.status_code == 401:+ raise UnauthorizedError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ def get(+ self, *, name: str, request_options: typing.Optional[RequestOptions] = None+ ) -> HttpResponse[GetAvailableMcpServerResponse]:+ """+ A single MCP server as the slim chat projection, with live per-user auth_status.++ Parameters+ ----------+ name : str+ MCP server name.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[GetAvailableMcpServerResponse]+ The MCP server (chat projection).+ """+ _response = self._client_wrapper.httpx_client.request(+ f"api/v1/mcp-servers/{encode_path_param(name)}",+ method="GET",+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ GetAvailableMcpServerResponse,+ construct_type(+ type_=GetAvailableMcpServerResponse, # type: ignore+ object_=_response.json(),+ ),+ )+ return HttpResponse(response=_response, data=_data)+ if _response.status_code == 401:+ raise UnauthorizedError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ def authorize(+ self,+ *,+ name: str,+ return_to: typing.Optional[str] = None,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> HttpResponse[McpAuthStatus]:+ """+ Returns current auth status. When OAuth is required, includes an authorization URL. Optional return_to is the post-consent landing path.++ Parameters+ ----------+ name : str+ MCP server name.++ return_to : typing.Optional[str]+ Same-origin path to land in the browser after consent.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[McpAuthStatus]+ Either already authenticated, or an authorization URL to redirect to.+ """+ _response = self._client_wrapper.httpx_client.request(+ f"api/v1/mcp-servers/{encode_path_param(name)}/authorize",+ method="GET",+ params={+ "return_to": return_to,+ },+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ McpAuthStatus,+ construct_type(+ type_=McpAuthStatus, # 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(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 422:+ raise UnprocessableEntityError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 424:+ raise FailedDependencyError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 500:+ raise InternalServerError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ def delete_authorization(+ self, *, name: str, request_options: typing.Optional[RequestOptions] = None+ ) -> HttpResponse[GetMcpServerResponse]:+ """+ Disconnects OAuth for the MCP server when applicable and returns the updated server with auth_status. No-op when the server does not use stored OAuth tokens.++ Parameters+ ----------+ name : str+ MCP server name.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[GetMcpServerResponse]+ The MCP server after disconnect.+ """+ _response = self._client_wrapper.httpx_client.request(+ f"api/v1/mcp-servers/{encode_path_param(name)}/authorize",+ method="DELETE",+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ GetMcpServerResponse,+ construct_type(+ type_=GetMcpServerResponse, # type: ignore+ object_=_response.json(),+ ),+ )+ return HttpResponse(response=_response, data=_data)+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ def list_tools(+ self, *, name: str, request_options: typing.Optional[RequestOptions] = None+ ) -> HttpResponse[ListMcpServerToolsResponse]:+ """+ All tools exposed by the given MCP server (non-paginated), as returned by the MCP `tools/list` call.++ Parameters+ ----------+ name : str+ MCP server name.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[ListMcpServerToolsResponse]+ All tools of the MCP server.+ """+ _response = self._client_wrapper.httpx_client.request(+ f"api/v1/mcp-servers/{encode_path_param(name)}/tools",+ method="GET",+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ ListMcpServerToolsResponse,+ construct_type(+ type_=ListMcpServerToolsResponse, # type: ignore+ object_=_response.json(),+ ),+ )+ return HttpResponse(response=_response, data=_data)+ if _response.status_code == 401:+ raise UnauthorizedError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 422:+ raise UnprocessableEntityError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 502:+ raise BadGatewayError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)+++class AsyncRawMcpServersClient:+ def __init__(self, *, client_wrapper: AsyncClientWrapper):+ self._client_wrapper = client_wrapper++ async def list(+ self, *, request_options: typing.Optional[RequestOptions] = None+ ) -> AsyncHttpResponse[ListAvailableMcpServersResponse]:+ """+ Configured MCP servers as a slim name/url list for the composer.++ Parameters+ ----------+ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ AsyncHttpResponse[ListAvailableMcpServersResponse]+ All configured MCP servers (chat projection).+ """+ _response = await self._client_wrapper.httpx_client.request(+ "api/v1/mcp-servers",+ method="GET",+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ ListAvailableMcpServersResponse,+ construct_type(+ type_=ListAvailableMcpServersResponse, # type: ignore+ object_=_response.json(),+ ),+ )+ return AsyncHttpResponse(response=_response, data=_data)+ if _response.status_code == 401:+ raise UnauthorizedError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ async def get(+ self, *, name: str, request_options: typing.Optional[RequestOptions] = None+ ) -> AsyncHttpResponse[GetAvailableMcpServerResponse]:+ """+ A single MCP server as the slim chat projection, with live per-user auth_status.++ Parameters+ ----------+ name : str+ MCP server name.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ AsyncHttpResponse[GetAvailableMcpServerResponse]+ The MCP server (chat projection).+ """+ _response = await self._client_wrapper.httpx_client.request(+ f"api/v1/mcp-servers/{encode_path_param(name)}",+ method="GET",+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ GetAvailableMcpServerResponse,+ construct_type(+ type_=GetAvailableMcpServerResponse, # type: ignore+ object_=_response.json(),+ ),+ )+ return AsyncHttpResponse(response=_response, data=_data)+ if _response.status_code == 401:+ raise UnauthorizedError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ async def authorize(+ self,+ *,+ name: str,+ return_to: typing.Optional[str] = None,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> AsyncHttpResponse[McpAuthStatus]:+ """+ Returns current auth status. When OAuth is required, includes an authorization URL. Optional return_to is the post-consent landing path.++ Parameters+ ----------+ name : str+ MCP server name.++ return_to : typing.Optional[str]+ Same-origin path to land in the browser after consent.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ AsyncHttpResponse[McpAuthStatus]+ Either already authenticated, or an authorization URL to redirect to.+ """+ _response = await self._client_wrapper.httpx_client.request(+ f"api/v1/mcp-servers/{encode_path_param(name)}/authorize",+ method="GET",+ params={+ "return_to": return_to,+ },+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ McpAuthStatus,+ construct_type(+ type_=McpAuthStatus, # 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(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 422:+ raise UnprocessableEntityError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 424:+ raise FailedDependencyError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 500:+ raise InternalServerError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ async def delete_authorization(+ self, *, name: str, request_options: typing.Optional[RequestOptions] = None+ ) -> AsyncHttpResponse[GetMcpServerResponse]:+ """+ Disconnects OAuth for the MCP server when applicable and returns the updated server with auth_status. No-op when the server does not use stored OAuth tokens.++ Parameters+ ----------+ name : str+ MCP server name.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ AsyncHttpResponse[GetMcpServerResponse]+ The MCP server after disconnect.+ """+ _response = await self._client_wrapper.httpx_client.request(+ f"api/v1/mcp-servers/{encode_path_param(name)}/authorize",+ method="DELETE",+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ GetMcpServerResponse,+ construct_type(+ type_=GetMcpServerResponse, # type: ignore+ object_=_response.json(),+ ),+ )+ return AsyncHttpResponse(response=_response, data=_data)+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ async def list_tools(+ self, *, name: str, request_options: typing.Optional[RequestOptions] = None+ ) -> AsyncHttpResponse[ListMcpServerToolsResponse]:+ """+ All tools exposed by the given MCP server (non-paginated), as returned by the MCP `tools/list` call.++ Parameters+ ----------+ name : str+ MCP server name.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ AsyncHttpResponse[ListMcpServerToolsResponse]+ All tools of the MCP server.+ """+ _response = await self._client_wrapper.httpx_client.request(+ f"api/v1/mcp-servers/{encode_path_param(name)}/tools",+ method="GET",+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ ListMcpServerToolsResponse,+ construct_type(+ type_=ListMcpServerToolsResponse, # type: ignore+ object_=_response.json(),+ ),+ )+ return AsyncHttpResponse(response=_response, data=_data)+ if _response.status_code == 401:+ raise UnauthorizedError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 422:+ raise UnprocessableEntityError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 502:+ raise BadGatewayError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)diff --git a/python/trueforge_sdk/src/trueforge_sdk/models/__init__.py b/python/trueforge_sdk/src/trueforge_sdk/models/__init__.pynew file mode 100644index 000000000..5cde0202d--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/models/__init__.py@@ -0,0 +1,4 @@+# This file was auto-generated by Fern from our API Definition.++# isort: skip_file+diff --git a/python/trueforge_sdk/src/trueforge_sdk/models/client.py b/python/trueforge_sdk/src/trueforge_sdk/models/client.pynew file mode 100644index 000000000..b6e2390f6--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/models/client.py@@ -0,0 +1,102 @@+# This file was auto-generated by Fern from our API Definition.++import typing++from ..core.client_wrapper import AsyncClientWrapper, SyncClientWrapper+from ..core.request_options import RequestOptions+from ..types.list_available_models_response import ListAvailableModelsResponse+from .raw_client import AsyncRawModelsClient, RawModelsClient+++class ModelsClient:+ def __init__(self, *, client_wrapper: SyncClientWrapper):+ self._raw_client = RawModelsClient(client_wrapper=client_wrapper)++ @property+ def with_raw_response(self) -> RawModelsClient:+ """+ Retrieves a raw implementation of this client that returns raw responses.++ Returns+ -------+ RawModelsClient+ """+ return self._raw_client++ def list(self, *, request_options: typing.Optional[RequestOptions] = None) -> ListAvailableModelsResponse:+ """+ Configured models as a slim FQN list for the composer.++ Parameters+ ----------+ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ ListAvailableModelsResponse+ All configured models (chat projection).++ Examples+ --------+ from trueforge_sdk import TrueForge++ client = TrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+ client.models.list()+ """+ _response = self._raw_client.list(request_options=request_options)+ return _response.data+++class AsyncModelsClient:+ def __init__(self, *, client_wrapper: AsyncClientWrapper):+ self._raw_client = AsyncRawModelsClient(client_wrapper=client_wrapper)++ @property+ def with_raw_response(self) -> AsyncRawModelsClient:+ """+ Retrieves a raw implementation of this client that returns raw responses.++ Returns+ -------+ AsyncRawModelsClient+ """+ return self._raw_client++ async def list(self, *, request_options: typing.Optional[RequestOptions] = None) -> ListAvailableModelsResponse:+ """+ Configured models as a slim FQN list for the composer.++ Parameters+ ----------+ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ ListAvailableModelsResponse+ All configured models (chat projection).++ Examples+ --------+ import asyncio++ from trueforge_sdk import AsyncTrueForge++ client = AsyncTrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+++ async def main() -> None:+ await client.models.list()+++ asyncio.run(main())+ """+ _response = await self._raw_client.list(request_options=request_options)+ return _response.datadiff --git a/python/trueforge_sdk/src/trueforge_sdk/models/raw_client.py b/python/trueforge_sdk/src/trueforge_sdk/models/raw_client.pynew file mode 100644index 000000000..3973cba4e--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/models/raw_client.py@@ -0,0 +1,127 @@+# 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.parse_error import ParsingError+from ..core.request_options import RequestOptions+from ..core.unchecked_base_model import construct_type+from ..errors.unauthorized_error import UnauthorizedError+from ..types.list_available_models_response import ListAvailableModelsResponse+from ..types.request_error_response import RequestErrorResponse+from pydantic import ValidationError+++class RawModelsClient:+ def __init__(self, *, client_wrapper: SyncClientWrapper):+ self._client_wrapper = client_wrapper++ def list(+ self, *, request_options: typing.Optional[RequestOptions] = None+ ) -> HttpResponse[ListAvailableModelsResponse]:+ """+ Configured models as a slim FQN list for the composer.++ Parameters+ ----------+ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[ListAvailableModelsResponse]+ All configured models (chat projection).+ """+ _response = self._client_wrapper.httpx_client.request(+ "api/v1/models",+ method="GET",+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ ListAvailableModelsResponse,+ construct_type(+ type_=ListAvailableModelsResponse, # type: ignore+ object_=_response.json(),+ ),+ )+ return HttpResponse(response=_response, data=_data)+ if _response.status_code == 401:+ raise UnauthorizedError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)+++class AsyncRawModelsClient:+ def __init__(self, *, client_wrapper: AsyncClientWrapper):+ self._client_wrapper = client_wrapper++ async def list(+ self, *, request_options: typing.Optional[RequestOptions] = None+ ) -> AsyncHttpResponse[ListAvailableModelsResponse]:+ """+ Configured models as a slim FQN list for the composer.++ Parameters+ ----------+ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ AsyncHttpResponse[ListAvailableModelsResponse]+ All configured models (chat projection).+ """+ _response = await self._client_wrapper.httpx_client.request(+ "api/v1/models",+ method="GET",+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ ListAvailableModelsResponse,+ construct_type(+ type_=ListAvailableModelsResponse, # type: ignore+ object_=_response.json(),+ ),+ )+ return AsyncHttpResponse(response=_response, data=_data)+ if _response.status_code == 401:+ raise UnauthorizedError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)diff --git a/python/trueforge_sdk/src/trueforge_sdk/py.typed b/python/trueforge_sdk/src/trueforge_sdk/py.typednew file mode 100644index 000000000..e69de29bbdiff --git a/python/trueforge_sdk/src/trueforge_sdk/schedules/__init__.py b/python/trueforge_sdk/src/trueforge_sdk/schedules/__init__.pynew file mode 100644index 000000000..5cde0202d--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/schedules/__init__.py@@ -0,0 +1,4 @@+# This file was auto-generated by Fern from our API Definition.++# isort: skip_file+diff --git a/python/trueforge_sdk/src/trueforge_sdk/schedules/client.py b/python/trueforge_sdk/src/trueforge_sdk/schedules/client.pynew file mode 100644index 000000000..49f05994d--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/schedules/client.py@@ -0,0 +1,705 @@+# This file was auto-generated by Fern from our API Definition.++import typing++from ..core.client_wrapper import AsyncClientWrapper, SyncClientWrapper+from ..core.request_options import RequestOptions+from ..types.create_schedule_run_response import CreateScheduleRunResponse+from ..types.delete_schedule_response import DeleteScheduleResponse+from ..types.get_schedule_response import GetScheduleResponse+from ..types.list_schedule_runs_response import ListScheduleRunsResponse+from ..types.list_schedules_response import ListSchedulesResponse+from ..types.resource_name import ResourceName+from ..types.schedule_manifest import ScheduleManifest+from .raw_client import AsyncRawSchedulesClient, RawSchedulesClient++# this is used as the default value for optional parameters+OMIT = typing.cast(typing.Any, ...)+++class SchedulesClient:+ def __init__(self, *, client_wrapper: SyncClientWrapper):+ self._raw_client = RawSchedulesClient(client_wrapper=client_wrapper)++ @property+ def with_raw_response(self) -> RawSchedulesClient:+ """+ Retrieves a raw implementation of this client that returns raw responses.++ Returns+ -------+ RawSchedulesClient+ """+ return self._raw_client++ def list(+ self,+ *,+ limit: typing.Optional[int] = 25,+ page_token: typing.Optional[str] = None,+ agent_names: typing.Optional[str] = None,+ created_by_me: typing.Optional[bool] = None,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> ListSchedulesResponse:+ """+ List schedules for the tenant, newest first.++ Parameters+ ----------+ limit : typing.Optional[int]+ Page size. Defaults to 25++ page_token : typing.Optional[str]+ Opaque token from a previous response `next_page_token`.++ agent_names : typing.Optional[str]+ Filter by one or more agent names (comma-separated). When set, at least one name is required.++ created_by_me : typing.Optional[bool]+ When true, only schedules created by the authenticated subject.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ ListSchedulesResponse+ Paginated matching schedules.++ Examples+ --------+ from trueforge_sdk import TrueForge++ client = TrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+ client.schedules.list()+ """+ _response = self._raw_client.list(+ limit=limit,+ page_token=page_token,+ agent_names=agent_names,+ created_by_me=created_by_me,+ request_options=request_options,+ )+ return _response.data++ def create(+ self,+ *,+ agent_name: ResourceName,+ manifest: ScheduleManifest,+ name: ResourceName,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> GetScheduleResponse:+ """+ Create a schedule for an existing agent (by name) and add its first pending run when active.++ Parameters+ ----------+ agent_name : ResourceName++ manifest : ScheduleManifest++ name : ResourceName++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ GetScheduleResponse+ Created schedule.++ Examples+ --------+ from trueforge_sdk import ScheduleManifest, TrueForge++ client = TrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+ client.schedules.create(+ agent_name="agent_name",+ manifest=ScheduleManifest(+ cron="cron",+ task="task",+ ),+ name="name",+ )+ """+ _response = self._raw_client.create(+ agent_name=agent_name, manifest=manifest, name=name, request_options=request_options+ )+ return _response.data++ def create_run(+ self, *, schedule_id: str, request_options: typing.Optional[RequestOptions] = None+ ) -> CreateScheduleRunResponse:+ """+ Start a schedule run immediately using the schedule task. Does not replace or advance the cron pending run.++ Parameters+ ----------+ schedule_id : str+ Immutable schedule identifier.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ CreateScheduleRunResponse+ Run created.++ Examples+ --------+ from trueforge_sdk import TrueForge++ client = TrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+ client.schedules.create_run(+ schedule_id="schedule_id",+ )+ """+ _response = self._raw_client.create_run(schedule_id=schedule_id, request_options=request_options)+ return _response.data++ def get(self, *, schedule_id: str, request_options: typing.Optional[RequestOptions] = None) -> GetScheduleResponse:+ """+ Get a schedule by id.++ Parameters+ ----------+ schedule_id : str+ Immutable schedule identifier.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ GetScheduleResponse+ The schedule.++ Examples+ --------+ from trueforge_sdk import TrueForge++ client = TrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+ client.schedules.get(+ schedule_id="schedule_id",+ )+ """+ _response = self._raw_client.get(schedule_id=schedule_id, request_options=request_options)+ return _response.data++ def update(+ self,+ *,+ schedule_id: str,+ manifest: ScheduleManifest,+ name: ResourceName,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> GetScheduleResponse:+ """+ Replace name and manifest; replaces or drops the pending run when status/cron/timezone change.++ Parameters+ ----------+ schedule_id : str+ Immutable schedule identifier.++ manifest : ScheduleManifest++ name : ResourceName++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ GetScheduleResponse+ Updated schedule.++ Examples+ --------+ from trueforge_sdk import ScheduleManifest, TrueForge++ client = TrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+ client.schedules.update(+ schedule_id="schedule_id",+ manifest=ScheduleManifest(+ cron="cron",+ task="task",+ ),+ name="name",+ )+ """+ _response = self._raw_client.update(+ schedule_id=schedule_id, manifest=manifest, name=name, request_options=request_options+ )+ return _response.data++ def delete(+ self, *, schedule_id: str, request_options: typing.Optional[RequestOptions] = None+ ) -> DeleteScheduleResponse:+ """+ Delete a schedule and its runs. Idempotent.++ Parameters+ ----------+ schedule_id : str+ Immutable schedule identifier.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ DeleteScheduleResponse+ Deleted.++ Examples+ --------+ from trueforge_sdk import TrueForge++ client = TrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+ client.schedules.delete(+ schedule_id="schedule_id",+ )+ """+ _response = self._raw_client.delete(schedule_id=schedule_id, request_options=request_options)+ return _response.data++ def list_runs(+ self,+ *,+ schedule_id: str,+ limit: typing.Optional[int] = 25,+ page_token: typing.Optional[str] = None,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> ListScheduleRunsResponse:+ """+ List runs of a schedule, newest `scheduled_for` first. Available to its creator or a manager of its agent.++ Parameters+ ----------+ schedule_id : str+ Immutable schedule identifier.++ limit : typing.Optional[int]+ Page size. Defaults to 25++ page_token : typing.Optional[str]+ Opaque token from a previous response `next_page_token`.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ ListScheduleRunsResponse+ Paginated runs of the schedule.++ Examples+ --------+ from trueforge_sdk import TrueForge++ client = TrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+ client.schedules.list_runs(+ schedule_id="schedule_id",+ )+ """+ _response = self._raw_client.list_runs(+ schedule_id=schedule_id, limit=limit, page_token=page_token, request_options=request_options+ )+ return _response.data+++class AsyncSchedulesClient:+ def __init__(self, *, client_wrapper: AsyncClientWrapper):+ self._raw_client = AsyncRawSchedulesClient(client_wrapper=client_wrapper)++ @property+ def with_raw_response(self) -> AsyncRawSchedulesClient:+ """+ Retrieves a raw implementation of this client that returns raw responses.++ Returns+ -------+ AsyncRawSchedulesClient+ """+ return self._raw_client++ async def list(+ self,+ *,+ limit: typing.Optional[int] = 25,+ page_token: typing.Optional[str] = None,+ agent_names: typing.Optional[str] = None,+ created_by_me: typing.Optional[bool] = None,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> ListSchedulesResponse:+ """+ List schedules for the tenant, newest first.++ Parameters+ ----------+ limit : typing.Optional[int]+ Page size. Defaults to 25++ page_token : typing.Optional[str]+ Opaque token from a previous response `next_page_token`.++ agent_names : typing.Optional[str]+ Filter by one or more agent names (comma-separated). When set, at least one name is required.++ created_by_me : typing.Optional[bool]+ When true, only schedules created by the authenticated subject.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ ListSchedulesResponse+ Paginated matching schedules.++ Examples+ --------+ import asyncio++ from trueforge_sdk import AsyncTrueForge++ client = AsyncTrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+++ async def main() -> None:+ await client.schedules.list()+++ asyncio.run(main())+ """+ _response = await self._raw_client.list(+ limit=limit,+ page_token=page_token,+ agent_names=agent_names,+ created_by_me=created_by_me,+ request_options=request_options,+ )+ return _response.data++ async def create(+ self,+ *,+ agent_name: ResourceName,+ manifest: ScheduleManifest,+ name: ResourceName,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> GetScheduleResponse:+ """+ Create a schedule for an existing agent (by name) and add its first pending run when active.++ Parameters+ ----------+ agent_name : ResourceName++ manifest : ScheduleManifest++ name : ResourceName++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ GetScheduleResponse+ Created schedule.++ Examples+ --------+ import asyncio++ from trueforge_sdk import AsyncTrueForge, ScheduleManifest++ client = AsyncTrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+++ async def main() -> None:+ await client.schedules.create(+ agent_name="agent_name",+ manifest=ScheduleManifest(+ cron="cron",+ task="task",+ ),+ name="name",+ )+++ asyncio.run(main())+ """+ _response = await self._raw_client.create(+ agent_name=agent_name, manifest=manifest, name=name, request_options=request_options+ )+ return _response.data++ async def create_run(+ self, *, schedule_id: str, request_options: typing.Optional[RequestOptions] = None+ ) -> CreateScheduleRunResponse:+ """+ Start a schedule run immediately using the schedule task. Does not replace or advance the cron pending run.++ Parameters+ ----------+ schedule_id : str+ Immutable schedule identifier.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ CreateScheduleRunResponse+ Run created.++ Examples+ --------+ import asyncio++ from trueforge_sdk import AsyncTrueForge++ client = AsyncTrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+++ async def main() -> None:+ await client.schedules.create_run(+ schedule_id="schedule_id",+ )+++ asyncio.run(main())+ """+ _response = await self._raw_client.create_run(schedule_id=schedule_id, request_options=request_options)+ return _response.data++ async def get(+ self, *, schedule_id: str, request_options: typing.Optional[RequestOptions] = None+ ) -> GetScheduleResponse:+ """+ Get a schedule by id.++ Parameters+ ----------+ schedule_id : str+ Immutable schedule identifier.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ GetScheduleResponse+ The schedule.++ Examples+ --------+ import asyncio++ from trueforge_sdk import AsyncTrueForge++ client = AsyncTrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+++ async def main() -> None:+ await client.schedules.get(+ schedule_id="schedule_id",+ )+++ asyncio.run(main())+ """+ _response = await self._raw_client.get(schedule_id=schedule_id, request_options=request_options)+ return _response.data++ async def update(+ self,+ *,+ schedule_id: str,+ manifest: ScheduleManifest,+ name: ResourceName,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> GetScheduleResponse:+ """+ Replace name and manifest; replaces or drops the pending run when status/cron/timezone change.++ Parameters+ ----------+ schedule_id : str+ Immutable schedule identifier.++ manifest : ScheduleManifest++ name : ResourceName++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ GetScheduleResponse+ Updated schedule.++ Examples+ --------+ import asyncio++ from trueforge_sdk import AsyncTrueForge, ScheduleManifest++ client = AsyncTrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+++ async def main() -> None:+ await client.schedules.update(+ schedule_id="schedule_id",+ manifest=ScheduleManifest(+ cron="cron",+ task="task",+ ),+ name="name",+ )+++ asyncio.run(main())+ """+ _response = await self._raw_client.update(+ schedule_id=schedule_id, manifest=manifest, name=name, request_options=request_options+ )+ return _response.data++ async def delete(+ self, *, schedule_id: str, request_options: typing.Optional[RequestOptions] = None+ ) -> DeleteScheduleResponse:+ """+ Delete a schedule and its runs. Idempotent.++ Parameters+ ----------+ schedule_id : str+ Immutable schedule identifier.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ DeleteScheduleResponse+ Deleted.++ Examples+ --------+ import asyncio++ from trueforge_sdk import AsyncTrueForge++ client = AsyncTrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+++ async def main() -> None:+ await client.schedules.delete(+ schedule_id="schedule_id",+ )+++ asyncio.run(main())+ """+ _response = await self._raw_client.delete(schedule_id=schedule_id, request_options=request_options)+ return _response.data++ async def list_runs(+ self,+ *,+ schedule_id: str,+ limit: typing.Optional[int] = 25,+ page_token: typing.Optional[str] = None,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> ListScheduleRunsResponse:+ """+ List runs of a schedule, newest `scheduled_for` first. Available to its creator or a manager of its agent.++ Parameters+ ----------+ schedule_id : str+ Immutable schedule identifier.++ limit : typing.Optional[int]+ Page size. Defaults to 25++ page_token : typing.Optional[str]+ Opaque token from a previous response `next_page_token`.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ ListScheduleRunsResponse+ Paginated runs of the schedule.++ Examples+ --------+ import asyncio++ from trueforge_sdk import AsyncTrueForge++ client = AsyncTrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+++ async def main() -> None:+ await client.schedules.list_runs(+ schedule_id="schedule_id",+ )+++ asyncio.run(main())+ """+ _response = await self._raw_client.list_runs(+ schedule_id=schedule_id, limit=limit, page_token=page_token, request_options=request_options+ )+ return _response.datadiff --git a/python/trueforge_sdk/src/trueforge_sdk/schedules/raw_client.py b/python/trueforge_sdk/src/trueforge_sdk/schedules/raw_client.pynew file mode 100644index 000000000..a227ae6f8--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/schedules/raw_client.py@@ -0,0 +1,1267 @@+# 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.jsonable_encoder import encode_path_param+from ..core.parse_error import ParsingError+from ..core.request_options import RequestOptions+from ..core.serialization import convert_and_respect_annotation_metadata+from ..core.unchecked_base_model import construct_type+from ..errors.bad_request_error import BadRequestError+from ..errors.conflict_error import ConflictError+from ..errors.forbidden_error import ForbiddenError+from ..errors.not_found_error import NotFoundError+from ..errors.unauthorized_error import UnauthorizedError+from ..errors.unprocessable_entity_error import UnprocessableEntityError+from ..types.create_schedule_run_response import CreateScheduleRunResponse+from ..types.delete_schedule_response import DeleteScheduleResponse+from ..types.get_schedule_response import GetScheduleResponse+from ..types.list_schedule_runs_response import ListScheduleRunsResponse+from ..types.list_schedules_response import ListSchedulesResponse+from ..types.request_error_response import RequestErrorResponse+from ..types.resource_name import ResourceName+from ..types.schedule_manifest import ScheduleManifest+from pydantic import ValidationError++# this is used as the default value for optional parameters+OMIT = typing.cast(typing.Any, ...)+++class RawSchedulesClient:+ def __init__(self, *, client_wrapper: SyncClientWrapper):+ self._client_wrapper = client_wrapper++ def list(+ self,+ *,+ limit: typing.Optional[int] = 25,+ page_token: typing.Optional[str] = None,+ agent_names: typing.Optional[str] = None,+ created_by_me: typing.Optional[bool] = None,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> HttpResponse[ListSchedulesResponse]:+ """+ List schedules for the tenant, newest first.++ Parameters+ ----------+ limit : typing.Optional[int]+ Page size. Defaults to 25++ page_token : typing.Optional[str]+ Opaque token from a previous response `next_page_token`.++ agent_names : typing.Optional[str]+ Filter by one or more agent names (comma-separated). When set, at least one name is required.++ created_by_me : typing.Optional[bool]+ When true, only schedules created by the authenticated subject.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[ListSchedulesResponse]+ Paginated matching schedules.+ """+ _response = self._client_wrapper.httpx_client.request(+ "api/v1/schedules",+ method="GET",+ params={+ "limit": limit,+ "page_token": page_token,+ "agent_names": agent_names,+ "created_by_me": created_by_me,+ },+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ ListSchedulesResponse,+ construct_type(+ type_=ListSchedulesResponse, # 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(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 401:+ raise UnauthorizedError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ def create(+ self,+ *,+ agent_name: ResourceName,+ manifest: ScheduleManifest,+ name: ResourceName,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> HttpResponse[GetScheduleResponse]:+ """+ Create a schedule for an existing agent (by name) and add its first pending run when active.++ Parameters+ ----------+ agent_name : ResourceName++ manifest : ScheduleManifest++ name : ResourceName++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[GetScheduleResponse]+ Created schedule.+ """+ _response = self._client_wrapper.httpx_client.request(+ "api/v1/schedules",+ method="POST",+ json={+ "agent_name": agent_name,+ "manifest": convert_and_respect_annotation_metadata(+ object_=manifest, annotation=ScheduleManifest, direction="write"+ ),+ "name": name,+ },+ headers={+ "content-type": "application/json",+ },+ request_options=request_options,+ omit=OMIT,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ GetScheduleResponse,+ construct_type(+ type_=GetScheduleResponse, # 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(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 409:+ raise ConflictError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ def create_run(+ self, *, schedule_id: str, request_options: typing.Optional[RequestOptions] = None+ ) -> HttpResponse[CreateScheduleRunResponse]:+ """+ Start a schedule run immediately using the schedule task. Does not replace or advance the cron pending run.++ Parameters+ ----------+ schedule_id : str+ Immutable schedule identifier.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[CreateScheduleRunResponse]+ Run created.+ """+ _response = self._client_wrapper.httpx_client.request(+ "api/v1/schedules/runs",+ method="POST",+ json={+ "schedule_id": schedule_id,+ },+ headers={+ "content-type": "application/json",+ },+ request_options=request_options,+ omit=OMIT,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ CreateScheduleRunResponse,+ construct_type(+ type_=CreateScheduleRunResponse, # 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(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 403:+ raise ForbiddenError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 409:+ raise ConflictError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 422:+ raise UnprocessableEntityError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ def get(+ self, *, schedule_id: str, request_options: typing.Optional[RequestOptions] = None+ ) -> HttpResponse[GetScheduleResponse]:+ """+ Get a schedule by id.++ Parameters+ ----------+ schedule_id : str+ Immutable schedule identifier.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[GetScheduleResponse]+ The schedule.+ """+ _response = self._client_wrapper.httpx_client.request(+ f"api/v1/schedules/{encode_path_param(schedule_id)}",+ method="GET",+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ GetScheduleResponse,+ construct_type(+ type_=GetScheduleResponse, # type: ignore+ object_=_response.json(),+ ),+ )+ return HttpResponse(response=_response, data=_data)+ if _response.status_code == 403:+ raise ForbiddenError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ def update(+ self,+ *,+ schedule_id: str,+ manifest: ScheduleManifest,+ name: ResourceName,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> HttpResponse[GetScheduleResponse]:+ """+ Replace name and manifest; replaces or drops the pending run when status/cron/timezone change.++ Parameters+ ----------+ schedule_id : str+ Immutable schedule identifier.++ manifest : ScheduleManifest++ name : ResourceName++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[GetScheduleResponse]+ Updated schedule.+ """+ _response = self._client_wrapper.httpx_client.request(+ f"api/v1/schedules/{encode_path_param(schedule_id)}",+ method="PUT",+ json={+ "manifest": convert_and_respect_annotation_metadata(+ object_=manifest, annotation=ScheduleManifest, direction="write"+ ),+ "name": name,+ },+ headers={+ "content-type": "application/json",+ },+ request_options=request_options,+ omit=OMIT,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ GetScheduleResponse,+ construct_type(+ type_=GetScheduleResponse, # 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(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 403:+ raise ForbiddenError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 409:+ raise ConflictError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ def delete(+ self, *, schedule_id: str, request_options: typing.Optional[RequestOptions] = None+ ) -> HttpResponse[DeleteScheduleResponse]:+ """+ Delete a schedule and its runs. Idempotent.++ Parameters+ ----------+ schedule_id : str+ Immutable schedule identifier.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[DeleteScheduleResponse]+ Deleted.+ """+ _response = self._client_wrapper.httpx_client.request(+ f"api/v1/schedules/{encode_path_param(schedule_id)}",+ method="DELETE",+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ DeleteScheduleResponse,+ construct_type(+ type_=DeleteScheduleResponse, # type: ignore+ object_=_response.json(),+ ),+ )+ return HttpResponse(response=_response, data=_data)+ if _response.status_code == 401:+ raise UnauthorizedError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 403:+ raise ForbiddenError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ def list_runs(+ self,+ *,+ schedule_id: str,+ limit: typing.Optional[int] = 25,+ page_token: typing.Optional[str] = None,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> HttpResponse[ListScheduleRunsResponse]:+ """+ List runs of a schedule, newest `scheduled_for` first. Available to its creator or a manager of its agent.++ Parameters+ ----------+ schedule_id : str+ Immutable schedule identifier.++ limit : typing.Optional[int]+ Page size. Defaults to 25++ page_token : typing.Optional[str]+ Opaque token from a previous response `next_page_token`.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[ListScheduleRunsResponse]+ Paginated runs of the schedule.+ """+ _response = self._client_wrapper.httpx_client.request(+ f"api/v1/schedules/{encode_path_param(schedule_id)}/runs",+ method="GET",+ params={+ "limit": limit,+ "page_token": page_token,+ },+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ ListScheduleRunsResponse,+ construct_type(+ type_=ListScheduleRunsResponse, # 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(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 403:+ raise ForbiddenError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)+++class AsyncRawSchedulesClient:+ def __init__(self, *, client_wrapper: AsyncClientWrapper):+ self._client_wrapper = client_wrapper++ async def list(+ self,+ *,+ limit: typing.Optional[int] = 25,+ page_token: typing.Optional[str] = None,+ agent_names: typing.Optional[str] = None,+ created_by_me: typing.Optional[bool] = None,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> AsyncHttpResponse[ListSchedulesResponse]:+ """+ List schedules for the tenant, newest first.++ Parameters+ ----------+ limit : typing.Optional[int]+ Page size. Defaults to 25++ page_token : typing.Optional[str]+ Opaque token from a previous response `next_page_token`.++ agent_names : typing.Optional[str]+ Filter by one or more agent names (comma-separated). When set, at least one name is required.++ created_by_me : typing.Optional[bool]+ When true, only schedules created by the authenticated subject.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ AsyncHttpResponse[ListSchedulesResponse]+ Paginated matching schedules.+ """+ _response = await self._client_wrapper.httpx_client.request(+ "api/v1/schedules",+ method="GET",+ params={+ "limit": limit,+ "page_token": page_token,+ "agent_names": agent_names,+ "created_by_me": created_by_me,+ },+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ ListSchedulesResponse,+ construct_type(+ type_=ListSchedulesResponse, # 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(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 401:+ raise UnauthorizedError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ async def create(+ self,+ *,+ agent_name: ResourceName,+ manifest: ScheduleManifest,+ name: ResourceName,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> AsyncHttpResponse[GetScheduleResponse]:+ """+ Create a schedule for an existing agent (by name) and add its first pending run when active.++ Parameters+ ----------+ agent_name : ResourceName++ manifest : ScheduleManifest++ name : ResourceName++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ AsyncHttpResponse[GetScheduleResponse]+ Created schedule.+ """+ _response = await self._client_wrapper.httpx_client.request(+ "api/v1/schedules",+ method="POST",+ json={+ "agent_name": agent_name,+ "manifest": convert_and_respect_annotation_metadata(+ object_=manifest, annotation=ScheduleManifest, direction="write"+ ),+ "name": name,+ },+ headers={+ "content-type": "application/json",+ },+ request_options=request_options,+ omit=OMIT,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ GetScheduleResponse,+ construct_type(+ type_=GetScheduleResponse, # 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(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 409:+ raise ConflictError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ async def create_run(+ self, *, schedule_id: str, request_options: typing.Optional[RequestOptions] = None+ ) -> AsyncHttpResponse[CreateScheduleRunResponse]:+ """+ Start a schedule run immediately using the schedule task. Does not replace or advance the cron pending run.++ Parameters+ ----------+ schedule_id : str+ Immutable schedule identifier.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ AsyncHttpResponse[CreateScheduleRunResponse]+ Run created.+ """+ _response = await self._client_wrapper.httpx_client.request(+ "api/v1/schedules/runs",+ method="POST",+ json={+ "schedule_id": schedule_id,+ },+ headers={+ "content-type": "application/json",+ },+ request_options=request_options,+ omit=OMIT,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ CreateScheduleRunResponse,+ construct_type(+ type_=CreateScheduleRunResponse, # 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(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 403:+ raise ForbiddenError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 409:+ raise ConflictError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 422:+ raise UnprocessableEntityError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ async def get(+ self, *, schedule_id: str, request_options: typing.Optional[RequestOptions] = None+ ) -> AsyncHttpResponse[GetScheduleResponse]:+ """+ Get a schedule by id.++ Parameters+ ----------+ schedule_id : str+ Immutable schedule identifier.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ AsyncHttpResponse[GetScheduleResponse]+ The schedule.+ """+ _response = await self._client_wrapper.httpx_client.request(+ f"api/v1/schedules/{encode_path_param(schedule_id)}",+ method="GET",+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ GetScheduleResponse,+ construct_type(+ type_=GetScheduleResponse, # type: ignore+ object_=_response.json(),+ ),+ )+ return AsyncHttpResponse(response=_response, data=_data)+ if _response.status_code == 403:+ raise ForbiddenError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ async def update(+ self,+ *,+ schedule_id: str,+ manifest: ScheduleManifest,+ name: ResourceName,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> AsyncHttpResponse[GetScheduleResponse]:+ """+ Replace name and manifest; replaces or drops the pending run when status/cron/timezone change.++ Parameters+ ----------+ schedule_id : str+ Immutable schedule identifier.++ manifest : ScheduleManifest++ name : ResourceName++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ AsyncHttpResponse[GetScheduleResponse]+ Updated schedule.+ """+ _response = await self._client_wrapper.httpx_client.request(+ f"api/v1/schedules/{encode_path_param(schedule_id)}",+ method="PUT",+ json={+ "manifest": convert_and_respect_annotation_metadata(+ object_=manifest, annotation=ScheduleManifest, direction="write"+ ),+ "name": name,+ },+ headers={+ "content-type": "application/json",+ },+ request_options=request_options,+ omit=OMIT,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ GetScheduleResponse,+ construct_type(+ type_=GetScheduleResponse, # 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(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 403:+ raise ForbiddenError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 409:+ raise ConflictError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ async def delete(+ self, *, schedule_id: str, request_options: typing.Optional[RequestOptions] = None+ ) -> AsyncHttpResponse[DeleteScheduleResponse]:+ """+ Delete a schedule and its runs. Idempotent.++ Parameters+ ----------+ schedule_id : str+ Immutable schedule identifier.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ AsyncHttpResponse[DeleteScheduleResponse]+ Deleted.+ """+ _response = await self._client_wrapper.httpx_client.request(+ f"api/v1/schedules/{encode_path_param(schedule_id)}",+ method="DELETE",+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ DeleteScheduleResponse,+ construct_type(+ type_=DeleteScheduleResponse, # type: ignore+ object_=_response.json(),+ ),+ )+ return AsyncHttpResponse(response=_response, data=_data)+ if _response.status_code == 401:+ raise UnauthorizedError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 403:+ raise ForbiddenError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ async def list_runs(+ self,+ *,+ schedule_id: str,+ limit: typing.Optional[int] = 25,+ page_token: typing.Optional[str] = None,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> AsyncHttpResponse[ListScheduleRunsResponse]:+ """+ List runs of a schedule, newest `scheduled_for` first. Available to its creator or a manager of its agent.++ Parameters+ ----------+ schedule_id : str+ Immutable schedule identifier.++ limit : typing.Optional[int]+ Page size. Defaults to 25++ page_token : typing.Optional[str]+ Opaque token from a previous response `next_page_token`.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ AsyncHttpResponse[ListScheduleRunsResponse]+ Paginated runs of the schedule.+ """+ _response = await self._client_wrapper.httpx_client.request(+ f"api/v1/schedules/{encode_path_param(schedule_id)}/runs",+ method="GET",+ params={+ "limit": limit,+ "page_token": page_token,+ },+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ ListScheduleRunsResponse,+ construct_type(+ type_=ListScheduleRunsResponse, # 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(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 403:+ raise ForbiddenError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)diff --git a/python/trueforge_sdk/src/trueforge_sdk/server/__init__.py b/python/trueforge_sdk/src/trueforge_sdk/server/__init__.pynew file mode 100644index 000000000..5cde0202d--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/server/__init__.py@@ -0,0 +1,4 @@+# This file was auto-generated by Fern from our API Definition.++# isort: skip_file+diff --git a/python/trueforge_sdk/src/trueforge_sdk/server/client.py b/python/trueforge_sdk/src/trueforge_sdk/server/client.pynew file mode 100644index 000000000..413d9811c--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/server/client.py@@ -0,0 +1,104 @@+# This file was auto-generated by Fern from our API Definition.++import typing++from ..core.client_wrapper import AsyncClientWrapper, SyncClientWrapper+from ..core.request_options import RequestOptions+from ..types.get_capabilities_response import GetCapabilitiesResponse+from .raw_client import AsyncRawServerClient, RawServerClient+++class ServerClient:+ def __init__(self, *, client_wrapper: SyncClientWrapper):+ self._raw_client = RawServerClient(client_wrapper=client_wrapper)++ @property+ def with_raw_response(self) -> RawServerClient:+ """+ Retrieves a raw implementation of this client that returns raw responses.++ Returns+ -------+ RawServerClient+ """+ return self._raw_client++ def get_capabilities(self, *, request_options: typing.Optional[RequestOptions] = None) -> GetCapabilitiesResponse:+ """+ Report optional runtime capabilities available for this tenant.++ Parameters+ ----------+ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ GetCapabilitiesResponse+ Server capabilities.++ Examples+ --------+ from trueforge_sdk import TrueForge++ client = TrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+ client.server.get_capabilities()+ """+ _response = self._raw_client.get_capabilities(request_options=request_options)+ return _response.data+++class AsyncServerClient:+ def __init__(self, *, client_wrapper: AsyncClientWrapper):+ self._raw_client = AsyncRawServerClient(client_wrapper=client_wrapper)++ @property+ def with_raw_response(self) -> AsyncRawServerClient:+ """+ Retrieves a raw implementation of this client that returns raw responses.++ Returns+ -------+ AsyncRawServerClient+ """+ return self._raw_client++ async def get_capabilities(+ self, *, request_options: typing.Optional[RequestOptions] = None+ ) -> GetCapabilitiesResponse:+ """+ Report optional runtime capabilities available for this tenant.++ Parameters+ ----------+ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ GetCapabilitiesResponse+ Server capabilities.++ Examples+ --------+ import asyncio++ from trueforge_sdk import AsyncTrueForge++ client = AsyncTrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+++ async def main() -> None:+ await client.server.get_capabilities()+++ asyncio.run(main())+ """+ _response = await self._raw_client.get_capabilities(request_options=request_options)+ return _response.datadiff --git a/python/trueforge_sdk/src/trueforge_sdk/server/raw_client.py b/python/trueforge_sdk/src/trueforge_sdk/server/raw_client.pynew file mode 100644index 000000000..3456e7962--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/server/raw_client.py@@ -0,0 +1,127 @@+# 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.parse_error import ParsingError+from ..core.request_options import RequestOptions+from ..core.unchecked_base_model import construct_type+from ..errors.unauthorized_error import UnauthorizedError+from ..types.get_capabilities_response import GetCapabilitiesResponse+from ..types.request_error_response import RequestErrorResponse+from pydantic import ValidationError+++class RawServerClient:+ def __init__(self, *, client_wrapper: SyncClientWrapper):+ self._client_wrapper = client_wrapper++ def get_capabilities(+ self, *, request_options: typing.Optional[RequestOptions] = None+ ) -> HttpResponse[GetCapabilitiesResponse]:+ """+ Report optional runtime capabilities available for this tenant.++ Parameters+ ----------+ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[GetCapabilitiesResponse]+ Server capabilities.+ """+ _response = self._client_wrapper.httpx_client.request(+ "api/v1/capabilities",+ method="GET",+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ GetCapabilitiesResponse,+ construct_type(+ type_=GetCapabilitiesResponse, # type: ignore+ object_=_response.json(),+ ),+ )+ return HttpResponse(response=_response, data=_data)+ if _response.status_code == 401:+ raise UnauthorizedError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)+++class AsyncRawServerClient:+ def __init__(self, *, client_wrapper: AsyncClientWrapper):+ self._client_wrapper = client_wrapper++ async def get_capabilities(+ self, *, request_options: typing.Optional[RequestOptions] = None+ ) -> AsyncHttpResponse[GetCapabilitiesResponse]:+ """+ Report optional runtime capabilities available for this tenant.++ Parameters+ ----------+ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ AsyncHttpResponse[GetCapabilitiesResponse]+ Server capabilities.+ """+ _response = await self._client_wrapper.httpx_client.request(+ "api/v1/capabilities",+ method="GET",+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ GetCapabilitiesResponse,+ construct_type(+ type_=GetCapabilitiesResponse, # type: ignore+ object_=_response.json(),+ ),+ )+ return AsyncHttpResponse(response=_response, data=_data)+ if _response.status_code == 401:+ raise UnauthorizedError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)diff --git a/python/trueforge_sdk/src/trueforge_sdk/sessions/__init__.py b/python/trueforge_sdk/src/trueforge_sdk/sessions/__init__.pynew file mode 100644index 000000000..5cde0202d--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/sessions/__init__.py@@ -0,0 +1,4 @@+# This file was auto-generated by Fern from our API Definition.++# isort: skip_file+diff --git a/python/trueforge_sdk/src/trueforge_sdk/sessions/client.py b/python/trueforge_sdk/src/trueforge_sdk/sessions/client.pynew file mode 100644index 000000000..6f1726ffa--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/sessions/client.py@@ -0,0 +1,1527 @@+# This file was auto-generated by Fern from our API Definition.++import datetime as dt+import typing++from ..core.client_wrapper import AsyncClientWrapper, SyncClientWrapper+from ..core.request_options import RequestOptions+from ..core.stream import AsyncStream, Stream, StreamEvent+from ..types.cancel_session_response import CancelSessionResponse+from ..types.create_session_agent import CreateSessionAgent+from ..types.get_session_response import GetSessionResponse+from ..types.get_turn_response import GetTurnResponse+from ..types.list_session_events_response import ListSessionEventsResponse+from ..types.list_sessions_order import ListSessionsOrder+from ..types.list_sessions_response import ListSessionsResponse+from ..types.list_turn_events_order import ListTurnEventsOrder+from ..types.list_turn_events_response import ListTurnEventsResponse+from ..types.list_turns_response import ListTurnsResponse+from ..types.previous_turn_id_input import PreviousTurnIdInput+from ..types.session_agent_spec_body import SessionAgentSpecBody+from ..types.session_metadata import SessionMetadata+from ..types.session_source_type import SessionSourceType+from ..types.turn_input_item import TurnInputItem+from ..types.turn_streaming_event import TurnStreamingEvent+from .raw_client import AsyncRawSessionsClient, RawSessionsClient++# this is used as the default value for optional parameters+OMIT = typing.cast(typing.Any, ...)+++class SessionsClient:+ def __init__(self, *, client_wrapper: SyncClientWrapper):+ self._raw_client = RawSessionsClient(client_wrapper=client_wrapper)++ @property+ def with_raw_response(self) -> RawSessionsClient:+ """+ Retrieves a raw implementation of this client that returns raw responses.++ Returns+ -------+ RawSessionsClient+ """+ return self._raw_client++ def list(+ self,+ *,+ limit: typing.Optional[int] = 25,+ order: typing.Optional[ListSessionsOrder] = None,+ page_token: typing.Optional[str] = None,+ start_timestamp: typing.Optional[dt.datetime] = None,+ end_timestamp: typing.Optional[dt.datetime] = None,+ agent_id: typing.Optional[str] = None,+ created_by_me: typing.Optional[bool] = None,+ metadata: typing.Optional[SessionMetadata] = None,+ source_type: typing.Optional[SessionSourceType] = None,+ source_id: typing.Optional[str] = None,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> ListSessionsResponse:+ """+ List the sessions (newest first by default).++ Parameters+ ----------+ limit : typing.Optional[int]+ Page size. Defaults to 25, max 25.++ order : typing.Optional[ListSessionsOrder]+ Sort sessions by `updated_at`. Defaults to "desc".++ page_token : typing.Optional[str]+ Opaque keyset cursor from a previous response `next_page_token`.++ start_timestamp : typing.Optional[dt.datetime]+ Inclusive lower bound on `created_at` (ISO-8601 / RFC 3339).++ end_timestamp : typing.Optional[dt.datetime]+ Inclusive upper bound on `created_at` (ISO-8601 / RFC 3339).++ agent_id : typing.Optional[str]+ When set, only sessions bound to this agent id are returned.++ created_by_me : typing.Optional[bool]+ When true, only sessions created by the authenticated subject.++ metadata : typing.Optional[SessionMetadata]+ Exact metadata pairs as metadata[key]=value. Sessions must contain all pairs.++ source_type : typing.Optional[SessionSourceType]+ When set, returns only sessions created by this source type.++ source_id : typing.Optional[str]+ When set, returns only sessions from this specific source. Requires source_type.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ ListSessionsResponse+ Paginated sessions.++ Examples+ --------+ from trueforge_sdk import TrueForge++ client = TrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+ client.sessions.list()+ """+ _response = self._raw_client.list(+ limit=limit,+ order=order,+ page_token=page_token,+ start_timestamp=start_timestamp,+ end_timestamp=end_timestamp,+ agent_id=agent_id,+ created_by_me=created_by_me,+ metadata=metadata,+ source_type=source_type,+ source_id=source_id,+ request_options=request_options,+ )+ return _response.data++ def create(+ self,+ *,+ agent: CreateSessionAgent,+ metadata: typing.Optional[SessionMetadata] = OMIT,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> GetSessionResponse:+ """+ Create a session with `agent` as either `{ name }` (named registry binding) or `{ spec: AgentSpec }` (inline). Named sessions snapshot the agent name at create and resolve the live agent on each turn. Responses use `{ type: "reference", name, id }` or `{ type: "inline", spec }`.++ Parameters+ ----------+ agent : CreateSessionAgent++ metadata : typing.Optional[SessionMetadata]++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ GetSessionResponse+ Session created.++ Examples+ --------+ from trueforge_sdk import SessionAgentNameRef, TrueForge++ client = TrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+ client.sessions.create(+ agent=SessionAgentNameRef(+ name="name",+ ),+ )+ """+ _response = self._raw_client.create(agent=agent, metadata=metadata, request_options=request_options)+ return _response.data++ def get(self, *, session_id: str, request_options: typing.Optional[RequestOptions] = None) -> GetSessionResponse:+ """+ Fetch a session by ID. Only the session creator may fetch it.++ Parameters+ ----------+ session_id : str+ Session identifier.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ GetSessionResponse+ Session data.++ Examples+ --------+ from trueforge_sdk import TrueForge++ client = TrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+ client.sessions.get(+ session_id="session_id",+ )+ """+ _response = self._raw_client.get(session_id=session_id, request_options=request_options)+ return _response.data++ def delete(self, *, session_id: str, request_options: typing.Optional[RequestOptions] = None) -> None:+ """+ Delete a session and all related turns, events, and internal state. Only the session creator may delete it. Idempotent if already gone.++ Parameters+ ----------+ session_id : str+ Session identifier.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ None++ Examples+ --------+ from trueforge_sdk import TrueForge++ client = TrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+ client.sessions.delete(+ session_id="session_id",+ )+ """+ _response = self._raw_client.delete(session_id=session_id, request_options=request_options)+ return _response.data++ def update(+ self,+ *,+ session_id: str,+ agent: typing.Optional[SessionAgentSpecBody] = OMIT,+ metadata: typing.Optional[SessionMetadata] = OMIT,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> GetSessionResponse:+ """+ Update a session by replacing `agent` with `{ spec: AgentSpec }`. Named (reference) sessions reject agent updates. An empty body is a valid no-op that refreshes `updated_at`. Only the session creator may update it.++ Parameters+ ----------+ session_id : str+ Session identifier.++ agent : typing.Optional[SessionAgentSpecBody]++ metadata : typing.Optional[SessionMetadata]++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ GetSessionResponse+ Session updated.++ Examples+ --------+ from trueforge_sdk import TrueForge++ client = TrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+ client.sessions.update(+ session_id="session_id",+ )+ """+ _response = self._raw_client.update(+ session_id=session_id, agent=agent, metadata=metadata, request_options=request_options+ )+ return _response.data++ def cancel(+ self, *, session_id: str, request_options: typing.Optional[RequestOptions] = None+ ) -> CancelSessionResponse:+ """+ Cancel the running last turn for a session. Only the session creator may cancel.++ Parameters+ ----------+ session_id : str+ Session identifier.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ CancelSessionResponse+ Turn cancelled.++ Examples+ --------+ from trueforge_sdk import TrueForge++ client = TrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+ client.sessions.cancel(+ session_id="session_id",+ )+ """+ _response = self._raw_client.cancel(session_id=session_id, request_options=request_options)+ return _response.data++ def list_events(+ self,+ *,+ session_id: str,+ page_token: typing.Optional[str] = None,+ last_turn_id: typing.Optional[str] = None,+ limit: typing.Optional[int] = 100,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> ListSessionEventsResponse:+ """+ List session events as `{ turn_id, event }` across the active turn branch (newest first), including persisted events from a running tip. Each turn contributes turn.created, content events (model.message, tool.call, …), and turn.done when terminal; streaming deltas are not included. Use `page_token` to paginate backward toward older events while retaining the original branch anchor. Only the session creator may list events.++ Parameters+ ----------+ session_id : str+ Session identifier.++ page_token : typing.Optional[str]+ Pagination cursor from `pagination.next_page_token`. It retains the branch anchor turn and returns older events toward the session start.++ last_turn_id : typing.Optional[str]+ Newest turn in the listing window (initial load only; ignored when `page_token` is set). Lists that turn and its ancestors, newest events first. Omit to use the session last turn.++ limit : typing.Optional[int]+ Page size. Defaults to 100, max 100.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ ListSessionEventsResponse+ Paginated session events.++ Examples+ --------+ from trueforge_sdk import TrueForge++ client = TrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+ client.sessions.list_events(+ session_id="session_id",+ )+ """+ _response = self._raw_client.list_events(+ session_id=session_id,+ page_token=page_token,+ last_turn_id=last_turn_id,+ limit=limit,+ request_options=request_options,+ )+ return _response.data++ def list_turns(+ self,+ *,+ session_id: str,+ limit: typing.Optional[int] = 25,+ page_token: typing.Optional[str] = None,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> ListTurnsResponse:+ """+ List turns for a session (newest first by default), token-paginated. Only the session creator may list turns.++ Parameters+ ----------+ session_id : str+ Session identifier.++ limit : typing.Optional[int]+ Page size. Defaults to 25, max 25.++ page_token : typing.Optional[str]+ Opaque token from a previous response `next_page_token`.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ ListTurnsResponse+ Paginated turns.++ Examples+ --------+ from trueforge_sdk import TrueForge++ client = TrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+ client.sessions.list_turns(+ session_id="session_id",+ )+ """+ _response = self._raw_client.list_turns(+ session_id=session_id, limit=limit, page_token=page_token, request_options=request_options+ )+ return _response.data++ def create_turn_stream(+ self,+ *,+ session_id: str,+ input: typing.Optional[typing.Sequence[TurnInputItem]] = OMIT,+ previous_turn_id: typing.Optional[PreviousTurnIdInput] = OMIT,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> Stream[TurnStreamingEvent]:+ """+ Create a turn within a session and execute it.+ Only the session creator may create turns.+ When `stream` is true (default), respond with a Server-Sent Events stream of turn events.+ When `stream` is false, return the turn immediately with `state.status: "running"` while execution continues in the background; use get turn or subscribe to observe completion.+ Use `previous_turn_id` to chain to the session's last turn (defaults to `auto`); use `none` for a new root.++ Parameters+ ----------+ session_id : str+ Session identifier.++ input : typing.Optional[typing.Sequence[TurnInputItem]]+ Turn input items: user messages and/or approval/tool-response resumes. Do not mix user messages with approval or tool-response items.++ previous_turn_id : typing.Optional[PreviousTurnIdInput]++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ Stream[TurnStreamingEvent]+++ Examples+ --------+ from trueforge_sdk import TrueForge++ client = TrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+ response = client.sessions.create_turn_stream(+ session_id="session_id",+ )+ for chunk in response:+ yield chunk+ """++ def _events() -> typing.Generator[StreamEvent[TurnStreamingEvent], None, None]:+ with self._raw_client.create_turn_stream(+ session_id=session_id, input=input, previous_turn_id=previous_turn_id, request_options=request_options+ ) as r:+ yield from r.data.with_metadata()++ return Stream(events=_events)++ def create_turn(+ self,+ *,+ session_id: str,+ input: typing.Optional[typing.Sequence[TurnInputItem]] = OMIT,+ previous_turn_id: typing.Optional[PreviousTurnIdInput] = OMIT,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> GetTurnResponse:+ """+ Create a turn within a session and execute it.+ Only the session creator may create turns.+ When `stream` is true (default), respond with a Server-Sent Events stream of turn events.+ When `stream` is false, return the turn immediately with `state.status: "running"` while execution continues in the background; use get turn or subscribe to observe completion.+ Use `previous_turn_id` to chain to the session's last turn (defaults to `auto`); use `none` for a new root.++ Parameters+ ----------+ session_id : str+ Session identifier.++ input : typing.Optional[typing.Sequence[TurnInputItem]]+ Turn input items: user messages and/or approval/tool-response resumes. Do not mix user messages with approval or tool-response items.++ previous_turn_id : typing.Optional[PreviousTurnIdInput]++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ GetTurnResponse+++ Examples+ --------+ from trueforge_sdk import TrueForge++ client = TrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+ client.sessions.create_turn(+ session_id="session_id",+ )+ """+ _response = self._raw_client.create_turn(+ session_id=session_id, input=input, previous_turn_id=previous_turn_id, request_options=request_options+ )+ return _response.data++ def get_turn(+ self, *, session_id: str, turn_id: str, request_options: typing.Optional[RequestOptions] = None+ ) -> GetTurnResponse:+ """+ Fetch a single turn by ID. Only the session creator may fetch it.++ Parameters+ ----------+ session_id : str+ Session identifier.++ turn_id : str+ Turn identifier.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ GetTurnResponse+ Turn data.++ Examples+ --------+ from trueforge_sdk import TrueForge++ client = TrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+ client.sessions.get_turn(+ session_id="session_id",+ turn_id="turn_id",+ )+ """+ _response = self._raw_client.get_turn(session_id=session_id, turn_id=turn_id, request_options=request_options)+ return _response.data++ def download_sandbox_file(+ self, *, session_id: str, turn_id: str, path: str, request_options: typing.Optional[RequestOptions] = None+ ) -> typing.Iterator[bytes]:+ """+ Download a file from the sandbox this turn ran in. Paths come from the assistant's `sandbox_artifacts` block. Only the session creator may download.++ Parameters+ ----------+ session_id : str+ Session identifier.++ turn_id : str+ Turn identifier.++ path : str+ Absolute or sandbox-working-directory-relative file path, as listed in the assistant's `sandbox_artifacts` block.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration. You can pass in configuration such as `chunk_size`, and more to customize the request and response.++ Returns+ -------+ typing.Iterator[bytes]+ File contents.++ Examples+ --------+ from trueforge_sdk import TrueForge++ client = TrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+ client.sessions.download_sandbox_file(+ session_id="session_id",+ turn_id="turn_id",+ path="x",+ )+ """+ with self._raw_client.download_sandbox_file(+ session_id=session_id, turn_id=turn_id, path=path, request_options=request_options+ ) as r:+ yield from r.data++ def list_turn_events(+ self,+ *,+ session_id: str,+ turn_id: str,+ limit: typing.Optional[int] = 100,+ page_token: typing.Optional[str] = None,+ order: typing.Optional[ListTurnEventsOrder] = None,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> ListTurnEventsResponse:+ """+ Paginated persisted events for a turn (insertion order by default). Only the session creator may list events.++ Parameters+ ----------+ session_id : str+ Session identifier.++ turn_id : str+ Turn identifier.++ limit : typing.Optional[int]+ Page size. Defaults to 100, max 100.++ page_token : typing.Optional[str]+ Opaque token from a previous response `next_page_token`.++ order : typing.Optional[ListTurnEventsOrder]+ Sort events by insertion order. Defaults to "asc".++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ ListTurnEventsResponse+ Paginated turn events.++ Examples+ --------+ from trueforge_sdk import TrueForge++ client = TrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+ client.sessions.list_turn_events(+ session_id="session_id",+ turn_id="turn_id",+ )+ """+ _response = self._raw_client.list_turn_events(+ session_id=session_id,+ turn_id=turn_id,+ limit=limit,+ page_token=page_token,+ order=order,+ request_options=request_options,+ )+ return _response.data++ def subscribe_to_turn(+ self,+ *,+ session_id: str,+ turn_id: str,+ after_sequence_number: typing.Optional[int] = None,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> Stream[TurnStreamingEvent]:+ """+ Subscribe to the live SSE stream for a turn. Only the session creator may subscribe. Pass `after_sequence_number` to resume after a disconnect (exclusive — events after this sequence number are replayed).++ Parameters+ ----------+ session_id : str+ Session identifier.++ turn_id : str+ Turn identifier.++ after_sequence_number : typing.Optional[int]+ Exclusive resume cursor: replay only events with a sequence number greater than this value. Omit to start from the beginning of the live buffer.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ Stream[TurnStreamingEvent]+ Server-Sent Events stream of turn events (deltas and lifecycle).++ Examples+ --------+ from trueforge_sdk import TrueForge++ client = TrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+ response = client.sessions.subscribe_to_turn(+ session_id="session_id",+ turn_id="turn_id",+ )+ for chunk in response:+ yield chunk+ """++ def _events() -> typing.Generator[StreamEvent[TurnStreamingEvent], None, None]:+ with self._raw_client.subscribe_to_turn(+ session_id=session_id,+ turn_id=turn_id,+ after_sequence_number=after_sequence_number,+ request_options=request_options,+ ) as r:+ yield from r.data.with_metadata()++ return Stream(events=_events)+++class AsyncSessionsClient:+ def __init__(self, *, client_wrapper: AsyncClientWrapper):+ self._raw_client = AsyncRawSessionsClient(client_wrapper=client_wrapper)++ @property+ def with_raw_response(self) -> AsyncRawSessionsClient:+ """+ Retrieves a raw implementation of this client that returns raw responses.++ Returns+ -------+ AsyncRawSessionsClient+ """+ return self._raw_client++ async def list(+ self,+ *,+ limit: typing.Optional[int] = 25,+ order: typing.Optional[ListSessionsOrder] = None,+ page_token: typing.Optional[str] = None,+ start_timestamp: typing.Optional[dt.datetime] = None,+ end_timestamp: typing.Optional[dt.datetime] = None,+ agent_id: typing.Optional[str] = None,+ created_by_me: typing.Optional[bool] = None,+ metadata: typing.Optional[SessionMetadata] = None,+ source_type: typing.Optional[SessionSourceType] = None,+ source_id: typing.Optional[str] = None,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> ListSessionsResponse:+ """+ List the sessions (newest first by default).++ Parameters+ ----------+ limit : typing.Optional[int]+ Page size. Defaults to 25, max 25.++ order : typing.Optional[ListSessionsOrder]+ Sort sessions by `updated_at`. Defaults to "desc".++ page_token : typing.Optional[str]+ Opaque keyset cursor from a previous response `next_page_token`.++ start_timestamp : typing.Optional[dt.datetime]+ Inclusive lower bound on `created_at` (ISO-8601 / RFC 3339).++ end_timestamp : typing.Optional[dt.datetime]+ Inclusive upper bound on `created_at` (ISO-8601 / RFC 3339).++ agent_id : typing.Optional[str]+ When set, only sessions bound to this agent id are returned.++ created_by_me : typing.Optional[bool]+ When true, only sessions created by the authenticated subject.++ metadata : typing.Optional[SessionMetadata]+ Exact metadata pairs as metadata[key]=value. Sessions must contain all pairs.++ source_type : typing.Optional[SessionSourceType]+ When set, returns only sessions created by this source type.++ source_id : typing.Optional[str]+ When set, returns only sessions from this specific source. Requires source_type.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ ListSessionsResponse+ Paginated sessions.++ Examples+ --------+ import asyncio++ from trueforge_sdk import AsyncTrueForge++ client = AsyncTrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+++ async def main() -> None:+ await client.sessions.list()+++ asyncio.run(main())+ """+ _response = await self._raw_client.list(+ limit=limit,+ order=order,+ page_token=page_token,+ start_timestamp=start_timestamp,+ end_timestamp=end_timestamp,+ agent_id=agent_id,+ created_by_me=created_by_me,+ metadata=metadata,+ source_type=source_type,+ source_id=source_id,+ request_options=request_options,+ )+ return _response.data++ async def create(+ self,+ *,+ agent: CreateSessionAgent,+ metadata: typing.Optional[SessionMetadata] = OMIT,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> GetSessionResponse:+ """+ Create a session with `agent` as either `{ name }` (named registry binding) or `{ spec: AgentSpec }` (inline). Named sessions snapshot the agent name at create and resolve the live agent on each turn. Responses use `{ type: "reference", name, id }` or `{ type: "inline", spec }`.++ Parameters+ ----------+ agent : CreateSessionAgent++ metadata : typing.Optional[SessionMetadata]++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ GetSessionResponse+ Session created.++ Examples+ --------+ import asyncio++ from trueforge_sdk import AsyncTrueForge, SessionAgentNameRef++ client = AsyncTrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+++ async def main() -> None:+ await client.sessions.create(+ agent=SessionAgentNameRef(+ name="name",+ ),+ )+++ asyncio.run(main())+ """+ _response = await self._raw_client.create(agent=agent, metadata=metadata, request_options=request_options)+ return _response.data++ async def get(+ self, *, session_id: str, request_options: typing.Optional[RequestOptions] = None+ ) -> GetSessionResponse:+ """+ Fetch a session by ID. Only the session creator may fetch it.++ Parameters+ ----------+ session_id : str+ Session identifier.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ GetSessionResponse+ Session data.++ Examples+ --------+ import asyncio++ from trueforge_sdk import AsyncTrueForge++ client = AsyncTrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+++ async def main() -> None:+ await client.sessions.get(+ session_id="session_id",+ )+++ asyncio.run(main())+ """+ _response = await self._raw_client.get(session_id=session_id, request_options=request_options)+ return _response.data++ async def delete(self, *, session_id: str, request_options: typing.Optional[RequestOptions] = None) -> None:+ """+ Delete a session and all related turns, events, and internal state. Only the session creator may delete it. Idempotent if already gone.++ Parameters+ ----------+ session_id : str+ Session identifier.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ None++ Examples+ --------+ import asyncio++ from trueforge_sdk import AsyncTrueForge++ client = AsyncTrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+++ async def main() -> None:+ await client.sessions.delete(+ session_id="session_id",+ )+++ asyncio.run(main())+ """+ _response = await self._raw_client.delete(session_id=session_id, request_options=request_options)+ return _response.data++ async def update(+ self,+ *,+ session_id: str,+ agent: typing.Optional[SessionAgentSpecBody] = OMIT,+ metadata: typing.Optional[SessionMetadata] = OMIT,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> GetSessionResponse:+ """+ Update a session by replacing `agent` with `{ spec: AgentSpec }`. Named (reference) sessions reject agent updates. An empty body is a valid no-op that refreshes `updated_at`. Only the session creator may update it.++ Parameters+ ----------+ session_id : str+ Session identifier.++ agent : typing.Optional[SessionAgentSpecBody]++ metadata : typing.Optional[SessionMetadata]++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ GetSessionResponse+ Session updated.++ Examples+ --------+ import asyncio++ from trueforge_sdk import AsyncTrueForge++ client = AsyncTrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+++ async def main() -> None:+ await client.sessions.update(+ session_id="session_id",+ )+++ asyncio.run(main())+ """+ _response = await self._raw_client.update(+ session_id=session_id, agent=agent, metadata=metadata, request_options=request_options+ )+ return _response.data++ async def cancel(+ self, *, session_id: str, request_options: typing.Optional[RequestOptions] = None+ ) -> CancelSessionResponse:+ """+ Cancel the running last turn for a session. Only the session creator may cancel.++ Parameters+ ----------+ session_id : str+ Session identifier.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ CancelSessionResponse+ Turn cancelled.++ Examples+ --------+ import asyncio++ from trueforge_sdk import AsyncTrueForge++ client = AsyncTrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+++ async def main() -> None:+ await client.sessions.cancel(+ session_id="session_id",+ )+++ asyncio.run(main())+ """+ _response = await self._raw_client.cancel(session_id=session_id, request_options=request_options)+ return _response.data++ async def list_events(+ self,+ *,+ session_id: str,+ page_token: typing.Optional[str] = None,+ last_turn_id: typing.Optional[str] = None,+ limit: typing.Optional[int] = 100,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> ListSessionEventsResponse:+ """+ List session events as `{ turn_id, event }` across the active turn branch (newest first), including persisted events from a running tip. Each turn contributes turn.created, content events (model.message, tool.call, …), and turn.done when terminal; streaming deltas are not included. Use `page_token` to paginate backward toward older events while retaining the original branch anchor. Only the session creator may list events.++ Parameters+ ----------+ session_id : str+ Session identifier.++ page_token : typing.Optional[str]+ Pagination cursor from `pagination.next_page_token`. It retains the branch anchor turn and returns older events toward the session start.++ last_turn_id : typing.Optional[str]+ Newest turn in the listing window (initial load only; ignored when `page_token` is set). Lists that turn and its ancestors, newest events first. Omit to use the session last turn.++ limit : typing.Optional[int]+ Page size. Defaults to 100, max 100.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ ListSessionEventsResponse+ Paginated session events.++ Examples+ --------+ import asyncio++ from trueforge_sdk import AsyncTrueForge++ client = AsyncTrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+++ async def main() -> None:+ await client.sessions.list_events(+ session_id="session_id",+ )+++ asyncio.run(main())+ """+ _response = await self._raw_client.list_events(+ session_id=session_id,+ page_token=page_token,+ last_turn_id=last_turn_id,+ limit=limit,+ request_options=request_options,+ )+ return _response.data++ async def list_turns(+ self,+ *,+ session_id: str,+ limit: typing.Optional[int] = 25,+ page_token: typing.Optional[str] = None,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> ListTurnsResponse:+ """+ List turns for a session (newest first by default), token-paginated. Only the session creator may list turns.++ Parameters+ ----------+ session_id : str+ Session identifier.++ limit : typing.Optional[int]+ Page size. Defaults to 25, max 25.++ page_token : typing.Optional[str]+ Opaque token from a previous response `next_page_token`.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ ListTurnsResponse+ Paginated turns.++ Examples+ --------+ import asyncio++ from trueforge_sdk import AsyncTrueForge++ client = AsyncTrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+++ async def main() -> None:+ await client.sessions.list_turns(+ session_id="session_id",+ )+++ asyncio.run(main())+ """+ _response = await self._raw_client.list_turns(+ session_id=session_id, limit=limit, page_token=page_token, request_options=request_options+ )+ return _response.data++ def create_turn_stream(+ self,+ *,+ session_id: str,+ input: typing.Optional[typing.Sequence[TurnInputItem]] = OMIT,+ previous_turn_id: typing.Optional[PreviousTurnIdInput] = OMIT,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> AsyncStream[TurnStreamingEvent]:+ """+ Create a turn within a session and execute it.+ Only the session creator may create turns.+ When `stream` is true (default), respond with a Server-Sent Events stream of turn events.+ When `stream` is false, return the turn immediately with `state.status: "running"` while execution continues in the background; use get turn or subscribe to observe completion.+ Use `previous_turn_id` to chain to the session's last turn (defaults to `auto`); use `none` for a new root.++ Parameters+ ----------+ session_id : str+ Session identifier.++ input : typing.Optional[typing.Sequence[TurnInputItem]]+ Turn input items: user messages and/or approval/tool-response resumes. Do not mix user messages with approval or tool-response items.++ previous_turn_id : typing.Optional[PreviousTurnIdInput]++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ AsyncStream[TurnStreamingEvent]+++ Examples+ --------+ import asyncio++ from trueforge_sdk import AsyncTrueForge++ client = AsyncTrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+++ async def main() -> None:+ response = await client.sessions.create_turn_stream(+ session_id="session_id",+ )+ async for chunk in response:+ yield chunk+++ asyncio.run(main())+ """++ async def _events() -> typing.AsyncGenerator[StreamEvent[TurnStreamingEvent], None]:+ async with self._raw_client.create_turn_stream(+ session_id=session_id, input=input, previous_turn_id=previous_turn_id, request_options=request_options+ ) as r:+ async for _event in r.data.with_metadata():+ yield _event++ return AsyncStream(events=_events)++ async def create_turn(+ self,+ *,+ session_id: str,+ input: typing.Optional[typing.Sequence[TurnInputItem]] = OMIT,+ previous_turn_id: typing.Optional[PreviousTurnIdInput] = OMIT,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> GetTurnResponse:+ """+ Create a turn within a session and execute it.+ Only the session creator may create turns.+ When `stream` is true (default), respond with a Server-Sent Events stream of turn events.+ When `stream` is false, return the turn immediately with `state.status: "running"` while execution continues in the background; use get turn or subscribe to observe completion.+ Use `previous_turn_id` to chain to the session's last turn (defaults to `auto`); use `none` for a new root.++ Parameters+ ----------+ session_id : str+ Session identifier.++ input : typing.Optional[typing.Sequence[TurnInputItem]]+ Turn input items: user messages and/or approval/tool-response resumes. Do not mix user messages with approval or tool-response items.++ previous_turn_id : typing.Optional[PreviousTurnIdInput]++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ GetTurnResponse+++ Examples+ --------+ import asyncio++ from trueforge_sdk import AsyncTrueForge++ client = AsyncTrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+++ async def main() -> None:+ await client.sessions.create_turn(+ session_id="session_id",+ )+++ asyncio.run(main())+ """+ _response = await self._raw_client.create_turn(+ session_id=session_id, input=input, previous_turn_id=previous_turn_id, request_options=request_options+ )+ return _response.data++ async def get_turn(+ self, *, session_id: str, turn_id: str, request_options: typing.Optional[RequestOptions] = None+ ) -> GetTurnResponse:+ """+ Fetch a single turn by ID. Only the session creator may fetch it.++ Parameters+ ----------+ session_id : str+ Session identifier.++ turn_id : str+ Turn identifier.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ GetTurnResponse+ Turn data.++ Examples+ --------+ import asyncio++ from trueforge_sdk import AsyncTrueForge++ client = AsyncTrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+++ async def main() -> None:+ await client.sessions.get_turn(+ session_id="session_id",+ turn_id="turn_id",+ )+++ asyncio.run(main())+ """+ _response = await self._raw_client.get_turn(+ session_id=session_id, turn_id=turn_id, request_options=request_options+ )+ return _response.data++ async def download_sandbox_file(+ self, *, session_id: str, turn_id: str, path: str, request_options: typing.Optional[RequestOptions] = None+ ) -> typing.AsyncIterator[bytes]:+ """+ Download a file from the sandbox this turn ran in. Paths come from the assistant's `sandbox_artifacts` block. Only the session creator may download.++ Parameters+ ----------+ session_id : str+ Session identifier.++ turn_id : str+ Turn identifier.++ path : str+ Absolute or sandbox-working-directory-relative file path, as listed in the assistant's `sandbox_artifacts` block.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration. You can pass in configuration such as `chunk_size`, and more to customize the request and response.++ Returns+ -------+ typing.AsyncIterator[bytes]+ File contents.++ Examples+ --------+ import asyncio++ from trueforge_sdk import AsyncTrueForge++ client = AsyncTrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+++ async def main() -> None:+ await client.sessions.download_sandbox_file(+ session_id="session_id",+ turn_id="turn_id",+ path="x",+ )+++ asyncio.run(main())+ """+ async with self._raw_client.download_sandbox_file(+ session_id=session_id, turn_id=turn_id, path=path, request_options=request_options+ ) as r:+ async for _chunk in r.data:+ yield _chunk++ async def list_turn_events(+ self,+ *,+ session_id: str,+ turn_id: str,+ limit: typing.Optional[int] = 100,+ page_token: typing.Optional[str] = None,+ order: typing.Optional[ListTurnEventsOrder] = None,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> ListTurnEventsResponse:+ """+ Paginated persisted events for a turn (insertion order by default). Only the session creator may list events.++ Parameters+ ----------+ session_id : str+ Session identifier.++ turn_id : str+ Turn identifier.++ limit : typing.Optional[int]+ Page size. Defaults to 100, max 100.++ page_token : typing.Optional[str]+ Opaque token from a previous response `next_page_token`.++ order : typing.Optional[ListTurnEventsOrder]+ Sort events by insertion order. Defaults to "asc".++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ ListTurnEventsResponse+ Paginated turn events.++ Examples+ --------+ import asyncio++ from trueforge_sdk import AsyncTrueForge++ client = AsyncTrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+++ async def main() -> None:+ await client.sessions.list_turn_events(+ session_id="session_id",+ turn_id="turn_id",+ )+++ asyncio.run(main())+ """+ _response = await self._raw_client.list_turn_events(+ session_id=session_id,+ turn_id=turn_id,+ limit=limit,+ page_token=page_token,+ order=order,+ request_options=request_options,+ )+ return _response.data++ def subscribe_to_turn(+ self,+ *,+ session_id: str,+ turn_id: str,+ after_sequence_number: typing.Optional[int] = None,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> AsyncStream[TurnStreamingEvent]:+ """+ Subscribe to the live SSE stream for a turn. Only the session creator may subscribe. Pass `after_sequence_number` to resume after a disconnect (exclusive — events after this sequence number are replayed).++ Parameters+ ----------+ session_id : str+ Session identifier.++ turn_id : str+ Turn identifier.++ after_sequence_number : typing.Optional[int]+ Exclusive resume cursor: replay only events with a sequence number greater than this value. Omit to start from the beginning of the live buffer.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ AsyncStream[TurnStreamingEvent]+ Server-Sent Events stream of turn events (deltas and lifecycle).++ Examples+ --------+ import asyncio++ from trueforge_sdk import AsyncTrueForge++ client = AsyncTrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+++ async def main() -> None:+ response = await client.sessions.subscribe_to_turn(+ session_id="session_id",+ turn_id="turn_id",+ )+ async for chunk in response:+ yield chunk+++ asyncio.run(main())+ """++ async def _events() -> typing.AsyncGenerator[StreamEvent[TurnStreamingEvent], None]:+ async with self._raw_client.subscribe_to_turn(+ session_id=session_id,+ turn_id=turn_id,+ after_sequence_number=after_sequence_number,+ request_options=request_options,+ ) as r:+ async for _event in r.data.with_metadata():+ yield _event++ return AsyncStream(events=_events)diff --git a/python/trueforge_sdk/src/trueforge_sdk/sessions/raw_client.py b/python/trueforge_sdk/src/trueforge_sdk/sessions/raw_client.pynew file mode 100644index 000000000..adbb14122--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/sessions/raw_client.py@@ -0,0 +1,2967 @@+# This file was auto-generated by Fern from our API Definition.++import contextlib+import datetime as dt+import typing+from json.decoder import JSONDecodeError+from logging import error, warning++from ..core.api_error import ApiError+from ..core.client_wrapper import AsyncClientWrapper, SyncClientWrapper+from ..core.datetime_utils import serialize_datetime+from ..core.http_response import AsyncHttpResponse, HttpResponse+from ..core.http_sse._api import EventSource+from ..core.jsonable_encoder import encode_path_param+from ..core.parse_error import ParsingError+from ..core.pydantic_utilities import parse_sse_obj+from ..core.request_options import RequestOptions+from ..core.serialization import convert_and_respect_annotation_metadata+from ..core.stream import AsyncStream, Stream, StreamEvent+from ..core.unchecked_base_model import construct_type+from ..errors.bad_request_error import BadRequestError+from ..errors.content_too_large_error import ContentTooLargeError+from ..errors.failed_dependency_error import FailedDependencyError+from ..errors.forbidden_error import ForbiddenError+from ..errors.gone_error import GoneError+from ..errors.not_found_error import NotFoundError+from ..errors.precondition_failed_error import PreconditionFailedError+from ..errors.unauthorized_error import UnauthorizedError+from ..errors.unprocessable_entity_error import UnprocessableEntityError+from ..types.cancel_session_response import CancelSessionResponse+from ..types.create_session_agent import CreateSessionAgent+from ..types.get_session_response import GetSessionResponse+from ..types.get_turn_response import GetTurnResponse+from ..types.list_session_events_response import ListSessionEventsResponse+from ..types.list_sessions_order import ListSessionsOrder+from ..types.list_sessions_response import ListSessionsResponse+from ..types.list_turn_events_order import ListTurnEventsOrder+from ..types.list_turn_events_response import ListTurnEventsResponse+from ..types.list_turns_response import ListTurnsResponse+from ..types.previous_turn_id_input import PreviousTurnIdInput+from ..types.request_error_response import RequestErrorResponse+from ..types.session_agent_spec_body import SessionAgentSpecBody+from ..types.session_metadata import SessionMetadata+from ..types.session_source_type import SessionSourceType+from ..types.turn_input_item import TurnInputItem+from ..types.turn_streaming_event import TurnStreamingEvent+from pydantic import ValidationError++# this is used as the default value for optional parameters+OMIT = typing.cast(typing.Any, ...)+++class RawSessionsClient:+ def __init__(self, *, client_wrapper: SyncClientWrapper):+ self._client_wrapper = client_wrapper++ def list(+ self,+ *,+ limit: typing.Optional[int] = 25,+ order: typing.Optional[ListSessionsOrder] = None,+ page_token: typing.Optional[str] = None,+ start_timestamp: typing.Optional[dt.datetime] = None,+ end_timestamp: typing.Optional[dt.datetime] = None,+ agent_id: typing.Optional[str] = None,+ created_by_me: typing.Optional[bool] = None,+ metadata: typing.Optional[SessionMetadata] = None,+ source_type: typing.Optional[SessionSourceType] = None,+ source_id: typing.Optional[str] = None,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> HttpResponse[ListSessionsResponse]:+ """+ List the sessions (newest first by default).++ Parameters+ ----------+ limit : typing.Optional[int]+ Page size. Defaults to 25, max 25.++ order : typing.Optional[ListSessionsOrder]+ Sort sessions by `updated_at`. Defaults to "desc".++ page_token : typing.Optional[str]+ Opaque keyset cursor from a previous response `next_page_token`.++ start_timestamp : typing.Optional[dt.datetime]+ Inclusive lower bound on `created_at` (ISO-8601 / RFC 3339).++ end_timestamp : typing.Optional[dt.datetime]+ Inclusive upper bound on `created_at` (ISO-8601 / RFC 3339).++ agent_id : typing.Optional[str]+ When set, only sessions bound to this agent id are returned.++ created_by_me : typing.Optional[bool]+ When true, only sessions created by the authenticated subject.++ metadata : typing.Optional[SessionMetadata]+ Exact metadata pairs as metadata[key]=value. Sessions must contain all pairs.++ source_type : typing.Optional[SessionSourceType]+ When set, returns only sessions created by this source type.++ source_id : typing.Optional[str]+ When set, returns only sessions from this specific source. Requires source_type.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[ListSessionsResponse]+ Paginated sessions.+ """+ _response = self._client_wrapper.httpx_client.request(+ "api/v1/sessions",+ method="GET",+ params={+ "limit": limit,+ "order": order,+ "page_token": page_token,+ "start_timestamp": serialize_datetime(start_timestamp) if start_timestamp is not None else None,+ "end_timestamp": serialize_datetime(end_timestamp) if end_timestamp is not None else None,+ "agent_id": agent_id,+ "created_by_me": created_by_me,+ "metadata": metadata,+ "source_type": source_type,+ "source_id": source_id,+ },+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ ListSessionsResponse,+ construct_type(+ type_=ListSessionsResponse, # 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(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ def create(+ self,+ *,+ agent: CreateSessionAgent,+ metadata: typing.Optional[SessionMetadata] = OMIT,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> HttpResponse[GetSessionResponse]:+ """+ Create a session with `agent` as either `{ name }` (named registry binding) or `{ spec: AgentSpec }` (inline). Named sessions snapshot the agent name at create and resolve the live agent on each turn. Responses use `{ type: "reference", name, id }` or `{ type: "inline", spec }`.++ Parameters+ ----------+ agent : CreateSessionAgent++ metadata : typing.Optional[SessionMetadata]++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[GetSessionResponse]+ Session created.+ """+ _response = self._client_wrapper.httpx_client.request(+ "api/v1/sessions",+ method="POST",+ json={+ "agent": convert_and_respect_annotation_metadata(+ object_=agent, annotation=CreateSessionAgent, direction="write"+ ),+ "metadata": metadata,+ },+ headers={+ "content-type": "application/json",+ },+ request_options=request_options,+ omit=OMIT,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ GetSessionResponse,+ construct_type(+ type_=GetSessionResponse, # 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(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 422:+ raise UnprocessableEntityError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ def get(+ self, *, session_id: str, request_options: typing.Optional[RequestOptions] = None+ ) -> HttpResponse[GetSessionResponse]:+ """+ Fetch a session by ID. Only the session creator may fetch it.++ Parameters+ ----------+ session_id : str+ Session identifier.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[GetSessionResponse]+ Session data.+ """+ _response = self._client_wrapper.httpx_client.request(+ f"api/v1/sessions/{encode_path_param(session_id)}",+ method="GET",+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ GetSessionResponse,+ construct_type(+ type_=GetSessionResponse, # type: ignore+ object_=_response.json(),+ ),+ )+ return HttpResponse(response=_response, data=_data)+ if _response.status_code == 403:+ raise ForbiddenError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ def delete(self, *, session_id: str, request_options: typing.Optional[RequestOptions] = None) -> HttpResponse[None]:+ """+ Delete a session and all related turns, events, and internal state. Only the session creator may delete it. Idempotent if already gone.++ Parameters+ ----------+ session_id : str+ Session identifier.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[None]+ """+ _response = self._client_wrapper.httpx_client.request(+ f"api/v1/sessions/{encode_path_param(session_id)}",+ method="DELETE",+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ return HttpResponse(response=_response, data=None)+ if _response.status_code == 403:+ raise ForbiddenError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ def update(+ self,+ *,+ session_id: str,+ agent: typing.Optional[SessionAgentSpecBody] = OMIT,+ metadata: typing.Optional[SessionMetadata] = OMIT,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> HttpResponse[GetSessionResponse]:+ """+ Update a session by replacing `agent` with `{ spec: AgentSpec }`. Named (reference) sessions reject agent updates. An empty body is a valid no-op that refreshes `updated_at`. Only the session creator may update it.++ Parameters+ ----------+ session_id : str+ Session identifier.++ agent : typing.Optional[SessionAgentSpecBody]++ metadata : typing.Optional[SessionMetadata]++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[GetSessionResponse]+ Session updated.+ """+ _response = self._client_wrapper.httpx_client.request(+ f"api/v1/sessions/{encode_path_param(session_id)}",+ method="PATCH",+ json={+ "agent": convert_and_respect_annotation_metadata(+ object_=agent, annotation=SessionAgentSpecBody, direction="write"+ ),+ "metadata": metadata,+ },+ headers={+ "content-type": "application/json",+ },+ request_options=request_options,+ omit=OMIT,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ GetSessionResponse,+ construct_type(+ type_=GetSessionResponse, # 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(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 403:+ raise ForbiddenError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 422:+ raise UnprocessableEntityError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ def cancel(+ self, *, session_id: str, request_options: typing.Optional[RequestOptions] = None+ ) -> HttpResponse[CancelSessionResponse]:+ """+ Cancel the running last turn for a session. Only the session creator may cancel.++ Parameters+ ----------+ session_id : str+ Session identifier.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[CancelSessionResponse]+ Turn cancelled.+ """+ _response = self._client_wrapper.httpx_client.request(+ f"api/v1/sessions/{encode_path_param(session_id)}/cancel",+ method="POST",+ json={},+ headers={+ "content-type": "application/json",+ },+ request_options=request_options,+ omit=OMIT,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ CancelSessionResponse,+ construct_type(+ type_=CancelSessionResponse, # type: ignore+ object_=_response.json(),+ ),+ )+ return HttpResponse(response=_response, data=_data)+ if _response.status_code == 403:+ raise ForbiddenError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 412:+ raise PreconditionFailedError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ def list_events(+ self,+ *,+ session_id: str,+ page_token: typing.Optional[str] = None,+ last_turn_id: typing.Optional[str] = None,+ limit: typing.Optional[int] = 100,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> HttpResponse[ListSessionEventsResponse]:+ """+ List session events as `{ turn_id, event }` across the active turn branch (newest first), including persisted events from a running tip. Each turn contributes turn.created, content events (model.message, tool.call, …), and turn.done when terminal; streaming deltas are not included. Use `page_token` to paginate backward toward older events while retaining the original branch anchor. Only the session creator may list events.++ Parameters+ ----------+ session_id : str+ Session identifier.++ page_token : typing.Optional[str]+ Pagination cursor from `pagination.next_page_token`. It retains the branch anchor turn and returns older events toward the session start.++ last_turn_id : typing.Optional[str]+ Newest turn in the listing window (initial load only; ignored when `page_token` is set). Lists that turn and its ancestors, newest events first. Omit to use the session last turn.++ limit : typing.Optional[int]+ Page size. Defaults to 100, max 100.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[ListSessionEventsResponse]+ Paginated session events.+ """+ _response = self._client_wrapper.httpx_client.request(+ f"api/v1/sessions/{encode_path_param(session_id)}/events",+ method="GET",+ params={+ "page_token": page_token,+ "last_turn_id": last_turn_id,+ "limit": limit,+ },+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ ListSessionEventsResponse,+ construct_type(+ type_=ListSessionEventsResponse, # 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(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 403:+ raise ForbiddenError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ def list_turns(+ self,+ *,+ session_id: str,+ limit: typing.Optional[int] = 25,+ page_token: typing.Optional[str] = None,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> HttpResponse[ListTurnsResponse]:+ """+ List turns for a session (newest first by default), token-paginated. Only the session creator may list turns.++ Parameters+ ----------+ session_id : str+ Session identifier.++ limit : typing.Optional[int]+ Page size. Defaults to 25, max 25.++ page_token : typing.Optional[str]+ Opaque token from a previous response `next_page_token`.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[ListTurnsResponse]+ Paginated turns.+ """+ _response = self._client_wrapper.httpx_client.request(+ f"api/v1/sessions/{encode_path_param(session_id)}/turns",+ method="GET",+ params={+ "limit": limit,+ "page_token": page_token,+ },+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ ListTurnsResponse,+ construct_type(+ type_=ListTurnsResponse, # 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(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 403:+ raise ForbiddenError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ @contextlib.contextmanager+ def create_turn_stream(+ self,+ *,+ session_id: str,+ input: typing.Optional[typing.Sequence[TurnInputItem]] = OMIT,+ previous_turn_id: typing.Optional[PreviousTurnIdInput] = OMIT,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> typing.Iterator[HttpResponse[Stream[TurnStreamingEvent]]]:+ """+ Create a turn within a session and execute it.+ Only the session creator may create turns.+ When `stream` is true (default), respond with a Server-Sent Events stream of turn events.+ When `stream` is false, return the turn immediately with `state.status: "running"` while execution continues in the background; use get turn or subscribe to observe completion.+ Use `previous_turn_id` to chain to the session's last turn (defaults to `auto`); use `none` for a new root.++ Parameters+ ----------+ session_id : str+ Session identifier.++ input : typing.Optional[typing.Sequence[TurnInputItem]]+ Turn input items: user messages and/or approval/tool-response resumes. Do not mix user messages with approval or tool-response items.++ previous_turn_id : typing.Optional[PreviousTurnIdInput]++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Yields+ ------+ typing.Iterator[HttpResponse[Stream[TurnStreamingEvent]]]++ """+ with self._client_wrapper.httpx_client.stream(+ f"api/v1/sessions/{encode_path_param(session_id)}/turns",+ method="POST",+ json={+ "input": convert_and_respect_annotation_metadata(+ object_=input, annotation=typing.Sequence[TurnInputItem], direction="write"+ ),+ "previous_turn_id": convert_and_respect_annotation_metadata(+ object_=previous_turn_id, annotation=PreviousTurnIdInput, direction="write"+ ),+ "stream": True,+ },+ headers={+ "content-type": "application/json",+ },+ request_options=request_options,+ omit=OMIT,+ ) as _response:++ def _stream() -> HttpResponse[Stream[TurnStreamingEvent]]:+ try:+ if 200 <= _response.status_code < 300:++ def _iter() -> typing.Generator[StreamEvent[TurnStreamingEvent], None, None]:+ _event_source = EventSource(_response)+ for _sse in _event_source.iter_sse():+ if _sse.data == None:+ return+ if len(_sse.data) == 0:+ continue+ try:+ yield StreamEvent(+ data=typing.cast(+ TurnStreamingEvent,+ parse_sse_obj(+ sse=_sse,+ type_=TurnStreamingEvent, # type: ignore+ ),+ ),+ id=_sse.id or None,+ event=_sse.event,+ retry=_sse.retry,+ )+ except JSONDecodeError as e:+ warning(f"Skipping SSE event with invalid JSON: {e}, sse: {_sse!r}")+ except (TypeError, ValueError, KeyError, AttributeError) as e:+ warning(+ f"Skipping SSE event due to model construction error: {type(e).__name__}: {e}, sse: {_sse!r}"+ )+ except Exception as e:+ error(+ f"Unexpected error processing SSE event: {type(e).__name__}: {e}, sse: {_sse!r}"+ )+ return++ return HttpResponse(response=_response, data=Stream(events=_iter))+ _response.read()+ if _response.status_code == 400:+ raise BadRequestError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 401:+ raise UnauthorizedError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 403:+ raise ForbiddenError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 412:+ raise PreconditionFailedError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 413:+ raise ContentTooLargeError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 422:+ raise UnprocessableEntityError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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+ )+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code,+ headers=dict(_response.headers),+ body=_response.json(),+ cause=e,+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ yield _stream()++ def create_turn(+ self,+ *,+ session_id: str,+ input: typing.Optional[typing.Sequence[TurnInputItem]] = OMIT,+ previous_turn_id: typing.Optional[PreviousTurnIdInput] = OMIT,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> HttpResponse[GetTurnResponse]:+ """+ Create a turn within a session and execute it.+ Only the session creator may create turns.+ When `stream` is true (default), respond with a Server-Sent Events stream of turn events.+ When `stream` is false, return the turn immediately with `state.status: "running"` while execution continues in the background; use get turn or subscribe to observe completion.+ Use `previous_turn_id` to chain to the session's last turn (defaults to `auto`); use `none` for a new root.++ Parameters+ ----------+ session_id : str+ Session identifier.++ input : typing.Optional[typing.Sequence[TurnInputItem]]+ Turn input items: user messages and/or approval/tool-response resumes. Do not mix user messages with approval or tool-response items.++ previous_turn_id : typing.Optional[PreviousTurnIdInput]++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[GetTurnResponse]++ """+ _response = self._client_wrapper.httpx_client.request(+ f"api/v1/sessions/{encode_path_param(session_id)}/turns",+ method="POST",+ json={+ "input": convert_and_respect_annotation_metadata(+ object_=input, annotation=typing.Sequence[TurnInputItem], direction="write"+ ),+ "previous_turn_id": convert_and_respect_annotation_metadata(+ object_=previous_turn_id, annotation=PreviousTurnIdInput, direction="write"+ ),+ "stream": False,+ },+ headers={+ "content-type": "application/json",+ },+ request_options=request_options,+ omit=OMIT,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ GetTurnResponse,+ construct_type(+ type_=GetTurnResponse, # 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(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 401:+ raise UnauthorizedError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 403:+ raise ForbiddenError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 412:+ raise PreconditionFailedError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 413:+ raise ContentTooLargeError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 422:+ raise UnprocessableEntityError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ def get_turn(+ self, *, session_id: str, turn_id: str, request_options: typing.Optional[RequestOptions] = None+ ) -> HttpResponse[GetTurnResponse]:+ """+ Fetch a single turn by ID. Only the session creator may fetch it.++ Parameters+ ----------+ session_id : str+ Session identifier.++ turn_id : str+ Turn identifier.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[GetTurnResponse]+ Turn data.+ """+ _response = self._client_wrapper.httpx_client.request(+ f"api/v1/sessions/{encode_path_param(session_id)}/turns/{encode_path_param(turn_id)}",+ method="GET",+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ GetTurnResponse,+ construct_type(+ type_=GetTurnResponse, # type: ignore+ object_=_response.json(),+ ),+ )+ return HttpResponse(response=_response, data=_data)+ if _response.status_code == 403:+ raise ForbiddenError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ @contextlib.contextmanager+ def download_sandbox_file(+ self, *, session_id: str, turn_id: str, path: str, request_options: typing.Optional[RequestOptions] = None+ ) -> typing.Iterator[HttpResponse[typing.Iterator[bytes]]]:+ """+ Download a file from the sandbox this turn ran in. Paths come from the assistant's `sandbox_artifacts` block. Only the session creator may download.++ Parameters+ ----------+ session_id : str+ Session identifier.++ turn_id : str+ Turn identifier.++ path : str+ Absolute or sandbox-working-directory-relative file path, as listed in the assistant's `sandbox_artifacts` block.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration. You can pass in configuration such as `chunk_size`, and more to customize the request and response.++ Returns+ -------+ typing.Iterator[HttpResponse[typing.Iterator[bytes]]]+ File contents.+ """+ with self._client_wrapper.httpx_client.stream(+ f"api/v1/sessions/{encode_path_param(session_id)}/turns/{encode_path_param(turn_id)}/download-sandbox-file",+ method="GET",+ params={+ "path": path,+ },+ request_options=request_options,+ ) as _response:++ def _stream() -> HttpResponse[typing.Iterator[bytes]]:+ try:+ if 200 <= _response.status_code < 300:+ _chunk_size = request_options.get("chunk_size", None) if request_options is not None else None+ return HttpResponse(+ response=_response, data=(_chunk for _chunk in _response.iter_bytes(chunk_size=_chunk_size))+ )+ _response.read()+ if _response.status_code == 400:+ raise BadRequestError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 403:+ raise ForbiddenError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 410:+ raise GoneError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 412:+ raise PreconditionFailedError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 413:+ raise ContentTooLargeError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 424:+ raise FailedDependencyError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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+ )+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code,+ headers=dict(_response.headers),+ body=_response.json(),+ cause=e,+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ yield _stream()++ def list_turn_events(+ self,+ *,+ session_id: str,+ turn_id: str,+ limit: typing.Optional[int] = 100,+ page_token: typing.Optional[str] = None,+ order: typing.Optional[ListTurnEventsOrder] = None,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> HttpResponse[ListTurnEventsResponse]:+ """+ Paginated persisted events for a turn (insertion order by default). Only the session creator may list events.++ Parameters+ ----------+ session_id : str+ Session identifier.++ turn_id : str+ Turn identifier.++ limit : typing.Optional[int]+ Page size. Defaults to 100, max 100.++ page_token : typing.Optional[str]+ Opaque token from a previous response `next_page_token`.++ order : typing.Optional[ListTurnEventsOrder]+ Sort events by insertion order. Defaults to "asc".++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[ListTurnEventsResponse]+ Paginated turn events.+ """+ _response = self._client_wrapper.httpx_client.request(+ f"api/v1/sessions/{encode_path_param(session_id)}/turns/{encode_path_param(turn_id)}/events",+ method="GET",+ params={+ "limit": limit,+ "page_token": page_token,+ "order": order,+ },+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ ListTurnEventsResponse,+ construct_type(+ type_=ListTurnEventsResponse, # 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(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 403:+ raise ForbiddenError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ @contextlib.contextmanager+ def subscribe_to_turn(+ self,+ *,+ session_id: str,+ turn_id: str,+ after_sequence_number: typing.Optional[int] = None,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> typing.Iterator[HttpResponse[Stream[TurnStreamingEvent]]]:+ """+ Subscribe to the live SSE stream for a turn. Only the session creator may subscribe. Pass `after_sequence_number` to resume after a disconnect (exclusive — events after this sequence number are replayed).++ Parameters+ ----------+ session_id : str+ Session identifier.++ turn_id : str+ Turn identifier.++ after_sequence_number : typing.Optional[int]+ Exclusive resume cursor: replay only events with a sequence number greater than this value. Omit to start from the beginning of the live buffer.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Yields+ ------+ typing.Iterator[HttpResponse[Stream[TurnStreamingEvent]]]+ Server-Sent Events stream of turn events (deltas and lifecycle).+ """+ with self._client_wrapper.httpx_client.stream(+ f"api/v1/sessions/{encode_path_param(session_id)}/turns/{encode_path_param(turn_id)}/subscribe",+ method="GET",+ params={+ "after_sequence_number": after_sequence_number,+ },+ request_options=request_options,+ ) as _response:++ def _stream() -> HttpResponse[Stream[TurnStreamingEvent]]:+ try:+ if 200 <= _response.status_code < 300:++ def _iter() -> typing.Generator[StreamEvent[TurnStreamingEvent], None, None]:+ _event_source = EventSource(_response)+ for _sse in _event_source.iter_sse():+ if _sse.data == None:+ return+ if len(_sse.data) == 0:+ continue+ try:+ yield StreamEvent(+ data=typing.cast(+ TurnStreamingEvent,+ parse_sse_obj(+ sse=_sse,+ type_=TurnStreamingEvent, # type: ignore+ ),+ ),+ id=_sse.id or None,+ event=_sse.event,+ retry=_sse.retry,+ )+ except JSONDecodeError as e:+ warning(f"Skipping SSE event with invalid JSON: {e}, sse: {_sse!r}")+ except (TypeError, ValueError, KeyError, AttributeError) as e:+ warning(+ f"Skipping SSE event due to model construction error: {type(e).__name__}: {e}, sse: {_sse!r}"+ )+ except Exception as e:+ error(+ f"Unexpected error processing SSE event: {type(e).__name__}: {e}, sse: {_sse!r}"+ )+ return++ return HttpResponse(response=_response, data=Stream(events=_iter))+ _response.read()+ if _response.status_code == 400:+ raise BadRequestError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 403:+ raise ForbiddenError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 412:+ raise PreconditionFailedError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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+ )+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code,+ headers=dict(_response.headers),+ body=_response.json(),+ cause=e,+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ yield _stream()+++class AsyncRawSessionsClient:+ def __init__(self, *, client_wrapper: AsyncClientWrapper):+ self._client_wrapper = client_wrapper++ async def list(+ self,+ *,+ limit: typing.Optional[int] = 25,+ order: typing.Optional[ListSessionsOrder] = None,+ page_token: typing.Optional[str] = None,+ start_timestamp: typing.Optional[dt.datetime] = None,+ end_timestamp: typing.Optional[dt.datetime] = None,+ agent_id: typing.Optional[str] = None,+ created_by_me: typing.Optional[bool] = None,+ metadata: typing.Optional[SessionMetadata] = None,+ source_type: typing.Optional[SessionSourceType] = None,+ source_id: typing.Optional[str] = None,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> AsyncHttpResponse[ListSessionsResponse]:+ """+ List the sessions (newest first by default).++ Parameters+ ----------+ limit : typing.Optional[int]+ Page size. Defaults to 25, max 25.++ order : typing.Optional[ListSessionsOrder]+ Sort sessions by `updated_at`. Defaults to "desc".++ page_token : typing.Optional[str]+ Opaque keyset cursor from a previous response `next_page_token`.++ start_timestamp : typing.Optional[dt.datetime]+ Inclusive lower bound on `created_at` (ISO-8601 / RFC 3339).++ end_timestamp : typing.Optional[dt.datetime]+ Inclusive upper bound on `created_at` (ISO-8601 / RFC 3339).++ agent_id : typing.Optional[str]+ When set, only sessions bound to this agent id are returned.++ created_by_me : typing.Optional[bool]+ When true, only sessions created by the authenticated subject.++ metadata : typing.Optional[SessionMetadata]+ Exact metadata pairs as metadata[key]=value. Sessions must contain all pairs.++ source_type : typing.Optional[SessionSourceType]+ When set, returns only sessions created by this source type.++ source_id : typing.Optional[str]+ When set, returns only sessions from this specific source. Requires source_type.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ AsyncHttpResponse[ListSessionsResponse]+ Paginated sessions.+ """+ _response = await self._client_wrapper.httpx_client.request(+ "api/v1/sessions",+ method="GET",+ params={+ "limit": limit,+ "order": order,+ "page_token": page_token,+ "start_timestamp": serialize_datetime(start_timestamp) if start_timestamp is not None else None,+ "end_timestamp": serialize_datetime(end_timestamp) if end_timestamp is not None else None,+ "agent_id": agent_id,+ "created_by_me": created_by_me,+ "metadata": metadata,+ "source_type": source_type,+ "source_id": source_id,+ },+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ ListSessionsResponse,+ construct_type(+ type_=ListSessionsResponse, # 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(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ async def create(+ self,+ *,+ agent: CreateSessionAgent,+ metadata: typing.Optional[SessionMetadata] = OMIT,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> AsyncHttpResponse[GetSessionResponse]:+ """+ Create a session with `agent` as either `{ name }` (named registry binding) or `{ spec: AgentSpec }` (inline). Named sessions snapshot the agent name at create and resolve the live agent on each turn. Responses use `{ type: "reference", name, id }` or `{ type: "inline", spec }`.++ Parameters+ ----------+ agent : CreateSessionAgent++ metadata : typing.Optional[SessionMetadata]++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ AsyncHttpResponse[GetSessionResponse]+ Session created.+ """+ _response = await self._client_wrapper.httpx_client.request(+ "api/v1/sessions",+ method="POST",+ json={+ "agent": convert_and_respect_annotation_metadata(+ object_=agent, annotation=CreateSessionAgent, direction="write"+ ),+ "metadata": metadata,+ },+ headers={+ "content-type": "application/json",+ },+ request_options=request_options,+ omit=OMIT,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ GetSessionResponse,+ construct_type(+ type_=GetSessionResponse, # 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(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 422:+ raise UnprocessableEntityError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ async def get(+ self, *, session_id: str, request_options: typing.Optional[RequestOptions] = None+ ) -> AsyncHttpResponse[GetSessionResponse]:+ """+ Fetch a session by ID. Only the session creator may fetch it.++ Parameters+ ----------+ session_id : str+ Session identifier.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ AsyncHttpResponse[GetSessionResponse]+ Session data.+ """+ _response = await self._client_wrapper.httpx_client.request(+ f"api/v1/sessions/{encode_path_param(session_id)}",+ method="GET",+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ GetSessionResponse,+ construct_type(+ type_=GetSessionResponse, # type: ignore+ object_=_response.json(),+ ),+ )+ return AsyncHttpResponse(response=_response, data=_data)+ if _response.status_code == 403:+ raise ForbiddenError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ async def delete(+ self, *, session_id: str, request_options: typing.Optional[RequestOptions] = None+ ) -> AsyncHttpResponse[None]:+ """+ Delete a session and all related turns, events, and internal state. Only the session creator may delete it. Idempotent if already gone.++ Parameters+ ----------+ session_id : str+ Session identifier.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ AsyncHttpResponse[None]+ """+ _response = await self._client_wrapper.httpx_client.request(+ f"api/v1/sessions/{encode_path_param(session_id)}",+ method="DELETE",+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ return AsyncHttpResponse(response=_response, data=None)+ if _response.status_code == 403:+ raise ForbiddenError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ async def update(+ self,+ *,+ session_id: str,+ agent: typing.Optional[SessionAgentSpecBody] = OMIT,+ metadata: typing.Optional[SessionMetadata] = OMIT,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> AsyncHttpResponse[GetSessionResponse]:+ """+ Update a session by replacing `agent` with `{ spec: AgentSpec }`. Named (reference) sessions reject agent updates. An empty body is a valid no-op that refreshes `updated_at`. Only the session creator may update it.++ Parameters+ ----------+ session_id : str+ Session identifier.++ agent : typing.Optional[SessionAgentSpecBody]++ metadata : typing.Optional[SessionMetadata]++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ AsyncHttpResponse[GetSessionResponse]+ Session updated.+ """+ _response = await self._client_wrapper.httpx_client.request(+ f"api/v1/sessions/{encode_path_param(session_id)}",+ method="PATCH",+ json={+ "agent": convert_and_respect_annotation_metadata(+ object_=agent, annotation=SessionAgentSpecBody, direction="write"+ ),+ "metadata": metadata,+ },+ headers={+ "content-type": "application/json",+ },+ request_options=request_options,+ omit=OMIT,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ GetSessionResponse,+ construct_type(+ type_=GetSessionResponse, # 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(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 403:+ raise ForbiddenError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 422:+ raise UnprocessableEntityError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ async def cancel(+ self, *, session_id: str, request_options: typing.Optional[RequestOptions] = None+ ) -> AsyncHttpResponse[CancelSessionResponse]:+ """+ Cancel the running last turn for a session. Only the session creator may cancel.++ Parameters+ ----------+ session_id : str+ Session identifier.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ AsyncHttpResponse[CancelSessionResponse]+ Turn cancelled.+ """+ _response = await self._client_wrapper.httpx_client.request(+ f"api/v1/sessions/{encode_path_param(session_id)}/cancel",+ method="POST",+ json={},+ headers={+ "content-type": "application/json",+ },+ request_options=request_options,+ omit=OMIT,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ CancelSessionResponse,+ construct_type(+ type_=CancelSessionResponse, # type: ignore+ object_=_response.json(),+ ),+ )+ return AsyncHttpResponse(response=_response, data=_data)+ if _response.status_code == 403:+ raise ForbiddenError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 412:+ raise PreconditionFailedError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ async def list_events(+ self,+ *,+ session_id: str,+ page_token: typing.Optional[str] = None,+ last_turn_id: typing.Optional[str] = None,+ limit: typing.Optional[int] = 100,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> AsyncHttpResponse[ListSessionEventsResponse]:+ """+ List session events as `{ turn_id, event }` across the active turn branch (newest first), including persisted events from a running tip. Each turn contributes turn.created, content events (model.message, tool.call, …), and turn.done when terminal; streaming deltas are not included. Use `page_token` to paginate backward toward older events while retaining the original branch anchor. Only the session creator may list events.++ Parameters+ ----------+ session_id : str+ Session identifier.++ page_token : typing.Optional[str]+ Pagination cursor from `pagination.next_page_token`. It retains the branch anchor turn and returns older events toward the session start.++ last_turn_id : typing.Optional[str]+ Newest turn in the listing window (initial load only; ignored when `page_token` is set). Lists that turn and its ancestors, newest events first. Omit to use the session last turn.++ limit : typing.Optional[int]+ Page size. Defaults to 100, max 100.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ AsyncHttpResponse[ListSessionEventsResponse]+ Paginated session events.+ """+ _response = await self._client_wrapper.httpx_client.request(+ f"api/v1/sessions/{encode_path_param(session_id)}/events",+ method="GET",+ params={+ "page_token": page_token,+ "last_turn_id": last_turn_id,+ "limit": limit,+ },+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ ListSessionEventsResponse,+ construct_type(+ type_=ListSessionEventsResponse, # 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(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 403:+ raise ForbiddenError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ async def list_turns(+ self,+ *,+ session_id: str,+ limit: typing.Optional[int] = 25,+ page_token: typing.Optional[str] = None,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> AsyncHttpResponse[ListTurnsResponse]:+ """+ List turns for a session (newest first by default), token-paginated. Only the session creator may list turns.++ Parameters+ ----------+ session_id : str+ Session identifier.++ limit : typing.Optional[int]+ Page size. Defaults to 25, max 25.++ page_token : typing.Optional[str]+ Opaque token from a previous response `next_page_token`.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ AsyncHttpResponse[ListTurnsResponse]+ Paginated turns.+ """+ _response = await self._client_wrapper.httpx_client.request(+ f"api/v1/sessions/{encode_path_param(session_id)}/turns",+ method="GET",+ params={+ "limit": limit,+ "page_token": page_token,+ },+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ ListTurnsResponse,+ construct_type(+ type_=ListTurnsResponse, # 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(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 403:+ raise ForbiddenError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ @contextlib.asynccontextmanager+ async def create_turn_stream(+ self,+ *,+ session_id: str,+ input: typing.Optional[typing.Sequence[TurnInputItem]] = OMIT,+ previous_turn_id: typing.Optional[PreviousTurnIdInput] = OMIT,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> typing.AsyncIterator[AsyncHttpResponse[AsyncStream[TurnStreamingEvent]]]:+ """+ Create a turn within a session and execute it.+ Only the session creator may create turns.+ When `stream` is true (default), respond with a Server-Sent Events stream of turn events.+ When `stream` is false, return the turn immediately with `state.status: "running"` while execution continues in the background; use get turn or subscribe to observe completion.+ Use `previous_turn_id` to chain to the session's last turn (defaults to `auto`); use `none` for a new root.++ Parameters+ ----------+ session_id : str+ Session identifier.++ input : typing.Optional[typing.Sequence[TurnInputItem]]+ Turn input items: user messages and/or approval/tool-response resumes. Do not mix user messages with approval or tool-response items.++ previous_turn_id : typing.Optional[PreviousTurnIdInput]++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Yields+ ------+ typing.AsyncIterator[AsyncHttpResponse[AsyncStream[TurnStreamingEvent]]]++ """+ async with self._client_wrapper.httpx_client.stream(+ f"api/v1/sessions/{encode_path_param(session_id)}/turns",+ method="POST",+ json={+ "input": convert_and_respect_annotation_metadata(+ object_=input, annotation=typing.Sequence[TurnInputItem], direction="write"+ ),+ "previous_turn_id": convert_and_respect_annotation_metadata(+ object_=previous_turn_id, annotation=PreviousTurnIdInput, direction="write"+ ),+ "stream": True,+ },+ headers={+ "content-type": "application/json",+ },+ request_options=request_options,+ omit=OMIT,+ ) as _response:++ async def _stream() -> AsyncHttpResponse[AsyncStream[TurnStreamingEvent]]:+ try:+ if 200 <= _response.status_code < 300:++ async def _iter() -> typing.AsyncGenerator[StreamEvent[TurnStreamingEvent], None]:+ _event_source = EventSource(_response)+ async for _sse in _event_source.aiter_sse():+ if _sse.data == None:+ return+ if len(_sse.data) == 0:+ continue+ try:+ yield StreamEvent(+ data=typing.cast(+ TurnStreamingEvent,+ parse_sse_obj(+ sse=_sse,+ type_=TurnStreamingEvent, # type: ignore+ ),+ ),+ id=_sse.id or None,+ event=_sse.event,+ retry=_sse.retry,+ )+ except JSONDecodeError as e:+ warning(f"Skipping SSE event with invalid JSON: {e}, sse: {_sse!r}")+ except (TypeError, ValueError, KeyError, AttributeError) as e:+ warning(+ f"Skipping SSE event due to model construction error: {type(e).__name__}: {e}, sse: {_sse!r}"+ )+ except Exception as e:+ error(+ f"Unexpected error processing SSE event: {type(e).__name__}: {e}, sse: {_sse!r}"+ )+ return++ return AsyncHttpResponse(response=_response, data=AsyncStream(events=_iter))+ await _response.aread()+ if _response.status_code == 400:+ raise BadRequestError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 401:+ raise UnauthorizedError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 403:+ raise ForbiddenError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 412:+ raise PreconditionFailedError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 413:+ raise ContentTooLargeError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 422:+ raise UnprocessableEntityError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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+ )+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code,+ headers=dict(_response.headers),+ body=_response.json(),+ cause=e,+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ yield await _stream()++ async def create_turn(+ self,+ *,+ session_id: str,+ input: typing.Optional[typing.Sequence[TurnInputItem]] = OMIT,+ previous_turn_id: typing.Optional[PreviousTurnIdInput] = OMIT,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> AsyncHttpResponse[GetTurnResponse]:+ """+ Create a turn within a session and execute it.+ Only the session creator may create turns.+ When `stream` is true (default), respond with a Server-Sent Events stream of turn events.+ When `stream` is false, return the turn immediately with `state.status: "running"` while execution continues in the background; use get turn or subscribe to observe completion.+ Use `previous_turn_id` to chain to the session's last turn (defaults to `auto`); use `none` for a new root.++ Parameters+ ----------+ session_id : str+ Session identifier.++ input : typing.Optional[typing.Sequence[TurnInputItem]]+ Turn input items: user messages and/or approval/tool-response resumes. Do not mix user messages with approval or tool-response items.++ previous_turn_id : typing.Optional[PreviousTurnIdInput]++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ AsyncHttpResponse[GetTurnResponse]++ """+ _response = await self._client_wrapper.httpx_client.request(+ f"api/v1/sessions/{encode_path_param(session_id)}/turns",+ method="POST",+ json={+ "input": convert_and_respect_annotation_metadata(+ object_=input, annotation=typing.Sequence[TurnInputItem], direction="write"+ ),+ "previous_turn_id": convert_and_respect_annotation_metadata(+ object_=previous_turn_id, annotation=PreviousTurnIdInput, direction="write"+ ),+ "stream": False,+ },+ headers={+ "content-type": "application/json",+ },+ request_options=request_options,+ omit=OMIT,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ GetTurnResponse,+ construct_type(+ type_=GetTurnResponse, # 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(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 401:+ raise UnauthorizedError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 403:+ raise ForbiddenError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 412:+ raise PreconditionFailedError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 413:+ raise ContentTooLargeError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 422:+ raise UnprocessableEntityError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ async def get_turn(+ self, *, session_id: str, turn_id: str, request_options: typing.Optional[RequestOptions] = None+ ) -> AsyncHttpResponse[GetTurnResponse]:+ """+ Fetch a single turn by ID. Only the session creator may fetch it.++ Parameters+ ----------+ session_id : str+ Session identifier.++ turn_id : str+ Turn identifier.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ AsyncHttpResponse[GetTurnResponse]+ Turn data.+ """+ _response = await self._client_wrapper.httpx_client.request(+ f"api/v1/sessions/{encode_path_param(session_id)}/turns/{encode_path_param(turn_id)}",+ method="GET",+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ GetTurnResponse,+ construct_type(+ type_=GetTurnResponse, # type: ignore+ object_=_response.json(),+ ),+ )+ return AsyncHttpResponse(response=_response, data=_data)+ if _response.status_code == 403:+ raise ForbiddenError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ @contextlib.asynccontextmanager+ async def download_sandbox_file(+ self, *, session_id: str, turn_id: str, path: str, request_options: typing.Optional[RequestOptions] = None+ ) -> typing.AsyncIterator[AsyncHttpResponse[typing.AsyncIterator[bytes]]]:+ """+ Download a file from the sandbox this turn ran in. Paths come from the assistant's `sandbox_artifacts` block. Only the session creator may download.++ Parameters+ ----------+ session_id : str+ Session identifier.++ turn_id : str+ Turn identifier.++ path : str+ Absolute or sandbox-working-directory-relative file path, as listed in the assistant's `sandbox_artifacts` block.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration. You can pass in configuration such as `chunk_size`, and more to customize the request and response.++ Returns+ -------+ typing.AsyncIterator[AsyncHttpResponse[typing.AsyncIterator[bytes]]]+ File contents.+ """+ async with self._client_wrapper.httpx_client.stream(+ f"api/v1/sessions/{encode_path_param(session_id)}/turns/{encode_path_param(turn_id)}/download-sandbox-file",+ method="GET",+ params={+ "path": path,+ },+ request_options=request_options,+ ) as _response:++ async def _stream() -> AsyncHttpResponse[typing.AsyncIterator[bytes]]:+ try:+ if 200 <= _response.status_code < 300:+ _chunk_size = request_options.get("chunk_size", None) if request_options is not None else None+ return AsyncHttpResponse(+ response=_response,+ data=(_chunk async for _chunk in _response.aiter_bytes(chunk_size=_chunk_size)),+ )+ await _response.aread()+ if _response.status_code == 400:+ raise BadRequestError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 403:+ raise ForbiddenError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 410:+ raise GoneError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 412:+ raise PreconditionFailedError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 413:+ raise ContentTooLargeError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 424:+ raise FailedDependencyError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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+ )+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code,+ headers=dict(_response.headers),+ body=_response.json(),+ cause=e,+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ yield await _stream()++ async def list_turn_events(+ self,+ *,+ session_id: str,+ turn_id: str,+ limit: typing.Optional[int] = 100,+ page_token: typing.Optional[str] = None,+ order: typing.Optional[ListTurnEventsOrder] = None,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> AsyncHttpResponse[ListTurnEventsResponse]:+ """+ Paginated persisted events for a turn (insertion order by default). Only the session creator may list events.++ Parameters+ ----------+ session_id : str+ Session identifier.++ turn_id : str+ Turn identifier.++ limit : typing.Optional[int]+ Page size. Defaults to 100, max 100.++ page_token : typing.Optional[str]+ Opaque token from a previous response `next_page_token`.++ order : typing.Optional[ListTurnEventsOrder]+ Sort events by insertion order. Defaults to "asc".++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ AsyncHttpResponse[ListTurnEventsResponse]+ Paginated turn events.+ """+ _response = await self._client_wrapper.httpx_client.request(+ f"api/v1/sessions/{encode_path_param(session_id)}/turns/{encode_path_param(turn_id)}/events",+ method="GET",+ params={+ "limit": limit,+ "page_token": page_token,+ "order": order,+ },+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ ListTurnEventsResponse,+ construct_type(+ type_=ListTurnEventsResponse, # 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(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 403:+ raise ForbiddenError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ @contextlib.asynccontextmanager+ async def subscribe_to_turn(+ self,+ *,+ session_id: str,+ turn_id: str,+ after_sequence_number: typing.Optional[int] = None,+ request_options: typing.Optional[RequestOptions] = None,+ ) -> typing.AsyncIterator[AsyncHttpResponse[AsyncStream[TurnStreamingEvent]]]:+ """+ Subscribe to the live SSE stream for a turn. Only the session creator may subscribe. Pass `after_sequence_number` to resume after a disconnect (exclusive — events after this sequence number are replayed).++ Parameters+ ----------+ session_id : str+ Session identifier.++ turn_id : str+ Turn identifier.++ after_sequence_number : typing.Optional[int]+ Exclusive resume cursor: replay only events with a sequence number greater than this value. Omit to start from the beginning of the live buffer.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Yields+ ------+ typing.AsyncIterator[AsyncHttpResponse[AsyncStream[TurnStreamingEvent]]]+ Server-Sent Events stream of turn events (deltas and lifecycle).+ """+ async with self._client_wrapper.httpx_client.stream(+ f"api/v1/sessions/{encode_path_param(session_id)}/turns/{encode_path_param(turn_id)}/subscribe",+ method="GET",+ params={+ "after_sequence_number": after_sequence_number,+ },+ request_options=request_options,+ ) as _response:++ async def _stream() -> AsyncHttpResponse[AsyncStream[TurnStreamingEvent]]:+ try:+ if 200 <= _response.status_code < 300:++ async def _iter() -> typing.AsyncGenerator[StreamEvent[TurnStreamingEvent], None]:+ _event_source = EventSource(_response)+ async for _sse in _event_source.aiter_sse():+ if _sse.data == None:+ return+ if len(_sse.data) == 0:+ continue+ try:+ yield StreamEvent(+ data=typing.cast(+ TurnStreamingEvent,+ parse_sse_obj(+ sse=_sse,+ type_=TurnStreamingEvent, # type: ignore+ ),+ ),+ id=_sse.id or None,+ event=_sse.event,+ retry=_sse.retry,+ )+ except JSONDecodeError as e:+ warning(f"Skipping SSE event with invalid JSON: {e}, sse: {_sse!r}")+ except (TypeError, ValueError, KeyError, AttributeError) as e:+ warning(+ f"Skipping SSE event due to model construction error: {type(e).__name__}: {e}, sse: {_sse!r}"+ )+ except Exception as e:+ error(+ f"Unexpected error processing SSE event: {type(e).__name__}: {e}, sse: {_sse!r}"+ )+ return++ return AsyncHttpResponse(response=_response, data=AsyncStream(events=_iter))+ await _response.aread()+ if _response.status_code == 400:+ raise BadRequestError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 403:+ raise ForbiddenError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 412:+ raise PreconditionFailedError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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+ )+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code,+ headers=dict(_response.headers),+ body=_response.json(),+ cause=e,+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ yield await _stream()diff --git a/python/trueforge_sdk/src/trueforge_sdk/settings/__init__.py b/python/trueforge_sdk/src/trueforge_sdk/settings/__init__.pynew file mode 100644index 000000000..c8555edfe--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/settings/__init__.py@@ -0,0 +1,39 @@+# This file was auto-generated by Fern from our API Definition.++# isort: skip_file++import typing+from importlib import import_module++if typing.TYPE_CHECKING:+ from . import mcp_servers, model_providers, sandbox_providers, skills+_dynamic_imports: typing.Dict[str, str] = {+ "mcp_servers": ".mcp_servers",+ "model_providers": ".model_providers",+ "sandbox_providers": ".sandbox_providers",+ "skills": ".skills",+}+++def __getattr__(attr_name: str) -> typing.Any:+ module_name = _dynamic_imports.get(attr_name)+ if module_name is None:+ raise AttributeError(f"No {attr_name} found in _dynamic_imports for module name -> {__name__}")+ try:+ module = import_module(module_name, __package__)+ if module_name == f".{attr_name}":+ return module+ else:+ return getattr(module, attr_name)+ except ImportError as e:+ raise ImportError(f"Failed to import {attr_name} from {module_name}: {e}") from e+ except AttributeError as e:+ raise AttributeError(f"Failed to get {attr_name} from {module_name}: {e}") from e+++def __dir__():+ lazy_attrs = list(_dynamic_imports.keys())+ return sorted(lazy_attrs)+++__all__ = ["mcp_servers", "model_providers", "sandbox_providers", "skills"]diff --git a/python/trueforge_sdk/src/trueforge_sdk/settings/client.py b/python/trueforge_sdk/src/trueforge_sdk/settings/client.pynew file mode 100644index 000000000..26014cb68--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/settings/client.py@@ -0,0 +1,120 @@+# This file was auto-generated by Fern from our API Definition.++from __future__ import annotations++import typing++from ..core.client_wrapper import AsyncClientWrapper, SyncClientWrapper+from .raw_client import AsyncRawSettingsClient, RawSettingsClient++if typing.TYPE_CHECKING:+ from .mcp_servers.client import AsyncMcpServersClient, McpServersClient+ from .model_providers.client import AsyncModelProvidersClient, ModelProvidersClient+ from .sandbox_providers.client import AsyncSandboxProvidersClient, SandboxProvidersClient+ from .skills.client import AsyncSkillsClient, SkillsClient+++class SettingsClient:+ def __init__(self, *, client_wrapper: SyncClientWrapper):+ self._raw_client = RawSettingsClient(client_wrapper=client_wrapper)+ self._client_wrapper = client_wrapper+ self._mcp_servers: typing.Optional[McpServersClient] = None+ self._model_providers: typing.Optional[ModelProvidersClient] = None+ self._sandbox_providers: typing.Optional[SandboxProvidersClient] = None+ self._skills: typing.Optional[SkillsClient] = None++ @property+ def with_raw_response(self) -> RawSettingsClient:+ """+ Retrieves a raw implementation of this client that returns raw responses.++ Returns+ -------+ RawSettingsClient+ """+ return self._raw_client++ @property+ def mcp_servers(self):+ if self._mcp_servers is None:+ from .mcp_servers.client import McpServersClient # noqa: E402++ self._mcp_servers = McpServersClient(client_wrapper=self._client_wrapper)+ return self._mcp_servers++ @property+ def model_providers(self):+ if self._model_providers is None:+ from .model_providers.client import ModelProvidersClient # noqa: E402++ self._model_providers = ModelProvidersClient(client_wrapper=self._client_wrapper)+ return self._model_providers++ @property+ def sandbox_providers(self):+ if self._sandbox_providers is None:+ from .sandbox_providers.client import SandboxProvidersClient # noqa: E402++ self._sandbox_providers = SandboxProvidersClient(client_wrapper=self._client_wrapper)+ return self._sandbox_providers++ @property+ def skills(self):+ if self._skills is None:+ from .skills.client import SkillsClient # noqa: E402++ self._skills = SkillsClient(client_wrapper=self._client_wrapper)+ return self._skills+++class AsyncSettingsClient:+ def __init__(self, *, client_wrapper: AsyncClientWrapper):+ self._raw_client = AsyncRawSettingsClient(client_wrapper=client_wrapper)+ self._client_wrapper = client_wrapper+ self._mcp_servers: typing.Optional[AsyncMcpServersClient] = None+ self._model_providers: typing.Optional[AsyncModelProvidersClient] = None+ self._sandbox_providers: typing.Optional[AsyncSandboxProvidersClient] = None+ self._skills: typing.Optional[AsyncSkillsClient] = None++ @property+ def with_raw_response(self) -> AsyncRawSettingsClient:+ """+ Retrieves a raw implementation of this client that returns raw responses.++ Returns+ -------+ AsyncRawSettingsClient+ """+ return self._raw_client++ @property+ def mcp_servers(self):+ if self._mcp_servers is None:+ from .mcp_servers.client import AsyncMcpServersClient # noqa: E402++ self._mcp_servers = AsyncMcpServersClient(client_wrapper=self._client_wrapper)+ return self._mcp_servers++ @property+ def model_providers(self):+ if self._model_providers is None:+ from .model_providers.client import AsyncModelProvidersClient # noqa: E402++ self._model_providers = AsyncModelProvidersClient(client_wrapper=self._client_wrapper)+ return self._model_providers++ @property+ def sandbox_providers(self):+ if self._sandbox_providers is None:+ from .sandbox_providers.client import AsyncSandboxProvidersClient # noqa: E402++ self._sandbox_providers = AsyncSandboxProvidersClient(client_wrapper=self._client_wrapper)+ return self._sandbox_providers++ @property+ def skills(self):+ if self._skills is None:+ from .skills.client import AsyncSkillsClient # noqa: E402++ self._skills = AsyncSkillsClient(client_wrapper=self._client_wrapper)+ return self._skillsdiff --git a/python/trueforge_sdk/src/trueforge_sdk/settings/mcp_servers/__init__.py b/python/trueforge_sdk/src/trueforge_sdk/settings/mcp_servers/__init__.pynew file mode 100644index 000000000..5cde0202d--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/settings/mcp_servers/__init__.py@@ -0,0 +1,4 @@+# This file was auto-generated by Fern from our API Definition.++# isort: skip_file+diff --git a/python/trueforge_sdk/src/trueforge_sdk/settings/mcp_servers/client.py b/python/trueforge_sdk/src/trueforge_sdk/settings/mcp_servers/client.pynew file mode 100644index 000000000..4f362251d--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/settings/mcp_servers/client.py@@ -0,0 +1,343 @@+# This file was auto-generated by Fern from our API Definition.++import typing++from ...core.client_wrapper import AsyncClientWrapper, SyncClientWrapper+from ...core.request_options import RequestOptions+from ...types.get_mcp_server_response import GetMcpServerResponse+from ...types.list_mcp_servers_response import ListMcpServersResponse+from ...types.mcp_server_manifest import McpServerManifest+from .raw_client import AsyncRawMcpServersClient, RawMcpServersClient++# this is used as the default value for optional parameters+OMIT = typing.cast(typing.Any, ...)+++class McpServersClient:+ def __init__(self, *, client_wrapper: SyncClientWrapper):+ self._raw_client = RawMcpServersClient(client_wrapper=client_wrapper)++ @property+ def with_raw_response(self) -> RawMcpServersClient:+ """+ Retrieves a raw implementation of this client that returns raw responses.++ Returns+ -------+ RawMcpServersClient+ """+ return self._raw_client++ def list(self, *, request_options: typing.Optional[RequestOptions] = None) -> ListMcpServersResponse:+ """+ Configured MCP servers with auth_status. Header secrets are redacted.++ Parameters+ ----------+ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ ListMcpServersResponse+ All configured MCP servers++ Examples+ --------+ from trueforge_sdk import TrueForge++ client = TrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+ client.settings.mcp_servers.list()+ """+ _response = self._raw_client.list(request_options=request_options)+ return _response.data++ def create(+ self, *, manifest: McpServerManifest, request_options: typing.Optional[RequestOptions] = None+ ) -> GetMcpServerResponse:+ """+ Creates an MCP server by `name`. Fails if `name` is already taken. Runs DCR registration when `auth.type` is `dcr`. Header secrets: real value required; redacted with no stored value returns 400.++ Parameters+ ----------+ manifest : McpServerManifest++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ GetMcpServerResponse+ The created MCP server with auth_status++ Examples+ --------+ from trueforge_sdk import RemoteMcpServerManifest, TrueForge++ client = TrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+ client.settings.mcp_servers.create(+ manifest=RemoteMcpServerManifest(+ description="description",+ name="name",+ url="url",+ ),+ )+ """+ _response = self._raw_client.create(manifest=manifest, request_options=request_options)+ return _response.data++ def create_or_update(+ self, *, manifest: McpServerManifest, request_options: typing.Optional[RequestOptions] = None+ ) -> GetMcpServerResponse:+ """+ Create or replace by `name`. Header secrets: real value sets/rotates; redacted keeps existing (400 if none).++ Parameters+ ----------+ manifest : McpServerManifest++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ GetMcpServerResponse+ The saved MCP server with auth_status++ Examples+ --------+ from trueforge_sdk import RemoteMcpServerManifest, TrueForge++ client = TrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+ client.settings.mcp_servers.create_or_update(+ manifest=RemoteMcpServerManifest(+ description="description",+ name="name",+ url="url",+ ),+ )+ """+ _response = self._raw_client.create_or_update(manifest=manifest, request_options=request_options)+ return _response.data++ def get(self, *, name: str, request_options: typing.Optional[RequestOptions] = None) -> GetMcpServerResponse:+ """+ A single MCP server by name, with nested live auth_status (settings / admin projection). Header auth values are redacted.++ Parameters+ ----------+ name : str+ MCP server name.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ GetMcpServerResponse+ The MCP server++ Examples+ --------+ from trueforge_sdk import TrueForge++ client = TrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+ client.settings.mcp_servers.get(+ name="name",+ )+ """+ _response = self._raw_client.get(name=name, request_options=request_options)+ return _response.data+++class AsyncMcpServersClient:+ def __init__(self, *, client_wrapper: AsyncClientWrapper):+ self._raw_client = AsyncRawMcpServersClient(client_wrapper=client_wrapper)++ @property+ def with_raw_response(self) -> AsyncRawMcpServersClient:+ """+ Retrieves a raw implementation of this client that returns raw responses.++ Returns+ -------+ AsyncRawMcpServersClient+ """+ return self._raw_client++ async def list(self, *, request_options: typing.Optional[RequestOptions] = None) -> ListMcpServersResponse:+ """+ Configured MCP servers with auth_status. Header secrets are redacted.++ Parameters+ ----------+ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ ListMcpServersResponse+ All configured MCP servers++ Examples+ --------+ import asyncio++ from trueforge_sdk import AsyncTrueForge++ client = AsyncTrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+++ async def main() -> None:+ await client.settings.mcp_servers.list()+++ asyncio.run(main())+ """+ _response = await self._raw_client.list(request_options=request_options)+ return _response.data++ async def create(+ self, *, manifest: McpServerManifest, request_options: typing.Optional[RequestOptions] = None+ ) -> GetMcpServerResponse:+ """+ Creates an MCP server by `name`. Fails if `name` is already taken. Runs DCR registration when `auth.type` is `dcr`. Header secrets: real value required; redacted with no stored value returns 400.++ Parameters+ ----------+ manifest : McpServerManifest++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ GetMcpServerResponse+ The created MCP server with auth_status++ Examples+ --------+ import asyncio++ from trueforge_sdk import AsyncTrueForge, RemoteMcpServerManifest++ client = AsyncTrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+++ async def main() -> None:+ await client.settings.mcp_servers.create(+ manifest=RemoteMcpServerManifest(+ description="description",+ name="name",+ url="url",+ ),+ )+++ asyncio.run(main())+ """+ _response = await self._raw_client.create(manifest=manifest, request_options=request_options)+ return _response.data++ async def create_or_update(+ self, *, manifest: McpServerManifest, request_options: typing.Optional[RequestOptions] = None+ ) -> GetMcpServerResponse:+ """+ Create or replace by `name`. Header secrets: real value sets/rotates; redacted keeps existing (400 if none).++ Parameters+ ----------+ manifest : McpServerManifest++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ GetMcpServerResponse+ The saved MCP server with auth_status++ Examples+ --------+ import asyncio++ from trueforge_sdk import AsyncTrueForge, RemoteMcpServerManifest++ client = AsyncTrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+++ async def main() -> None:+ await client.settings.mcp_servers.create_or_update(+ manifest=RemoteMcpServerManifest(+ description="description",+ name="name",+ url="url",+ ),+ )+++ asyncio.run(main())+ """+ _response = await self._raw_client.create_or_update(manifest=manifest, request_options=request_options)+ return _response.data++ async def get(self, *, name: str, request_options: typing.Optional[RequestOptions] = None) -> GetMcpServerResponse:+ """+ A single MCP server by name, with nested live auth_status (settings / admin projection). Header auth values are redacted.++ Parameters+ ----------+ name : str+ MCP server name.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ GetMcpServerResponse+ The MCP server++ Examples+ --------+ import asyncio++ from trueforge_sdk import AsyncTrueForge++ client = AsyncTrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+++ async def main() -> None:+ await client.settings.mcp_servers.get(+ name="name",+ )+++ asyncio.run(main())+ """+ _response = await self._raw_client.get(name=name, request_options=request_options)+ return _response.datadiff --git a/python/trueforge_sdk/src/trueforge_sdk/settings/mcp_servers/raw_client.py b/python/trueforge_sdk/src/trueforge_sdk/settings/mcp_servers/raw_client.pynew file mode 100644index 000000000..7debcbada--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/settings/mcp_servers/raw_client.py@@ -0,0 +1,626 @@+# 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.jsonable_encoder import encode_path_param+from ...core.parse_error import ParsingError+from ...core.request_options import RequestOptions+from ...core.serialization import convert_and_respect_annotation_metadata+from ...core.unchecked_base_model import construct_type+from ...errors.bad_request_error import BadRequestError+from ...errors.conflict_error import ConflictError+from ...errors.failed_dependency_error import FailedDependencyError+from ...errors.forbidden_error import ForbiddenError+from ...errors.not_found_error import NotFoundError+from ...errors.unauthorized_error import UnauthorizedError+from ...errors.unprocessable_entity_error import UnprocessableEntityError+from ...types.get_mcp_server_response import GetMcpServerResponse+from ...types.list_mcp_servers_response import ListMcpServersResponse+from ...types.mcp_server_manifest import McpServerManifest+from ...types.request_error_response import RequestErrorResponse+from pydantic import ValidationError++# this is used as the default value for optional parameters+OMIT = typing.cast(typing.Any, ...)+++class RawMcpServersClient:+ def __init__(self, *, client_wrapper: SyncClientWrapper):+ self._client_wrapper = client_wrapper++ def list(self, *, request_options: typing.Optional[RequestOptions] = None) -> HttpResponse[ListMcpServersResponse]:+ """+ Configured MCP servers with auth_status. Header secrets are redacted.++ Parameters+ ----------+ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[ListMcpServersResponse]+ All configured MCP servers+ """+ _response = self._client_wrapper.httpx_client.request(+ "api/v1/settings/mcp-servers",+ method="GET",+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ ListMcpServersResponse,+ construct_type(+ type_=ListMcpServersResponse, # type: ignore+ object_=_response.json(),+ ),+ )+ return HttpResponse(response=_response, data=_data)+ if _response.status_code == 401:+ raise UnauthorizedError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 403:+ raise ForbiddenError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ def create(+ self, *, manifest: McpServerManifest, request_options: typing.Optional[RequestOptions] = None+ ) -> HttpResponse[GetMcpServerResponse]:+ """+ Creates an MCP server by `name`. Fails if `name` is already taken. Runs DCR registration when `auth.type` is `dcr`. Header secrets: real value required; redacted with no stored value returns 400.++ Parameters+ ----------+ manifest : McpServerManifest++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[GetMcpServerResponse]+ The created MCP server with auth_status+ """+ _response = self._client_wrapper.httpx_client.request(+ "api/v1/settings/mcp-servers",+ method="POST",+ json={+ "manifest": convert_and_respect_annotation_metadata(+ object_=manifest, annotation=McpServerManifest, direction="write"+ ),+ },+ headers={+ "content-type": "application/json",+ },+ request_options=request_options,+ omit=OMIT,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ GetMcpServerResponse,+ construct_type(+ type_=GetMcpServerResponse, # 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(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 409:+ raise ConflictError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 422:+ raise UnprocessableEntityError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 424:+ raise FailedDependencyError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ def create_or_update(+ self, *, manifest: McpServerManifest, request_options: typing.Optional[RequestOptions] = None+ ) -> HttpResponse[GetMcpServerResponse]:+ """+ Create or replace by `name`. Header secrets: real value sets/rotates; redacted keeps existing (400 if none).++ Parameters+ ----------+ manifest : McpServerManifest++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[GetMcpServerResponse]+ The saved MCP server with auth_status+ """+ _response = self._client_wrapper.httpx_client.request(+ "api/v1/settings/mcp-servers",+ method="PUT",+ json={+ "manifest": convert_and_respect_annotation_metadata(+ object_=manifest, annotation=McpServerManifest, direction="write"+ ),+ },+ headers={+ "content-type": "application/json",+ },+ request_options=request_options,+ omit=OMIT,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ GetMcpServerResponse,+ construct_type(+ type_=GetMcpServerResponse, # 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(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 422:+ raise UnprocessableEntityError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 424:+ raise FailedDependencyError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ def get(+ self, *, name: str, request_options: typing.Optional[RequestOptions] = None+ ) -> HttpResponse[GetMcpServerResponse]:+ """+ A single MCP server by name, with nested live auth_status (settings / admin projection). Header auth values are redacted.++ Parameters+ ----------+ name : str+ MCP server name.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[GetMcpServerResponse]+ The MCP server+ """+ _response = self._client_wrapper.httpx_client.request(+ f"api/v1/settings/mcp-servers/{encode_path_param(name)}",+ method="GET",+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ GetMcpServerResponse,+ construct_type(+ type_=GetMcpServerResponse, # type: ignore+ object_=_response.json(),+ ),+ )+ return HttpResponse(response=_response, data=_data)+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)+++class AsyncRawMcpServersClient:+ def __init__(self, *, client_wrapper: AsyncClientWrapper):+ self._client_wrapper = client_wrapper++ async def list(+ self, *, request_options: typing.Optional[RequestOptions] = None+ ) -> AsyncHttpResponse[ListMcpServersResponse]:+ """+ Configured MCP servers with auth_status. Header secrets are redacted.++ Parameters+ ----------+ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ AsyncHttpResponse[ListMcpServersResponse]+ All configured MCP servers+ """+ _response = await self._client_wrapper.httpx_client.request(+ "api/v1/settings/mcp-servers",+ method="GET",+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ ListMcpServersResponse,+ construct_type(+ type_=ListMcpServersResponse, # type: ignore+ object_=_response.json(),+ ),+ )+ return AsyncHttpResponse(response=_response, data=_data)+ if _response.status_code == 401:+ raise UnauthorizedError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 403:+ raise ForbiddenError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ async def create(+ self, *, manifest: McpServerManifest, request_options: typing.Optional[RequestOptions] = None+ ) -> AsyncHttpResponse[GetMcpServerResponse]:+ """+ Creates an MCP server by `name`. Fails if `name` is already taken. Runs DCR registration when `auth.type` is `dcr`. Header secrets: real value required; redacted with no stored value returns 400.++ Parameters+ ----------+ manifest : McpServerManifest++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ AsyncHttpResponse[GetMcpServerResponse]+ The created MCP server with auth_status+ """+ _response = await self._client_wrapper.httpx_client.request(+ "api/v1/settings/mcp-servers",+ method="POST",+ json={+ "manifest": convert_and_respect_annotation_metadata(+ object_=manifest, annotation=McpServerManifest, direction="write"+ ),+ },+ headers={+ "content-type": "application/json",+ },+ request_options=request_options,+ omit=OMIT,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ GetMcpServerResponse,+ construct_type(+ type_=GetMcpServerResponse, # 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(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 409:+ raise ConflictError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 422:+ raise UnprocessableEntityError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 424:+ raise FailedDependencyError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ async def create_or_update(+ self, *, manifest: McpServerManifest, request_options: typing.Optional[RequestOptions] = None+ ) -> AsyncHttpResponse[GetMcpServerResponse]:+ """+ Create or replace by `name`. Header secrets: real value sets/rotates; redacted keeps existing (400 if none).++ Parameters+ ----------+ manifest : McpServerManifest++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ AsyncHttpResponse[GetMcpServerResponse]+ The saved MCP server with auth_status+ """+ _response = await self._client_wrapper.httpx_client.request(+ "api/v1/settings/mcp-servers",+ method="PUT",+ json={+ "manifest": convert_and_respect_annotation_metadata(+ object_=manifest, annotation=McpServerManifest, direction="write"+ ),+ },+ headers={+ "content-type": "application/json",+ },+ request_options=request_options,+ omit=OMIT,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ GetMcpServerResponse,+ construct_type(+ type_=GetMcpServerResponse, # 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(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 422:+ raise UnprocessableEntityError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 424:+ raise FailedDependencyError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ async def get(+ self, *, name: str, request_options: typing.Optional[RequestOptions] = None+ ) -> AsyncHttpResponse[GetMcpServerResponse]:+ """+ A single MCP server by name, with nested live auth_status (settings / admin projection). Header auth values are redacted.++ Parameters+ ----------+ name : str+ MCP server name.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ AsyncHttpResponse[GetMcpServerResponse]+ The MCP server+ """+ _response = await self._client_wrapper.httpx_client.request(+ f"api/v1/settings/mcp-servers/{encode_path_param(name)}",+ method="GET",+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ GetMcpServerResponse,+ construct_type(+ type_=GetMcpServerResponse, # type: ignore+ object_=_response.json(),+ ),+ )+ return AsyncHttpResponse(response=_response, data=_data)+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)diff --git a/python/trueforge_sdk/src/trueforge_sdk/settings/model_providers/__init__.py b/python/trueforge_sdk/src/trueforge_sdk/settings/model_providers/__init__.pynew file mode 100644index 000000000..5cde0202d--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/settings/model_providers/__init__.py@@ -0,0 +1,4 @@+# This file was auto-generated by Fern from our API Definition.++# isort: skip_file+diff --git a/python/trueforge_sdk/src/trueforge_sdk/settings/model_providers/client.py b/python/trueforge_sdk/src/trueforge_sdk/settings/model_providers/client.pynew file mode 100644index 000000000..9a39bca0e--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/settings/model_providers/client.py@@ -0,0 +1,323 @@+# This file was auto-generated by Fern from our API Definition.++import typing++from ...core.client_wrapper import AsyncClientWrapper, SyncClientWrapper+from ...core.request_options import RequestOptions+from ...types.get_model_provider_response import GetModelProviderResponse+from ...types.list_model_providers_response import ListModelProvidersResponse+from ...types.model_provider_manifest import ModelProviderManifest+from .raw_client import AsyncRawModelProvidersClient, RawModelProvidersClient++# this is used as the default value for optional parameters+OMIT = typing.cast(typing.Any, ...)+++class ModelProvidersClient:+ def __init__(self, *, client_wrapper: SyncClientWrapper):+ self._raw_client = RawModelProvidersClient(client_wrapper=client_wrapper)++ @property+ def with_raw_response(self) -> RawModelProvidersClient:+ """+ Retrieves a raw implementation of this client that returns raw responses.++ Returns+ -------+ RawModelProvidersClient+ """+ return self._raw_client++ def list(self, *, request_options: typing.Optional[RequestOptions] = None) -> ListModelProvidersResponse:+ """+ All configured providers with nested manifests.++ Parameters+ ----------+ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ ListModelProvidersResponse+ All configured model providers++ Examples+ --------+ from trueforge_sdk import TrueForge++ client = TrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+ client.settings.model_providers.list()+ """+ _response = self._raw_client.list(request_options=request_options)+ return _response.data++ def create(+ self, *, manifest: ModelProviderManifest, request_options: typing.Optional[RequestOptions] = None+ ) -> GetModelProviderResponse:+ """+ Creates a provider (models included). Fails if `name` is already taken. Well-known types use `type` as `name` (one each); `custom` is named by the caller. `auth.api_key`: real value required; redacted with no stored secret returns 400.++ Parameters+ ----------+ manifest : ModelProviderManifest++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ GetModelProviderResponse+ The created provider++ Examples+ --------+ from trueforge_sdk import (+ AlibabaModelProvider,+ ConfiguredModel,+ ModelProperties,+ ModelProviderAuth,+ TrueForge,+ )++ client = TrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+ client.settings.model_providers.create(+ manifest=AlibabaModelProvider(+ auth=ModelProviderAuth(+ api_key="api_key",+ ),+ models=[+ ConfiguredModel(+ model_id="model_id",+ name="name",+ properties=ModelProperties(),+ )+ ],+ ),+ )+ """+ _response = self._raw_client.create(manifest=manifest, request_options=request_options)+ return _response.data++ def create_or_update(+ self, *, manifest: ModelProviderManifest, request_options: typing.Optional[RequestOptions] = None+ ) -> GetModelProviderResponse:+ """+ Create or replace a provider (models included). Well-known types use `type` as `name` (one each); `custom` is named by the caller. `auth.api_key`: real value sets/rotates; redacted keeps existing (400 if none).++ Parameters+ ----------+ manifest : ModelProviderManifest++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ GetModelProviderResponse+ The saved provider++ Examples+ --------+ from trueforge_sdk import (+ AlibabaModelProvider,+ ConfiguredModel,+ ModelProperties,+ ModelProviderAuth,+ TrueForge,+ )++ client = TrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+ client.settings.model_providers.create_or_update(+ manifest=AlibabaModelProvider(+ auth=ModelProviderAuth(+ api_key="api_key",+ ),+ models=[+ ConfiguredModel(+ model_id="model_id",+ name="name",+ properties=ModelProperties(),+ )+ ],+ ),+ )+ """+ _response = self._raw_client.create_or_update(manifest=manifest, request_options=request_options)+ return _response.data+++class AsyncModelProvidersClient:+ def __init__(self, *, client_wrapper: AsyncClientWrapper):+ self._raw_client = AsyncRawModelProvidersClient(client_wrapper=client_wrapper)++ @property+ def with_raw_response(self) -> AsyncRawModelProvidersClient:+ """+ Retrieves a raw implementation of this client that returns raw responses.++ Returns+ -------+ AsyncRawModelProvidersClient+ """+ return self._raw_client++ async def list(self, *, request_options: typing.Optional[RequestOptions] = None) -> ListModelProvidersResponse:+ """+ All configured providers with nested manifests.++ Parameters+ ----------+ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ ListModelProvidersResponse+ All configured model providers++ Examples+ --------+ import asyncio++ from trueforge_sdk import AsyncTrueForge++ client = AsyncTrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+++ async def main() -> None:+ await client.settings.model_providers.list()+++ asyncio.run(main())+ """+ _response = await self._raw_client.list(request_options=request_options)+ return _response.data++ async def create(+ self, *, manifest: ModelProviderManifest, request_options: typing.Optional[RequestOptions] = None+ ) -> GetModelProviderResponse:+ """+ Creates a provider (models included). Fails if `name` is already taken. Well-known types use `type` as `name` (one each); `custom` is named by the caller. `auth.api_key`: real value required; redacted with no stored secret returns 400.++ Parameters+ ----------+ manifest : ModelProviderManifest++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ GetModelProviderResponse+ The created provider++ Examples+ --------+ import asyncio++ from trueforge_sdk import (+ AlibabaModelProvider,+ AsyncTrueForge,+ ConfiguredModel,+ ModelProperties,+ ModelProviderAuth,+ )++ client = AsyncTrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+++ async def main() -> None:+ await client.settings.model_providers.create(+ manifest=AlibabaModelProvider(+ auth=ModelProviderAuth(+ api_key="api_key",+ ),+ models=[+ ConfiguredModel(+ model_id="model_id",+ name="name",+ properties=ModelProperties(),+ )+ ],+ ),+ )+++ asyncio.run(main())+ """+ _response = await self._raw_client.create(manifest=manifest, request_options=request_options)+ return _response.data++ async def create_or_update(+ self, *, manifest: ModelProviderManifest, request_options: typing.Optional[RequestOptions] = None+ ) -> GetModelProviderResponse:+ """+ Create or replace a provider (models included). Well-known types use `type` as `name` (one each); `custom` is named by the caller. `auth.api_key`: real value sets/rotates; redacted keeps existing (400 if none).++ Parameters+ ----------+ manifest : ModelProviderManifest++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ GetModelProviderResponse+ The saved provider++ Examples+ --------+ import asyncio++ from trueforge_sdk import (+ AlibabaModelProvider,+ AsyncTrueForge,+ ConfiguredModel,+ ModelProperties,+ ModelProviderAuth,+ )++ client = AsyncTrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+++ async def main() -> None:+ await client.settings.model_providers.create_or_update(+ manifest=AlibabaModelProvider(+ auth=ModelProviderAuth(+ api_key="api_key",+ ),+ models=[+ ConfiguredModel(+ model_id="model_id",+ name="name",+ properties=ModelProperties(),+ )+ ],+ ),+ )+++ asyncio.run(main())+ """+ _response = await self._raw_client.create_or_update(manifest=manifest, request_options=request_options)+ return _response.datadiff --git a/python/trueforge_sdk/src/trueforge_sdk/settings/model_providers/raw_client.py b/python/trueforge_sdk/src/trueforge_sdk/settings/model_providers/raw_client.pynew file mode 100644index 000000000..a05073e05--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/settings/model_providers/raw_client.py@@ -0,0 +1,473 @@+# 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.parse_error import ParsingError+from ...core.request_options import RequestOptions+from ...core.serialization import convert_and_respect_annotation_metadata+from ...core.unchecked_base_model import construct_type+from ...errors.bad_request_error import BadRequestError+from ...errors.conflict_error import ConflictError+from ...errors.failed_dependency_error import FailedDependencyError+from ...errors.forbidden_error import ForbiddenError+from ...errors.unauthorized_error import UnauthorizedError+from ...types.get_model_provider_response import GetModelProviderResponse+from ...types.list_model_providers_response import ListModelProvidersResponse+from ...types.model_provider_manifest import ModelProviderManifest+from ...types.request_error_response import RequestErrorResponse+from pydantic import ValidationError++# this is used as the default value for optional parameters+OMIT = typing.cast(typing.Any, ...)+++class RawModelProvidersClient:+ def __init__(self, *, client_wrapper: SyncClientWrapper):+ self._client_wrapper = client_wrapper++ def list(+ self, *, request_options: typing.Optional[RequestOptions] = None+ ) -> HttpResponse[ListModelProvidersResponse]:+ """+ All configured providers with nested manifests.++ Parameters+ ----------+ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[ListModelProvidersResponse]+ All configured model providers+ """+ _response = self._client_wrapper.httpx_client.request(+ "api/v1/settings/model-providers",+ method="GET",+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ ListModelProvidersResponse,+ construct_type(+ type_=ListModelProvidersResponse, # type: ignore+ object_=_response.json(),+ ),+ )+ return HttpResponse(response=_response, data=_data)+ if _response.status_code == 401:+ raise UnauthorizedError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 403:+ raise ForbiddenError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ def create(+ self, *, manifest: ModelProviderManifest, request_options: typing.Optional[RequestOptions] = None+ ) -> HttpResponse[GetModelProviderResponse]:+ """+ Creates a provider (models included). Fails if `name` is already taken. Well-known types use `type` as `name` (one each); `custom` is named by the caller. `auth.api_key`: real value required; redacted with no stored secret returns 400.++ Parameters+ ----------+ manifest : ModelProviderManifest++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[GetModelProviderResponse]+ The created provider+ """+ _response = self._client_wrapper.httpx_client.request(+ "api/v1/settings/model-providers",+ method="POST",+ json={+ "manifest": convert_and_respect_annotation_metadata(+ object_=manifest, annotation=ModelProviderManifest, direction="write"+ ),+ },+ headers={+ "content-type": "application/json",+ },+ request_options=request_options,+ omit=OMIT,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ GetModelProviderResponse,+ construct_type(+ type_=GetModelProviderResponse, # 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(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 409:+ raise ConflictError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 424:+ raise FailedDependencyError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ def create_or_update(+ self, *, manifest: ModelProviderManifest, request_options: typing.Optional[RequestOptions] = None+ ) -> HttpResponse[GetModelProviderResponse]:+ """+ Create or replace a provider (models included). Well-known types use `type` as `name` (one each); `custom` is named by the caller. `auth.api_key`: real value sets/rotates; redacted keeps existing (400 if none).++ Parameters+ ----------+ manifest : ModelProviderManifest++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[GetModelProviderResponse]+ The saved provider+ """+ _response = self._client_wrapper.httpx_client.request(+ "api/v1/settings/model-providers",+ method="PUT",+ json={+ "manifest": convert_and_respect_annotation_metadata(+ object_=manifest, annotation=ModelProviderManifest, direction="write"+ ),+ },+ headers={+ "content-type": "application/json",+ },+ request_options=request_options,+ omit=OMIT,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ GetModelProviderResponse,+ construct_type(+ type_=GetModelProviderResponse, # 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(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 424:+ raise FailedDependencyError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)+++class AsyncRawModelProvidersClient:+ def __init__(self, *, client_wrapper: AsyncClientWrapper):+ self._client_wrapper = client_wrapper++ async def list(+ self, *, request_options: typing.Optional[RequestOptions] = None+ ) -> AsyncHttpResponse[ListModelProvidersResponse]:+ """+ All configured providers with nested manifests.++ Parameters+ ----------+ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ AsyncHttpResponse[ListModelProvidersResponse]+ All configured model providers+ """+ _response = await self._client_wrapper.httpx_client.request(+ "api/v1/settings/model-providers",+ method="GET",+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ ListModelProvidersResponse,+ construct_type(+ type_=ListModelProvidersResponse, # type: ignore+ object_=_response.json(),+ ),+ )+ return AsyncHttpResponse(response=_response, data=_data)+ if _response.status_code == 401:+ raise UnauthorizedError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 403:+ raise ForbiddenError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ async def create(+ self, *, manifest: ModelProviderManifest, request_options: typing.Optional[RequestOptions] = None+ ) -> AsyncHttpResponse[GetModelProviderResponse]:+ """+ Creates a provider (models included). Fails if `name` is already taken. Well-known types use `type` as `name` (one each); `custom` is named by the caller. `auth.api_key`: real value required; redacted with no stored secret returns 400.++ Parameters+ ----------+ manifest : ModelProviderManifest++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ AsyncHttpResponse[GetModelProviderResponse]+ The created provider+ """+ _response = await self._client_wrapper.httpx_client.request(+ "api/v1/settings/model-providers",+ method="POST",+ json={+ "manifest": convert_and_respect_annotation_metadata(+ object_=manifest, annotation=ModelProviderManifest, direction="write"+ ),+ },+ headers={+ "content-type": "application/json",+ },+ request_options=request_options,+ omit=OMIT,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ GetModelProviderResponse,+ construct_type(+ type_=GetModelProviderResponse, # 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(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 409:+ raise ConflictError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 424:+ raise FailedDependencyError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ async def create_or_update(+ self, *, manifest: ModelProviderManifest, request_options: typing.Optional[RequestOptions] = None+ ) -> AsyncHttpResponse[GetModelProviderResponse]:+ """+ Create or replace a provider (models included). Well-known types use `type` as `name` (one each); `custom` is named by the caller. `auth.api_key`: real value sets/rotates; redacted keeps existing (400 if none).++ Parameters+ ----------+ manifest : ModelProviderManifest++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ AsyncHttpResponse[GetModelProviderResponse]+ The saved provider+ """+ _response = await self._client_wrapper.httpx_client.request(+ "api/v1/settings/model-providers",+ method="PUT",+ json={+ "manifest": convert_and_respect_annotation_metadata(+ object_=manifest, annotation=ModelProviderManifest, direction="write"+ ),+ },+ headers={+ "content-type": "application/json",+ },+ request_options=request_options,+ omit=OMIT,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ GetModelProviderResponse,+ construct_type(+ type_=GetModelProviderResponse, # 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(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 424:+ raise FailedDependencyError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)diff --git a/python/trueforge_sdk/src/trueforge_sdk/settings/raw_client.py b/python/trueforge_sdk/src/trueforge_sdk/settings/raw_client.pynew file mode 100644index 000000000..d02cb822b--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/settings/raw_client.py@@ -0,0 +1,13 @@+# This file was auto-generated by Fern from our API Definition.++from ..core.client_wrapper import AsyncClientWrapper, SyncClientWrapper+++class RawSettingsClient:+ def __init__(self, *, client_wrapper: SyncClientWrapper):+ self._client_wrapper = client_wrapper+++class AsyncRawSettingsClient:+ def __init__(self, *, client_wrapper: AsyncClientWrapper):+ self._client_wrapper = client_wrapperdiff --git a/python/trueforge_sdk/src/trueforge_sdk/settings/sandbox_providers/__init__.py b/python/trueforge_sdk/src/trueforge_sdk/settings/sandbox_providers/__init__.pynew file mode 100644index 000000000..5cde0202d--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/settings/sandbox_providers/__init__.py@@ -0,0 +1,4 @@+# This file was auto-generated by Fern from our API Definition.++# isort: skip_file+diff --git a/python/trueforge_sdk/src/trueforge_sdk/settings/sandbox_providers/client.py b/python/trueforge_sdk/src/trueforge_sdk/settings/sandbox_providers/client.pynew file mode 100644index 000000000..cbf634239--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/settings/sandbox_providers/client.py@@ -0,0 +1,204 @@+# This file was auto-generated by Fern from our API Definition.++import typing++from ...core.client_wrapper import AsyncClientWrapper, SyncClientWrapper+from ...core.request_options import RequestOptions+from ...types.get_sandbox_provider_response import GetSandboxProviderResponse+from ...types.sandbox_provider_manifest import SandboxProviderManifest+from .raw_client import AsyncRawSandboxProvidersClient, RawSandboxProvidersClient++# this is used as the default value for optional parameters+OMIT = typing.cast(typing.Any, ...)+++class SandboxProvidersClient:+ def __init__(self, *, client_wrapper: SyncClientWrapper):+ self._raw_client = RawSandboxProvidersClient(client_wrapper=client_wrapper)++ @property+ def with_raw_response(self) -> RawSandboxProvidersClient:+ """+ Retrieves a raw implementation of this client that returns raw responses.++ Returns+ -------+ RawSandboxProvidersClient+ """+ return self._raw_client++ def get(self, *, request_options: typing.Optional[RequestOptions] = None) -> GetSandboxProviderResponse:+ """+ The single configured sandbox provider for this tenant. `auth.api_key` is redacted.++ Parameters+ ----------+ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ GetSandboxProviderResponse+ The configured sandbox provider.++ Examples+ --------+ from trueforge_sdk import TrueForge++ client = TrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+ client.settings.sandbox_providers.get()+ """+ _response = self._raw_client.get(request_options=request_options)+ return _response.data++ def create_or_update(+ self, *, manifest: SandboxProviderManifest, request_options: typing.Optional[RequestOptions] = None+ ) -> GetSandboxProviderResponse:+ """+ Upserts the single sandbox provider for this tenant: creates it or replaces its entire configuration. `auth.api_key`: real value sets/rotates; redacted keeps existing (400 if none).++ Parameters+ ----------+ manifest : SandboxProviderManifest++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ GetSandboxProviderResponse+ The saved sandbox provider.++ Examples+ --------+ from trueforge_sdk import (+ DaytonaSandboxProviderAuth,+ SandboxProviderManifest,+ TrueForge,+ )++ client = TrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+ client.settings.sandbox_providers.create_or_update(+ manifest=SandboxProviderManifest(+ auth=DaytonaSandboxProviderAuth(+ api_key="api_key",+ ),+ auto_archive_interval_in_minutes=1,+ auto_delete_interval_in_minutes=1,+ auto_stop_interval_in_minutes=1,+ exec_timeout_ms=1,+ ),+ )+ """+ _response = self._raw_client.create_or_update(manifest=manifest, request_options=request_options)+ return _response.data+++class AsyncSandboxProvidersClient:+ def __init__(self, *, client_wrapper: AsyncClientWrapper):+ self._raw_client = AsyncRawSandboxProvidersClient(client_wrapper=client_wrapper)++ @property+ def with_raw_response(self) -> AsyncRawSandboxProvidersClient:+ """+ Retrieves a raw implementation of this client that returns raw responses.++ Returns+ -------+ AsyncRawSandboxProvidersClient+ """+ return self._raw_client++ async def get(self, *, request_options: typing.Optional[RequestOptions] = None) -> GetSandboxProviderResponse:+ """+ The single configured sandbox provider for this tenant. `auth.api_key` is redacted.++ Parameters+ ----------+ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ GetSandboxProviderResponse+ The configured sandbox provider.++ Examples+ --------+ import asyncio++ from trueforge_sdk import AsyncTrueForge++ client = AsyncTrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+++ async def main() -> None:+ await client.settings.sandbox_providers.get()+++ asyncio.run(main())+ """+ _response = await self._raw_client.get(request_options=request_options)+ return _response.data++ async def create_or_update(+ self, *, manifest: SandboxProviderManifest, request_options: typing.Optional[RequestOptions] = None+ ) -> GetSandboxProviderResponse:+ """+ Upserts the single sandbox provider for this tenant: creates it or replaces its entire configuration. `auth.api_key`: real value sets/rotates; redacted keeps existing (400 if none).++ Parameters+ ----------+ manifest : SandboxProviderManifest++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ GetSandboxProviderResponse+ The saved sandbox provider.++ Examples+ --------+ import asyncio++ from trueforge_sdk import (+ AsyncTrueForge,+ DaytonaSandboxProviderAuth,+ SandboxProviderManifest,+ )++ client = AsyncTrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+++ async def main() -> None:+ await client.settings.sandbox_providers.create_or_update(+ manifest=SandboxProviderManifest(+ auth=DaytonaSandboxProviderAuth(+ api_key="api_key",+ ),+ auto_archive_interval_in_minutes=1,+ auto_delete_interval_in_minutes=1,+ auto_stop_interval_in_minutes=1,+ exec_timeout_ms=1,+ ),+ )+++ asyncio.run(main())+ """+ _response = await self._raw_client.create_or_update(manifest=manifest, request_options=request_options)+ return _response.datadiff --git a/python/trueforge_sdk/src/trueforge_sdk/settings/sandbox_providers/raw_client.py b/python/trueforge_sdk/src/trueforge_sdk/settings/sandbox_providers/raw_client.pynew file mode 100644index 000000000..022842fdc--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/settings/sandbox_providers/raw_client.py@@ -0,0 +1,280 @@+# 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.parse_error import ParsingError+from ...core.request_options import RequestOptions+from ...core.serialization import convert_and_respect_annotation_metadata+from ...core.unchecked_base_model import construct_type+from ...errors.bad_request_error import BadRequestError+from ...errors.not_found_error import NotFoundError+from ...errors.unprocessable_entity_error import UnprocessableEntityError+from ...types.get_sandbox_provider_response import GetSandboxProviderResponse+from ...types.request_error_response import RequestErrorResponse+from ...types.sandbox_provider_manifest import SandboxProviderManifest+from pydantic import ValidationError++# this is used as the default value for optional parameters+OMIT = typing.cast(typing.Any, ...)+++class RawSandboxProvidersClient:+ def __init__(self, *, client_wrapper: SyncClientWrapper):+ self._client_wrapper = client_wrapper++ def get(+ self, *, request_options: typing.Optional[RequestOptions] = None+ ) -> HttpResponse[GetSandboxProviderResponse]:+ """+ The single configured sandbox provider for this tenant. `auth.api_key` is redacted.++ Parameters+ ----------+ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[GetSandboxProviderResponse]+ The configured sandbox provider.+ """+ _response = self._client_wrapper.httpx_client.request(+ "api/v1/settings/sandbox-providers",+ method="GET",+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ GetSandboxProviderResponse,+ construct_type(+ type_=GetSandboxProviderResponse, # type: ignore+ object_=_response.json(),+ ),+ )+ return HttpResponse(response=_response, data=_data)+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ def create_or_update(+ self, *, manifest: SandboxProviderManifest, request_options: typing.Optional[RequestOptions] = None+ ) -> HttpResponse[GetSandboxProviderResponse]:+ """+ Upserts the single sandbox provider for this tenant: creates it or replaces its entire configuration. `auth.api_key`: real value sets/rotates; redacted keeps existing (400 if none).++ Parameters+ ----------+ manifest : SandboxProviderManifest++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[GetSandboxProviderResponse]+ The saved sandbox provider.+ """+ _response = self._client_wrapper.httpx_client.request(+ "api/v1/settings/sandbox-providers",+ method="PUT",+ json={+ "manifest": convert_and_respect_annotation_metadata(+ object_=manifest, annotation=SandboxProviderManifest, direction="write"+ ),+ },+ headers={+ "content-type": "application/json",+ },+ request_options=request_options,+ omit=OMIT,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ GetSandboxProviderResponse,+ construct_type(+ type_=GetSandboxProviderResponse, # 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(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 422:+ raise UnprocessableEntityError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)+++class AsyncRawSandboxProvidersClient:+ def __init__(self, *, client_wrapper: AsyncClientWrapper):+ self._client_wrapper = client_wrapper++ async def get(+ self, *, request_options: typing.Optional[RequestOptions] = None+ ) -> AsyncHttpResponse[GetSandboxProviderResponse]:+ """+ The single configured sandbox provider for this tenant. `auth.api_key` is redacted.++ Parameters+ ----------+ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ AsyncHttpResponse[GetSandboxProviderResponse]+ The configured sandbox provider.+ """+ _response = await self._client_wrapper.httpx_client.request(+ "api/v1/settings/sandbox-providers",+ method="GET",+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ GetSandboxProviderResponse,+ construct_type(+ type_=GetSandboxProviderResponse, # type: ignore+ object_=_response.json(),+ ),+ )+ return AsyncHttpResponse(response=_response, data=_data)+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ async def create_or_update(+ self, *, manifest: SandboxProviderManifest, request_options: typing.Optional[RequestOptions] = None+ ) -> AsyncHttpResponse[GetSandboxProviderResponse]:+ """+ Upserts the single sandbox provider for this tenant: creates it or replaces its entire configuration. `auth.api_key`: real value sets/rotates; redacted keeps existing (400 if none).++ Parameters+ ----------+ manifest : SandboxProviderManifest++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ AsyncHttpResponse[GetSandboxProviderResponse]+ The saved sandbox provider.+ """+ _response = await self._client_wrapper.httpx_client.request(+ "api/v1/settings/sandbox-providers",+ method="PUT",+ json={+ "manifest": convert_and_respect_annotation_metadata(+ object_=manifest, annotation=SandboxProviderManifest, direction="write"+ ),+ },+ headers={+ "content-type": "application/json",+ },+ request_options=request_options,+ omit=OMIT,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ GetSandboxProviderResponse,+ construct_type(+ type_=GetSandboxProviderResponse, # 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(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 422:+ raise UnprocessableEntityError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)diff --git a/python/trueforge_sdk/src/trueforge_sdk/settings/skills/__init__.py b/python/trueforge_sdk/src/trueforge_sdk/settings/skills/__init__.pynew file mode 100644index 000000000..5cde0202d--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/settings/skills/__init__.py@@ -0,0 +1,4 @@+# This file was auto-generated by Fern from our API Definition.++# isort: skip_file+diff --git a/python/trueforge_sdk/src/trueforge_sdk/settings/skills/client.py b/python/trueforge_sdk/src/trueforge_sdk/settings/skills/client.pynew file mode 100644index 000000000..c5a7a19c8--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/settings/skills/client.py@@ -0,0 +1,275 @@+# This file was auto-generated by Fern from our API Definition.++import typing++from ...core.client_wrapper import AsyncClientWrapper, SyncClientWrapper+from ...core.request_options import RequestOptions+from ...types.get_skill_response import GetSkillResponse+from ...types.list_skills_response import ListSkillsResponse+from ...types.skill_manifest import SkillManifest+from .raw_client import AsyncRawSkillsClient, RawSkillsClient++# this is used as the default value for optional parameters+OMIT = typing.cast(typing.Any, ...)+++class SkillsClient:+ def __init__(self, *, client_wrapper: SyncClientWrapper):+ self._raw_client = RawSkillsClient(client_wrapper=client_wrapper)++ @property+ def with_raw_response(self) -> RawSkillsClient:+ """+ Retrieves a raw implementation of this client that returns raw responses.++ Returns+ -------+ RawSkillsClient+ """+ return self._raw_client++ def list(self, *, request_options: typing.Optional[RequestOptions] = None) -> ListSkillsResponse:+ """+ All configured skills with nested manifests (settings / admin projection).++ Parameters+ ----------+ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ ListSkillsResponse+ All configured skills.++ Examples+ --------+ from trueforge_sdk import TrueForge++ client = TrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+ client.settings.skills.list()+ """+ _response = self._raw_client.list(request_options=request_options)+ return _response.data++ def create(+ self, *, manifest: SkillManifest, request_options: typing.Optional[RequestOptions] = None+ ) -> GetSkillResponse:+ """+ Creates a skill keyed by `name`. Fails if `name` is already taken.++ Parameters+ ----------+ manifest : SkillManifest++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ GetSkillResponse+ The created skill.++ Examples+ --------+ from trueforge_sdk import GitSkill, TrueForge++ client = TrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+ client.settings.skills.create(+ manifest=GitSkill(+ description="description",+ name="name",+ ref="ref",+ url="url",+ ),+ )+ """+ _response = self._raw_client.create(manifest=manifest, request_options=request_options)+ return _response.data++ def create_or_update(+ self, *, manifest: SkillManifest, request_options: typing.Optional[RequestOptions] = None+ ) -> GetSkillResponse:+ """+ Full upsert keyed by `name`: creates the skill or replaces its entire manifest.++ Parameters+ ----------+ manifest : SkillManifest++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ GetSkillResponse+ The saved skill.++ Examples+ --------+ from trueforge_sdk import GitSkill, TrueForge++ client = TrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+ client.settings.skills.create_or_update(+ manifest=GitSkill(+ description="description",+ name="name",+ ref="ref",+ url="url",+ ),+ )+ """+ _response = self._raw_client.create_or_update(manifest=manifest, request_options=request_options)+ return _response.data+++class AsyncSkillsClient:+ def __init__(self, *, client_wrapper: AsyncClientWrapper):+ self._raw_client = AsyncRawSkillsClient(client_wrapper=client_wrapper)++ @property+ def with_raw_response(self) -> AsyncRawSkillsClient:+ """+ Retrieves a raw implementation of this client that returns raw responses.++ Returns+ -------+ AsyncRawSkillsClient+ """+ return self._raw_client++ async def list(self, *, request_options: typing.Optional[RequestOptions] = None) -> ListSkillsResponse:+ """+ All configured skills with nested manifests (settings / admin projection).++ Parameters+ ----------+ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ ListSkillsResponse+ All configured skills.++ Examples+ --------+ import asyncio++ from trueforge_sdk import AsyncTrueForge++ client = AsyncTrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+++ async def main() -> None:+ await client.settings.skills.list()+++ asyncio.run(main())+ """+ _response = await self._raw_client.list(request_options=request_options)+ return _response.data++ async def create(+ self, *, manifest: SkillManifest, request_options: typing.Optional[RequestOptions] = None+ ) -> GetSkillResponse:+ """+ Creates a skill keyed by `name`. Fails if `name` is already taken.++ Parameters+ ----------+ manifest : SkillManifest++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ GetSkillResponse+ The created skill.++ Examples+ --------+ import asyncio++ from trueforge_sdk import AsyncTrueForge, GitSkill++ client = AsyncTrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+++ async def main() -> None:+ await client.settings.skills.create(+ manifest=GitSkill(+ description="description",+ name="name",+ ref="ref",+ url="url",+ ),+ )+++ asyncio.run(main())+ """+ _response = await self._raw_client.create(manifest=manifest, request_options=request_options)+ return _response.data++ async def create_or_update(+ self, *, manifest: SkillManifest, request_options: typing.Optional[RequestOptions] = None+ ) -> GetSkillResponse:+ """+ Full upsert keyed by `name`: creates the skill or replaces its entire manifest.++ Parameters+ ----------+ manifest : SkillManifest++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ GetSkillResponse+ The saved skill.++ Examples+ --------+ import asyncio++ from trueforge_sdk import AsyncTrueForge, GitSkill++ client = AsyncTrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+++ async def main() -> None:+ await client.settings.skills.create_or_update(+ manifest=GitSkill(+ description="description",+ name="name",+ ref="ref",+ url="url",+ ),+ )+++ asyncio.run(main())+ """+ _response = await self._raw_client.create_or_update(manifest=manifest, request_options=request_options)+ return _response.datadiff --git a/python/trueforge_sdk/src/trueforge_sdk/settings/skills/raw_client.py b/python/trueforge_sdk/src/trueforge_sdk/settings/skills/raw_client.pynew file mode 100644index 000000000..beac8859c--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/settings/skills/raw_client.py@@ -0,0 +1,471 @@+# 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.parse_error import ParsingError+from ...core.request_options import RequestOptions+from ...core.serialization import convert_and_respect_annotation_metadata+from ...core.unchecked_base_model import construct_type+from ...errors.bad_request_error import BadRequestError+from ...errors.conflict_error import ConflictError+from ...errors.failed_dependency_error import FailedDependencyError+from ...errors.forbidden_error import ForbiddenError+from ...errors.unauthorized_error import UnauthorizedError+from ...types.get_skill_response import GetSkillResponse+from ...types.list_skills_response import ListSkillsResponse+from ...types.request_error_response import RequestErrorResponse+from ...types.skill_manifest import SkillManifest+from pydantic import ValidationError++# this is used as the default value for optional parameters+OMIT = typing.cast(typing.Any, ...)+++class RawSkillsClient:+ def __init__(self, *, client_wrapper: SyncClientWrapper):+ self._client_wrapper = client_wrapper++ def list(self, *, request_options: typing.Optional[RequestOptions] = None) -> HttpResponse[ListSkillsResponse]:+ """+ All configured skills with nested manifests (settings / admin projection).++ Parameters+ ----------+ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[ListSkillsResponse]+ All configured skills.+ """+ _response = self._client_wrapper.httpx_client.request(+ "api/v1/settings/skills",+ method="GET",+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ ListSkillsResponse,+ construct_type(+ type_=ListSkillsResponse, # type: ignore+ object_=_response.json(),+ ),+ )+ return HttpResponse(response=_response, data=_data)+ if _response.status_code == 401:+ raise UnauthorizedError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 403:+ raise ForbiddenError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ def create(+ self, *, manifest: SkillManifest, request_options: typing.Optional[RequestOptions] = None+ ) -> HttpResponse[GetSkillResponse]:+ """+ Creates a skill keyed by `name`. Fails if `name` is already taken.++ Parameters+ ----------+ manifest : SkillManifest++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[GetSkillResponse]+ The created skill.+ """+ _response = self._client_wrapper.httpx_client.request(+ "api/v1/settings/skills",+ method="POST",+ json={+ "manifest": convert_and_respect_annotation_metadata(+ object_=manifest, annotation=SkillManifest, direction="write"+ ),+ },+ headers={+ "content-type": "application/json",+ },+ request_options=request_options,+ omit=OMIT,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ GetSkillResponse,+ construct_type(+ type_=GetSkillResponse, # 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(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 409:+ raise ConflictError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 424:+ raise FailedDependencyError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ def create_or_update(+ self, *, manifest: SkillManifest, request_options: typing.Optional[RequestOptions] = None+ ) -> HttpResponse[GetSkillResponse]:+ """+ Full upsert keyed by `name`: creates the skill or replaces its entire manifest.++ Parameters+ ----------+ manifest : SkillManifest++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[GetSkillResponse]+ The saved skill.+ """+ _response = self._client_wrapper.httpx_client.request(+ "api/v1/settings/skills",+ method="PUT",+ json={+ "manifest": convert_and_respect_annotation_metadata(+ object_=manifest, annotation=SkillManifest, direction="write"+ ),+ },+ headers={+ "content-type": "application/json",+ },+ request_options=request_options,+ omit=OMIT,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ GetSkillResponse,+ construct_type(+ type_=GetSkillResponse, # 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(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 424:+ raise FailedDependencyError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)+++class AsyncRawSkillsClient:+ def __init__(self, *, client_wrapper: AsyncClientWrapper):+ self._client_wrapper = client_wrapper++ async def list(+ self, *, request_options: typing.Optional[RequestOptions] = None+ ) -> AsyncHttpResponse[ListSkillsResponse]:+ """+ All configured skills with nested manifests (settings / admin projection).++ Parameters+ ----------+ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ AsyncHttpResponse[ListSkillsResponse]+ All configured skills.+ """+ _response = await self._client_wrapper.httpx_client.request(+ "api/v1/settings/skills",+ method="GET",+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ ListSkillsResponse,+ construct_type(+ type_=ListSkillsResponse, # type: ignore+ object_=_response.json(),+ ),+ )+ return AsyncHttpResponse(response=_response, data=_data)+ if _response.status_code == 401:+ raise UnauthorizedError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 403:+ raise ForbiddenError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ async def create(+ self, *, manifest: SkillManifest, request_options: typing.Optional[RequestOptions] = None+ ) -> AsyncHttpResponse[GetSkillResponse]:+ """+ Creates a skill keyed by `name`. Fails if `name` is already taken.++ Parameters+ ----------+ manifest : SkillManifest++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ AsyncHttpResponse[GetSkillResponse]+ The created skill.+ """+ _response = await self._client_wrapper.httpx_client.request(+ "api/v1/settings/skills",+ method="POST",+ json={+ "manifest": convert_and_respect_annotation_metadata(+ object_=manifest, annotation=SkillManifest, direction="write"+ ),+ },+ headers={+ "content-type": "application/json",+ },+ request_options=request_options,+ omit=OMIT,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ GetSkillResponse,+ construct_type(+ type_=GetSkillResponse, # 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(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 409:+ raise ConflictError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 424:+ raise FailedDependencyError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ async def create_or_update(+ self, *, manifest: SkillManifest, request_options: typing.Optional[RequestOptions] = None+ ) -> AsyncHttpResponse[GetSkillResponse]:+ """+ Full upsert keyed by `name`: creates the skill or replaces its entire manifest.++ Parameters+ ----------+ manifest : SkillManifest++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ AsyncHttpResponse[GetSkillResponse]+ The saved skill.+ """+ _response = await self._client_wrapper.httpx_client.request(+ "api/v1/settings/skills",+ method="PUT",+ json={+ "manifest": convert_and_respect_annotation_metadata(+ object_=manifest, annotation=SkillManifest, direction="write"+ ),+ },+ headers={+ "content-type": "application/json",+ },+ request_options=request_options,+ omit=OMIT,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ GetSkillResponse,+ construct_type(+ type_=GetSkillResponse, # 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(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 424:+ raise FailedDependencyError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)diff --git a/python/trueforge_sdk/src/trueforge_sdk/skills/__init__.py b/python/trueforge_sdk/src/trueforge_sdk/skills/__init__.pynew file mode 100644index 000000000..5cde0202d--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/skills/__init__.py@@ -0,0 +1,4 @@+# This file was auto-generated by Fern from our API Definition.++# isort: skip_file+diff --git a/python/trueforge_sdk/src/trueforge_sdk/skills/client.py b/python/trueforge_sdk/src/trueforge_sdk/skills/client.pynew file mode 100644index 000000000..e98889a7f--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/skills/client.py@@ -0,0 +1,179 @@+# This file was auto-generated by Fern from our API Definition.++import typing++from ..core.client_wrapper import AsyncClientWrapper, SyncClientWrapper+from ..core.request_options import RequestOptions+from ..types.list_available_skills_response import ListAvailableSkillsResponse+from ..types.list_skill_versions_response import ListSkillVersionsResponse+from .raw_client import AsyncRawSkillsClient, RawSkillsClient+++class SkillsClient:+ def __init__(self, *, client_wrapper: SyncClientWrapper):+ self._raw_client = RawSkillsClient(client_wrapper=client_wrapper)++ @property+ def with_raw_response(self) -> RawSkillsClient:+ """+ Retrieves a raw implementation of this client that returns raw responses.++ Returns+ -------+ RawSkillsClient+ """+ return self._raw_client++ def list(self, *, request_options: typing.Optional[RequestOptions] = None) -> ListAvailableSkillsResponse:+ """+ Configured skills as a slim name/description list for the composer.++ Parameters+ ----------+ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ ListAvailableSkillsResponse+ All configured skills (chat projection).++ Examples+ --------+ from trueforge_sdk import TrueForge++ client = TrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+ client.skills.list()+ """+ _response = self._raw_client.list(request_options=request_options)+ return _response.data++ def list_versions(+ self, *, name: str, request_options: typing.Optional[RequestOptions] = None+ ) -> ListSkillVersionsResponse:+ """+ Versions for one skill.++ Parameters+ ----------+ name : str+ Skill name.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ ListSkillVersionsResponse+ Skill versions.++ Examples+ --------+ from trueforge_sdk import TrueForge++ client = TrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+ client.skills.list_versions(+ name="name",+ )+ """+ _response = self._raw_client.list_versions(name=name, request_options=request_options)+ return _response.data+++class AsyncSkillsClient:+ def __init__(self, *, client_wrapper: AsyncClientWrapper):+ self._raw_client = AsyncRawSkillsClient(client_wrapper=client_wrapper)++ @property+ def with_raw_response(self) -> AsyncRawSkillsClient:+ """+ Retrieves a raw implementation of this client that returns raw responses.++ Returns+ -------+ AsyncRawSkillsClient+ """+ return self._raw_client++ async def list(self, *, request_options: typing.Optional[RequestOptions] = None) -> ListAvailableSkillsResponse:+ """+ Configured skills as a slim name/description list for the composer.++ Parameters+ ----------+ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ ListAvailableSkillsResponse+ All configured skills (chat projection).++ Examples+ --------+ import asyncio++ from trueforge_sdk import AsyncTrueForge++ client = AsyncTrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+++ async def main() -> None:+ await client.skills.list()+++ asyncio.run(main())+ """+ _response = await self._raw_client.list(request_options=request_options)+ return _response.data++ async def list_versions(+ self, *, name: str, request_options: typing.Optional[RequestOptions] = None+ ) -> ListSkillVersionsResponse:+ """+ Versions for one skill.++ Parameters+ ----------+ name : str+ Skill name.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ ListSkillVersionsResponse+ Skill versions.++ Examples+ --------+ import asyncio++ from trueforge_sdk import AsyncTrueForge++ client = AsyncTrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+++ async def main() -> None:+ await client.skills.list_versions(+ name="name",+ )+++ asyncio.run(main())+ """+ _response = await self._raw_client.list_versions(name=name, request_options=request_options)+ return _response.datadiff --git a/python/trueforge_sdk/src/trueforge_sdk/skills/raw_client.py b/python/trueforge_sdk/src/trueforge_sdk/skills/raw_client.pynew file mode 100644index 000000000..f15c75bfc--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/skills/raw_client.py@@ -0,0 +1,242 @@+# 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.parse_error import ParsingError+from ..core.request_options import RequestOptions+from ..core.unchecked_base_model import construct_type+from ..errors.unauthorized_error import UnauthorizedError+from ..types.list_available_skills_response import ListAvailableSkillsResponse+from ..types.list_skill_versions_response import ListSkillVersionsResponse+from ..types.request_error_response import RequestErrorResponse+from pydantic import ValidationError+++class RawSkillsClient:+ def __init__(self, *, client_wrapper: SyncClientWrapper):+ self._client_wrapper = client_wrapper++ def list(+ self, *, request_options: typing.Optional[RequestOptions] = None+ ) -> HttpResponse[ListAvailableSkillsResponse]:+ """+ Configured skills as a slim name/description list for the composer.++ Parameters+ ----------+ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[ListAvailableSkillsResponse]+ All configured skills (chat projection).+ """+ _response = self._client_wrapper.httpx_client.request(+ "api/v1/skills",+ method="GET",+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ ListAvailableSkillsResponse,+ construct_type(+ type_=ListAvailableSkillsResponse, # type: ignore+ object_=_response.json(),+ ),+ )+ return HttpResponse(response=_response, data=_data)+ if _response.status_code == 401:+ raise UnauthorizedError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ def list_versions(+ self, *, name: str, request_options: typing.Optional[RequestOptions] = None+ ) -> HttpResponse[ListSkillVersionsResponse]:+ """+ Versions for one skill.++ Parameters+ ----------+ name : str+ Skill name.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[ListSkillVersionsResponse]+ Skill versions.+ """+ _response = self._client_wrapper.httpx_client.request(+ "api/v1/skills/versions",+ method="GET",+ params={+ "name": name,+ },+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ ListSkillVersionsResponse,+ construct_type(+ type_=ListSkillVersionsResponse, # type: ignore+ object_=_response.json(),+ ),+ )+ return HttpResponse(response=_response, data=_data)+ if _response.status_code == 401:+ raise UnauthorizedError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)+++class AsyncRawSkillsClient:+ def __init__(self, *, client_wrapper: AsyncClientWrapper):+ self._client_wrapper = client_wrapper++ async def list(+ self, *, request_options: typing.Optional[RequestOptions] = None+ ) -> AsyncHttpResponse[ListAvailableSkillsResponse]:+ """+ Configured skills as a slim name/description list for the composer.++ Parameters+ ----------+ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ AsyncHttpResponse[ListAvailableSkillsResponse]+ All configured skills (chat projection).+ """+ _response = await self._client_wrapper.httpx_client.request(+ "api/v1/skills",+ method="GET",+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ ListAvailableSkillsResponse,+ construct_type(+ type_=ListAvailableSkillsResponse, # type: ignore+ object_=_response.json(),+ ),+ )+ return AsyncHttpResponse(response=_response, data=_data)+ if _response.status_code == 401:+ raise UnauthorizedError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)++ async def list_versions(+ self, *, name: str, request_options: typing.Optional[RequestOptions] = None+ ) -> AsyncHttpResponse[ListSkillVersionsResponse]:+ """+ Versions for one skill.++ Parameters+ ----------+ name : str+ Skill name.++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ AsyncHttpResponse[ListSkillVersionsResponse]+ Skill versions.+ """+ _response = await self._client_wrapper.httpx_client.request(+ "api/v1/skills/versions",+ method="GET",+ params={+ "name": name,+ },+ request_options=request_options,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ ListSkillVersionsResponse,+ construct_type(+ type_=ListSkillVersionsResponse, # type: ignore+ object_=_response.json(),+ ),+ )+ return AsyncHttpResponse(response=_response, data=_data)+ if _response.status_code == 401:+ raise UnauthorizedError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # 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)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)diff --git a/python/trueforge_sdk/src/trueforge_sdk/types/__init__.py b/python/trueforge_sdk/src/trueforge_sdk/types/__init__.pynew file mode 100644index 000000000..a77f06cbc--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/__init__.py@@ -0,0 +1,722 @@+# This file was auto-generated by Fern from our API Definition.++# isort: skip_file++import typing+from importlib import import_module++if typing.TYPE_CHECKING:+ from .action_required_event import ActionRequiredEvent+ from .agent import Agent+ from .agent_code_snippet import AgentCodeSnippet+ from .agent_code_snippet_sample_code import AgentCodeSnippetSampleCode+ from .agent_code_snippets import AgentCodeSnippets+ from .agent_info import AgentInfo+ from .agent_parent import AgentParent+ from .agent_spec import AgentSpec+ from .alibaba_model_provider import AlibabaModelProvider+ from .anthropic_model_provider import AnthropicModelProvider+ from .approval_allow import ApprovalAllow+ from .approval_decision import ApprovalDecision+ from .approval_deny import ApprovalDeny+ from .ask_user_questions_config import AskUserQuestionsConfig+ from .available_mcp_server import AvailableMcpServer+ from .available_model import AvailableModel+ from .available_model_provider import AvailableModelProvider+ from .available_skill import AvailableSkill+ from .base_mcp_auth_required_event import BaseMcpAuthRequiredEvent+ from .base_thread_done_event import BaseThreadDoneEvent+ from .cancel_session_response import CancelSessionResponse+ from .capabilities_data import CapabilitiesData+ from .catalog_custom_model_provider import CatalogCustomModelProvider+ from .catalog_mcp_server import CatalogMcpServer+ from .catalog_mcp_server_type import CatalogMcpServerType+ from .catalog_model import CatalogModel+ from .catalog_model_provider import CatalogModelProvider+ from .catalog_sandbox_provider import CatalogSandboxProvider+ from .catalog_skill import CatalogSkill+ from .catalog_skill_type import CatalogSkillType+ from .catalog_well_known_model_provider import CatalogWellKnownModelProvider+ from .catalog_well_known_model_provider_type import CatalogWellKnownModelProviderType+ from .chat_completion_chunk_delta_tool_call import ChatCompletionChunkDeltaToolCall+ from .chat_completion_chunk_delta_tool_call_function import ChatCompletionChunkDeltaToolCallFunction+ from .chat_completion_content_part_refusal import ChatCompletionContentPartRefusal+ from .chat_completion_content_part_text import ChatCompletionContentPartText+ from .chat_completion_message_tool_call import ChatCompletionMessageToolCall+ from .chat_completion_message_tool_call_function import ChatCompletionMessageToolCallFunction+ from .compaction_config import CompactionConfig+ from .configured_mcp_server import ConfiguredMcpServer+ from .configured_model import ConfiguredModel+ from .configured_model_provider import ConfiguredModelProvider+ from .configured_sandbox_provider import ConfiguredSandboxProvider+ from .configured_skill import ConfiguredSkill+ from .context_management_config import ContextManagementConfig+ from .create_schedule_run_response import CreateScheduleRunResponse+ from .create_session_agent import CreateSessionAgent+ from .created_by_subject import CreatedBySubject+ from .cron_expression import CronExpression+ from .custom_model_provider import CustomModelProvider+ from .daytona_sandbox_provider_auth import DaytonaSandboxProviderAuth+ from .delete_agent_response import DeleteAgentResponse+ from .delete_schedule_response import DeleteScheduleResponse+ from .dynamic_sub_agents_config import DynamicSubAgentsConfig+ from .extended_chunk_delta_tool_call import ExtendedChunkDeltaToolCall+ from .file_content import FileContent+ from .finish_reason import FinishReason+ from .fireworks_model_provider import FireworksModelProvider+ from .generative_ui_config import GenerativeUiConfig+ from .get_agent_code_snippets_response import GetAgentCodeSnippetsResponse+ from .get_agent_response import GetAgentResponse+ from .get_available_mcp_server_response import GetAvailableMcpServerResponse+ from .get_capabilities_response import GetCapabilitiesResponse+ from .get_mcp_server_catalog_response import GetMcpServerCatalogResponse+ from .get_mcp_server_response import GetMcpServerResponse+ from .get_me_response import GetMeResponse+ from .get_me_subject import GetMeSubject+ from .get_model_provider_catalog_response import GetModelProviderCatalogResponse+ from .get_model_provider_response import GetModelProviderResponse+ from .get_sandbox_provider_catalog_response import GetSandboxProviderCatalogResponse+ from .get_sandbox_provider_response import GetSandboxProviderResponse+ from .get_schedule_response import GetScheduleResponse+ from .get_session_metrics_chart_data_response import GetSessionMetricsChartDataResponse+ from .get_session_metrics_chart_response import GetSessionMetricsChartResponse+ from .get_session_metrics_meter_response import GetSessionMetricsMeterResponse+ from .get_session_response import GetSessionResponse+ from .get_skill_catalog_response import GetSkillCatalogResponse+ from .get_skill_response import GetSkillResponse+ from .get_turn_response import GetTurnResponse+ from .git_skill import GitSkill+ from .google_gemini_model_provider import GoogleGeminiModelProvider+ from .initial_user_message import InitialUserMessage+ from .input_tokens_compaction_trigger import InputTokensCompactionTrigger+ from .large_tool_response_config import LargeToolResponseConfig+ from .list_agents_response import ListAgentsResponse+ from .list_available_mcp_servers_response import ListAvailableMcpServersResponse+ from .list_available_models_response import ListAvailableModelsResponse+ from .list_available_skills_response import ListAvailableSkillsResponse+ from .list_mcp_server_tools_response import ListMcpServerToolsResponse+ from .list_mcp_servers_response import ListMcpServersResponse+ from .list_model_providers_response import ListModelProvidersResponse+ from .list_permissions_response import ListPermissionsResponse+ from .list_schedule_runs_response import ListScheduleRunsResponse+ from .list_schedules_response import ListSchedulesResponse+ from .list_session_events_response import ListSessionEventsResponse+ from .list_sessions_order import ListSessionsOrder+ from .list_sessions_response import ListSessionsResponse+ from .list_skill_versions_response import ListSkillVersionsResponse+ from .list_skills_response import ListSkillsResponse+ from .list_turn_events_order import ListTurnEventsOrder+ from .list_turn_events_response import ListTurnEventsResponse+ from .list_turns_response import ListTurnsResponse+ from .mcp_auth_required_event import McpAuthRequiredEvent+ from .mcp_auth_status import McpAuthStatus+ from .mcp_auth_status_status import McpAuthStatusStatus+ from .mcp_initialize_event import McpInitializeEvent+ from .mcp_server import McpServer+ from .mcp_server_approval_tool_selector import McpServerApprovalToolSelector+ from .mcp_server_auth_info import McpServerAuthInfo+ from .mcp_server_auth_public import McpServerAuthPublic+ from .mcp_server_auth_public_one import McpServerAuthPublicOne+ from .mcp_server_auth_public_zero import McpServerAuthPublicZero+ from .mcp_server_dcr_auth import McpServerDcrAuth+ from .mcp_server_header_auth import McpServerHeaderAuth+ from .mcp_server_init_info import McpServerInitInfo+ from .mcp_server_init_info_transport_type import McpServerInitInfoTransportType+ from .mcp_server_manifest import McpServerManifest+ from .mcp_server_manifest_auth import McpServerManifestAuth+ from .mcp_server_tool_selector import McpServerToolSelector+ from .mcp_tool_info import McpToolInfo+ from .me import Me+ from .me_session_type import MeSessionType+ from .metrics_unit import MetricsUnit+ from .model import Model+ from .model_message_delta_event import ModelMessageDeltaEvent+ from .model_message_event import ModelMessageEvent+ from .model_message_event_content import ModelMessageEventContent+ from .model_message_event_content_one_item import ModelMessageEventContentOneItem+ from .model_message_usage import ModelMessageUsage+ from .model_message_usage_input_tokens_breakdown import ModelMessageUsageInputTokensBreakdown+ from .model_params import ModelParams+ from .model_properties import ModelProperties+ from .model_provider_auth import ModelProviderAuth+ from .model_provider_manifest import ModelProviderManifest+ from .moonshot_model_provider import MoonshotModelProvider+ from .open_ai_model_provider import OpenAiModelProvider+ from .permission_resource_type import PermissionResourceType+ from .previous_turn_id_input import PreviousTurnIdInput+ from .raw_tool_call import RawToolCall+ from .reasoning_effort import ReasoningEffort+ from .remote_mcp_server_manifest import RemoteMcpServerManifest+ from .request_error_response import RequestErrorResponse+ from .request_error_response_error import RequestErrorResponseError+ from .resource_name import ResourceName+ from .resource_permission import ResourcePermission+ from .response_format import ResponseFormat+ from .response_format_json_object import ResponseFormatJsonObject+ from .response_format_json_schema import ResponseFormatJsonSchema+ from .response_format_json_schema_json_schema import ResponseFormatJsonSchemaJsonSchema+ from .response_format_text import ResponseFormatText+ from .runtime_config import RuntimeConfig+ from .sandbox_build_status import SandboxBuildStatus+ from .sandbox_capability import SandboxCapability+ from .sandbox_config import SandboxConfig+ from .sandbox_created_event import SandboxCreatedEvent+ from .sandbox_provider_manifest import SandboxProviderManifest+ from .schedule import Schedule+ from .schedule_manifest import ScheduleManifest+ from .schedule_run import ScheduleRun+ from .schedule_run_status import ScheduleRunStatus+ from .schedule_status import ScheduleStatus+ from .session import Session+ from .session_agent import SessionAgent+ from .session_agent_inline import SessionAgentInline+ from .session_agent_name_ref import SessionAgentNameRef+ from .session_agent_reference import SessionAgentReference+ from .session_agent_spec_body import SessionAgentSpecBody+ from .session_event import SessionEvent+ from .session_event_item import SessionEventItem+ from .session_metadata import SessionMetadata+ from .session_metrics import SessionMetrics+ from .session_metrics_chart import SessionMetricsChart+ from .session_metrics_chart_data_response import SessionMetricsChartDataResponse+ from .session_metrics_chart_name import SessionMetricsChartName+ from .session_metrics_chart_response import SessionMetricsChartResponse+ from .session_metrics_graph import SessionMetricsGraph+ from .session_metrics_graph_line import SessionMetricsGraphLine+ from .session_metrics_meter import SessionMetricsMeter+ from .session_metrics_meter_name import SessionMetricsMeterName+ from .session_metrics_meter_response import SessionMetricsMeterResponse+ from .session_metrics_point import SessionMetricsPoint+ from .session_source import SessionSource+ from .session_source_schedule import SessionSourceSchedule+ from .session_source_type import SessionSourceType+ from .settings_capability import SettingsCapability+ from .skill import Skill+ from .skill_capability import SkillCapability+ from .skill_manifest import SkillManifest+ from .skill_version import SkillVersion+ from .text_content import TextContent+ from .thread_created_event import ThreadCreatedEvent+ from .thread_done_event import ThreadDoneEvent+ from .thread_state import ThreadState+ from .thread_state_done import ThreadStateDone+ from .thread_state_error import ThreadStateError+ from .timezone import Timezone+ from .together_ai_model_provider import TogetherAiModelProvider+ from .token_pagination import TokenPagination+ from .tool_approval_required_event import ToolApprovalRequiredEvent+ from .tool_call import ToolCall+ from .tool_call_ref import ToolCallRef+ from .tool_info import ToolInfo+ from .tool_response_event import ToolResponseEvent+ from .tool_response_required_event import ToolResponseRequiredEvent+ from .true_foundry_mcp_server_manifest import TrueFoundryMcpServerManifest+ from .true_foundry_model_provider import TrueFoundryModelProvider+ from .true_foundry_registry_skill import TrueFoundryRegistrySkill+ from .true_foundry_system_tool_info import TrueFoundrySystemToolInfo+ from .turn import Turn+ from .turn_created_event import TurnCreatedEvent+ from .turn_done_event import TurnDoneEvent+ from .turn_done_event_state import TurnDoneEventState+ from .turn_input_item import TurnInputItem+ from .turn_metrics import TurnMetrics+ from .turn_state import TurnState+ from .turn_state_cancelled import TurnStateCancelled+ from .turn_state_cancelled_metrics import TurnStateCancelledMetrics+ from .turn_state_cancelled_reason import TurnStateCancelledReason+ from .turn_state_done import TurnStateDone+ from .turn_state_error import TurnStateError+ from .turn_state_error_metrics import TurnStateErrorMetrics+ from .turn_state_running import TurnStateRunning+ from .turn_streaming_event import TurnStreamingEvent+ from .user_message import UserMessage+ from .user_message_content import UserMessageContent+ from .user_message_content_item import UserMessageContentItem+ from .user_tool_approval_event import UserToolApprovalEvent+ from .user_tool_response_event import UserToolResponseEvent+ from .zai_model_provider import ZaiModelProvider+_dynamic_imports: typing.Dict[str, str] = {+ "ActionRequiredEvent": ".action_required_event",+ "Agent": ".agent",+ "AgentCodeSnippet": ".agent_code_snippet",+ "AgentCodeSnippetSampleCode": ".agent_code_snippet_sample_code",+ "AgentCodeSnippets": ".agent_code_snippets",+ "AgentInfo": ".agent_info",+ "AgentParent": ".agent_parent",+ "AgentSpec": ".agent_spec",+ "AlibabaModelProvider": ".alibaba_model_provider",+ "AnthropicModelProvider": ".anthropic_model_provider",+ "ApprovalAllow": ".approval_allow",+ "ApprovalDecision": ".approval_decision",+ "ApprovalDeny": ".approval_deny",+ "AskUserQuestionsConfig": ".ask_user_questions_config",+ "AvailableMcpServer": ".available_mcp_server",+ "AvailableModel": ".available_model",+ "AvailableModelProvider": ".available_model_provider",+ "AvailableSkill": ".available_skill",+ "BaseMcpAuthRequiredEvent": ".base_mcp_auth_required_event",+ "BaseThreadDoneEvent": ".base_thread_done_event",+ "CancelSessionResponse": ".cancel_session_response",+ "CapabilitiesData": ".capabilities_data",+ "CatalogCustomModelProvider": ".catalog_custom_model_provider",+ "CatalogMcpServer": ".catalog_mcp_server",+ "CatalogMcpServerType": ".catalog_mcp_server_type",+ "CatalogModel": ".catalog_model",+ "CatalogModelProvider": ".catalog_model_provider",+ "CatalogSandboxProvider": ".catalog_sandbox_provider",+ "CatalogSkill": ".catalog_skill",+ "CatalogSkillType": ".catalog_skill_type",+ "CatalogWellKnownModelProvider": ".catalog_well_known_model_provider",+ "CatalogWellKnownModelProviderType": ".catalog_well_known_model_provider_type",+ "ChatCompletionChunkDeltaToolCall": ".chat_completion_chunk_delta_tool_call",+ "ChatCompletionChunkDeltaToolCallFunction": ".chat_completion_chunk_delta_tool_call_function",+ "ChatCompletionContentPartRefusal": ".chat_completion_content_part_refusal",+ "ChatCompletionContentPartText": ".chat_completion_content_part_text",+ "ChatCompletionMessageToolCall": ".chat_completion_message_tool_call",+ "ChatCompletionMessageToolCallFunction": ".chat_completion_message_tool_call_function",+ "CompactionConfig": ".compaction_config",+ "ConfiguredMcpServer": ".configured_mcp_server",+ "ConfiguredModel": ".configured_model",+ "ConfiguredModelProvider": ".configured_model_provider",+ "ConfiguredSandboxProvider": ".configured_sandbox_provider",+ "ConfiguredSkill": ".configured_skill",+ "ContextManagementConfig": ".context_management_config",+ "CreateScheduleRunResponse": ".create_schedule_run_response",+ "CreateSessionAgent": ".create_session_agent",+ "CreatedBySubject": ".created_by_subject",+ "CronExpression": ".cron_expression",+ "CustomModelProvider": ".custom_model_provider",+ "DaytonaSandboxProviderAuth": ".daytona_sandbox_provider_auth",+ "DeleteAgentResponse": ".delete_agent_response",+ "DeleteScheduleResponse": ".delete_schedule_response",+ "DynamicSubAgentsConfig": ".dynamic_sub_agents_config",+ "ExtendedChunkDeltaToolCall": ".extended_chunk_delta_tool_call",+ "FileContent": ".file_content",+ "FinishReason": ".finish_reason",+ "FireworksModelProvider": ".fireworks_model_provider",+ "GenerativeUiConfig": ".generative_ui_config",+ "GetAgentCodeSnippetsResponse": ".get_agent_code_snippets_response",+ "GetAgentResponse": ".get_agent_response",+ "GetAvailableMcpServerResponse": ".get_available_mcp_server_response",+ "GetCapabilitiesResponse": ".get_capabilities_response",+ "GetMcpServerCatalogResponse": ".get_mcp_server_catalog_response",+ "GetMcpServerResponse": ".get_mcp_server_response",+ "GetMeResponse": ".get_me_response",+ "GetMeSubject": ".get_me_subject",+ "GetModelProviderCatalogResponse": ".get_model_provider_catalog_response",+ "GetModelProviderResponse": ".get_model_provider_response",+ "GetSandboxProviderCatalogResponse": ".get_sandbox_provider_catalog_response",+ "GetSandboxProviderResponse": ".get_sandbox_provider_response",+ "GetScheduleResponse": ".get_schedule_response",+ "GetSessionMetricsChartDataResponse": ".get_session_metrics_chart_data_response",+ "GetSessionMetricsChartResponse": ".get_session_metrics_chart_response",+ "GetSessionMetricsMeterResponse": ".get_session_metrics_meter_response",+ "GetSessionResponse": ".get_session_response",+ "GetSkillCatalogResponse": ".get_skill_catalog_response",+ "GetSkillResponse": ".get_skill_response",+ "GetTurnResponse": ".get_turn_response",+ "GitSkill": ".git_skill",+ "GoogleGeminiModelProvider": ".google_gemini_model_provider",+ "InitialUserMessage": ".initial_user_message",+ "InputTokensCompactionTrigger": ".input_tokens_compaction_trigger",+ "LargeToolResponseConfig": ".large_tool_response_config",+ "ListAgentsResponse": ".list_agents_response",+ "ListAvailableMcpServersResponse": ".list_available_mcp_servers_response",+ "ListAvailableModelsResponse": ".list_available_models_response",+ "ListAvailableSkillsResponse": ".list_available_skills_response",+ "ListMcpServerToolsResponse": ".list_mcp_server_tools_response",+ "ListMcpServersResponse": ".list_mcp_servers_response",+ "ListModelProvidersResponse": ".list_model_providers_response",+ "ListPermissionsResponse": ".list_permissions_response",+ "ListScheduleRunsResponse": ".list_schedule_runs_response",+ "ListSchedulesResponse": ".list_schedules_response",+ "ListSessionEventsResponse": ".list_session_events_response",+ "ListSessionsOrder": ".list_sessions_order",+ "ListSessionsResponse": ".list_sessions_response",+ "ListSkillVersionsResponse": ".list_skill_versions_response",+ "ListSkillsResponse": ".list_skills_response",+ "ListTurnEventsOrder": ".list_turn_events_order",+ "ListTurnEventsResponse": ".list_turn_events_response",+ "ListTurnsResponse": ".list_turns_response",+ "McpAuthRequiredEvent": ".mcp_auth_required_event",+ "McpAuthStatus": ".mcp_auth_status",+ "McpAuthStatusStatus": ".mcp_auth_status_status",+ "McpInitializeEvent": ".mcp_initialize_event",+ "McpServer": ".mcp_server",+ "McpServerApprovalToolSelector": ".mcp_server_approval_tool_selector",+ "McpServerAuthInfo": ".mcp_server_auth_info",+ "McpServerAuthPublic": ".mcp_server_auth_public",+ "McpServerAuthPublicOne": ".mcp_server_auth_public_one",+ "McpServerAuthPublicZero": ".mcp_server_auth_public_zero",+ "McpServerDcrAuth": ".mcp_server_dcr_auth",+ "McpServerHeaderAuth": ".mcp_server_header_auth",+ "McpServerInitInfo": ".mcp_server_init_info",+ "McpServerInitInfoTransportType": ".mcp_server_init_info_transport_type",+ "McpServerManifest": ".mcp_server_manifest",+ "McpServerManifestAuth": ".mcp_server_manifest_auth",+ "McpServerToolSelector": ".mcp_server_tool_selector",+ "McpToolInfo": ".mcp_tool_info",+ "Me": ".me",+ "MeSessionType": ".me_session_type",+ "MetricsUnit": ".metrics_unit",+ "Model": ".model",+ "ModelMessageDeltaEvent": ".model_message_delta_event",+ "ModelMessageEvent": ".model_message_event",+ "ModelMessageEventContent": ".model_message_event_content",+ "ModelMessageEventContentOneItem": ".model_message_event_content_one_item",+ "ModelMessageUsage": ".model_message_usage",+ "ModelMessageUsageInputTokensBreakdown": ".model_message_usage_input_tokens_breakdown",+ "ModelParams": ".model_params",+ "ModelProperties": ".model_properties",+ "ModelProviderAuth": ".model_provider_auth",+ "ModelProviderManifest": ".model_provider_manifest",+ "MoonshotModelProvider": ".moonshot_model_provider",+ "OpenAiModelProvider": ".open_ai_model_provider",+ "PermissionResourceType": ".permission_resource_type",+ "PreviousTurnIdInput": ".previous_turn_id_input",+ "RawToolCall": ".raw_tool_call",+ "ReasoningEffort": ".reasoning_effort",+ "RemoteMcpServerManifest": ".remote_mcp_server_manifest",+ "RequestErrorResponse": ".request_error_response",+ "RequestErrorResponseError": ".request_error_response_error",+ "ResourceName": ".resource_name",+ "ResourcePermission": ".resource_permission",+ "ResponseFormat": ".response_format",+ "ResponseFormatJsonObject": ".response_format_json_object",+ "ResponseFormatJsonSchema": ".response_format_json_schema",+ "ResponseFormatJsonSchemaJsonSchema": ".response_format_json_schema_json_schema",+ "ResponseFormatText": ".response_format_text",+ "RuntimeConfig": ".runtime_config",+ "SandboxBuildStatus": ".sandbox_build_status",+ "SandboxCapability": ".sandbox_capability",+ "SandboxConfig": ".sandbox_config",+ "SandboxCreatedEvent": ".sandbox_created_event",+ "SandboxProviderManifest": ".sandbox_provider_manifest",+ "Schedule": ".schedule",+ "ScheduleManifest": ".schedule_manifest",+ "ScheduleRun": ".schedule_run",+ "ScheduleRunStatus": ".schedule_run_status",+ "ScheduleStatus": ".schedule_status",+ "Session": ".session",+ "SessionAgent": ".session_agent",+ "SessionAgentInline": ".session_agent_inline",+ "SessionAgentNameRef": ".session_agent_name_ref",+ "SessionAgentReference": ".session_agent_reference",+ "SessionAgentSpecBody": ".session_agent_spec_body",+ "SessionEvent": ".session_event",+ "SessionEventItem": ".session_event_item",+ "SessionMetadata": ".session_metadata",+ "SessionMetrics": ".session_metrics",+ "SessionMetricsChart": ".session_metrics_chart",+ "SessionMetricsChartDataResponse": ".session_metrics_chart_data_response",+ "SessionMetricsChartName": ".session_metrics_chart_name",+ "SessionMetricsChartResponse": ".session_metrics_chart_response",+ "SessionMetricsGraph": ".session_metrics_graph",+ "SessionMetricsGraphLine": ".session_metrics_graph_line",+ "SessionMetricsMeter": ".session_metrics_meter",+ "SessionMetricsMeterName": ".session_metrics_meter_name",+ "SessionMetricsMeterResponse": ".session_metrics_meter_response",+ "SessionMetricsPoint": ".session_metrics_point",+ "SessionSource": ".session_source",+ "SessionSourceSchedule": ".session_source_schedule",+ "SessionSourceType": ".session_source_type",+ "SettingsCapability": ".settings_capability",+ "Skill": ".skill",+ "SkillCapability": ".skill_capability",+ "SkillManifest": ".skill_manifest",+ "SkillVersion": ".skill_version",+ "TextContent": ".text_content",+ "ThreadCreatedEvent": ".thread_created_event",+ "ThreadDoneEvent": ".thread_done_event",+ "ThreadState": ".thread_state",+ "ThreadStateDone": ".thread_state_done",+ "ThreadStateError": ".thread_state_error",+ "Timezone": ".timezone",+ "TogetherAiModelProvider": ".together_ai_model_provider",+ "TokenPagination": ".token_pagination",+ "ToolApprovalRequiredEvent": ".tool_approval_required_event",+ "ToolCall": ".tool_call",+ "ToolCallRef": ".tool_call_ref",+ "ToolInfo": ".tool_info",+ "ToolResponseEvent": ".tool_response_event",+ "ToolResponseRequiredEvent": ".tool_response_required_event",+ "TrueFoundryMcpServerManifest": ".true_foundry_mcp_server_manifest",+ "TrueFoundryModelProvider": ".true_foundry_model_provider",+ "TrueFoundryRegistrySkill": ".true_foundry_registry_skill",+ "TrueFoundrySystemToolInfo": ".true_foundry_system_tool_info",+ "Turn": ".turn",+ "TurnCreatedEvent": ".turn_created_event",+ "TurnDoneEvent": ".turn_done_event",+ "TurnDoneEventState": ".turn_done_event_state",+ "TurnInputItem": ".turn_input_item",+ "TurnMetrics": ".turn_metrics",+ "TurnState": ".turn_state",+ "TurnStateCancelled": ".turn_state_cancelled",+ "TurnStateCancelledMetrics": ".turn_state_cancelled_metrics",+ "TurnStateCancelledReason": ".turn_state_cancelled_reason",+ "TurnStateDone": ".turn_state_done",+ "TurnStateError": ".turn_state_error",+ "TurnStateErrorMetrics": ".turn_state_error_metrics",+ "TurnStateRunning": ".turn_state_running",+ "TurnStreamingEvent": ".turn_streaming_event",+ "UserMessage": ".user_message",+ "UserMessageContent": ".user_message_content",+ "UserMessageContentItem": ".user_message_content_item",+ "UserToolApprovalEvent": ".user_tool_approval_event",+ "UserToolResponseEvent": ".user_tool_response_event",+ "ZaiModelProvider": ".zai_model_provider",+}+++def __getattr__(attr_name: str) -> typing.Any:+ module_name = _dynamic_imports.get(attr_name)+ if module_name is None:+ raise AttributeError(f"No {attr_name} found in _dynamic_imports for module name -> {__name__}")+ try:+ module = import_module(module_name, __package__)+ if module_name == f".{attr_name}":+ return module+ else:+ return getattr(module, attr_name)+ except ImportError as e:+ raise ImportError(f"Failed to import {attr_name} from {module_name}: {e}") from e+ except AttributeError as e:+ raise AttributeError(f"Failed to get {attr_name} from {module_name}: {e}") from e+++def __dir__():+ lazy_attrs = list(_dynamic_imports.keys())+ return sorted(lazy_attrs)+++__all__ = [+ "ActionRequiredEvent",+ "Agent",+ "AgentCodeSnippet",+ "AgentCodeSnippetSampleCode",+ "AgentCodeSnippets",+ "AgentInfo",+ "AgentParent",+ "AgentSpec",+ "AlibabaModelProvider",+ "AnthropicModelProvider",+ "ApprovalAllow",+ "ApprovalDecision",+ "ApprovalDeny",+ "AskUserQuestionsConfig",+ "AvailableMcpServer",+ "AvailableModel",+ "AvailableModelProvider",+ "AvailableSkill",+ "BaseMcpAuthRequiredEvent",+ "BaseThreadDoneEvent",+ "CancelSessionResponse",+ "CapabilitiesData",+ "CatalogCustomModelProvider",+ "CatalogMcpServer",+ "CatalogMcpServerType",+ "CatalogModel",+ "CatalogModelProvider",+ "CatalogSandboxProvider",+ "CatalogSkill",+ "CatalogSkillType",+ "CatalogWellKnownModelProvider",+ "CatalogWellKnownModelProviderType",+ "ChatCompletionChunkDeltaToolCall",+ "ChatCompletionChunkDeltaToolCallFunction",+ "ChatCompletionContentPartRefusal",+ "ChatCompletionContentPartText",+ "ChatCompletionMessageToolCall",+ "ChatCompletionMessageToolCallFunction",+ "CompactionConfig",+ "ConfiguredMcpServer",+ "ConfiguredModel",+ "ConfiguredModelProvider",+ "ConfiguredSandboxProvider",+ "ConfiguredSkill",+ "ContextManagementConfig",+ "CreateScheduleRunResponse",+ "CreateSessionAgent",+ "CreatedBySubject",+ "CronExpression",+ "CustomModelProvider",+ "DaytonaSandboxProviderAuth",+ "DeleteAgentResponse",+ "DeleteScheduleResponse",+ "DynamicSubAgentsConfig",+ "ExtendedChunkDeltaToolCall",+ "FileContent",+ "FinishReason",+ "FireworksModelProvider",+ "GenerativeUiConfig",+ "GetAgentCodeSnippetsResponse",+ "GetAgentResponse",+ "GetAvailableMcpServerResponse",+ "GetCapabilitiesResponse",+ "GetMcpServerCatalogResponse",+ "GetMcpServerResponse",+ "GetMeResponse",+ "GetMeSubject",+ "GetModelProviderCatalogResponse",+ "GetModelProviderResponse",+ "GetSandboxProviderCatalogResponse",+ "GetSandboxProviderResponse",+ "GetScheduleResponse",+ "GetSessionMetricsChartDataResponse",+ "GetSessionMetricsChartResponse",+ "GetSessionMetricsMeterResponse",+ "GetSessionResponse",+ "GetSkillCatalogResponse",+ "GetSkillResponse",+ "GetTurnResponse",+ "GitSkill",+ "GoogleGeminiModelProvider",+ "InitialUserMessage",+ "InputTokensCompactionTrigger",+ "LargeToolResponseConfig",+ "ListAgentsResponse",+ "ListAvailableMcpServersResponse",+ "ListAvailableModelsResponse",+ "ListAvailableSkillsResponse",+ "ListMcpServerToolsResponse",+ "ListMcpServersResponse",+ "ListModelProvidersResponse",+ "ListPermissionsResponse",+ "ListScheduleRunsResponse",+ "ListSchedulesResponse",+ "ListSessionEventsResponse",+ "ListSessionsOrder",+ "ListSessionsResponse",+ "ListSkillVersionsResponse",+ "ListSkillsResponse",+ "ListTurnEventsOrder",+ "ListTurnEventsResponse",+ "ListTurnsResponse",+ "McpAuthRequiredEvent",+ "McpAuthStatus",+ "McpAuthStatusStatus",+ "McpInitializeEvent",+ "McpServer",+ "McpServerApprovalToolSelector",+ "McpServerAuthInfo",+ "McpServerAuthPublic",+ "McpServerAuthPublicOne",+ "McpServerAuthPublicZero",+ "McpServerDcrAuth",+ "McpServerHeaderAuth",+ "McpServerInitInfo",+ "McpServerInitInfoTransportType",+ "McpServerManifest",+ "McpServerManifestAuth",+ "McpServerToolSelector",+ "McpToolInfo",+ "Me",+ "MeSessionType",+ "MetricsUnit",+ "Model",+ "ModelMessageDeltaEvent",+ "ModelMessageEvent",+ "ModelMessageEventContent",+ "ModelMessageEventContentOneItem",+ "ModelMessageUsage",+ "ModelMessageUsageInputTokensBreakdown",+ "ModelParams",+ "ModelProperties",+ "ModelProviderAuth",+ "ModelProviderManifest",+ "MoonshotModelProvider",+ "OpenAiModelProvider",+ "PermissionResourceType",+ "PreviousTurnIdInput",+ "RawToolCall",+ "ReasoningEffort",+ "RemoteMcpServerManifest",+ "RequestErrorResponse",+ "RequestErrorResponseError",+ "ResourceName",+ "ResourcePermission",+ "ResponseFormat",+ "ResponseFormatJsonObject",+ "ResponseFormatJsonSchema",+ "ResponseFormatJsonSchemaJsonSchema",+ "ResponseFormatText",+ "RuntimeConfig",+ "SandboxBuildStatus",+ "SandboxCapability",+ "SandboxConfig",+ "SandboxCreatedEvent",+ "SandboxProviderManifest",+ "Schedule",+ "ScheduleManifest",+ "ScheduleRun",+ "ScheduleRunStatus",+ "ScheduleStatus",+ "Session",+ "SessionAgent",+ "SessionAgentInline",+ "SessionAgentNameRef",+ "SessionAgentReference",+ "SessionAgentSpecBody",+ "SessionEvent",+ "SessionEventItem",+ "SessionMetadata",+ "SessionMetrics",+ "SessionMetricsChart",+ "SessionMetricsChartDataResponse",+ "SessionMetricsChartName",+ "SessionMetricsChartResponse",+ "SessionMetricsGraph",+ "SessionMetricsGraphLine",+ "SessionMetricsMeter",+ "SessionMetricsMeterName",+ "SessionMetricsMeterResponse",+ "SessionMetricsPoint",+ "SessionSource",+ "SessionSourceSchedule",+ "SessionSourceType",+ "SettingsCapability",+ "Skill",+ "SkillCapability",+ "SkillManifest",+ "SkillVersion",+ "TextContent",+ "ThreadCreatedEvent",+ "ThreadDoneEvent",+ "ThreadState",+ "ThreadStateDone",+ "ThreadStateError",+ "Timezone",+ "TogetherAiModelProvider",+ "TokenPagination",+ "ToolApprovalRequiredEvent",+ "ToolCall",+ "ToolCallRef",+ "ToolInfo",+ "ToolResponseEvent",+ "ToolResponseRequiredEvent",+ "TrueFoundryMcpServerManifest",+ "TrueFoundryModelProvider",+ "TrueFoundryRegistrySkill",+ "TrueFoundrySystemToolInfo",+ "Turn",+ "TurnCreatedEvent",+ "TurnDoneEvent",+ "TurnDoneEventState",+ "TurnInputItem",+ "TurnMetrics",+ "TurnState",+ "TurnStateCancelled",+ "TurnStateCancelledMetrics",+ "TurnStateCancelledReason",+ "TurnStateDone",+ "TurnStateError",+ "TurnStateErrorMetrics",+ "TurnStateRunning",+ "TurnStreamingEvent",+ "UserMessage",+ "UserMessageContent",+ "UserMessageContentItem",+ "UserToolApprovalEvent",+ "UserToolResponseEvent",+ "ZaiModelProvider",+]diff --git a/python/trueforge_sdk/src/trueforge_sdk/types/action_required_event.py b/python/trueforge_sdk/src/trueforge_sdk/types/action_required_event.pynew file mode 100644index 000000000..31aa07509--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/action_required_event.py@@ -0,0 +1,9 @@+# This file was auto-generated by Fern from our API Definition.++import typing++from .mcp_auth_required_event import McpAuthRequiredEvent+from .tool_approval_required_event import ToolApprovalRequiredEvent+from .tool_response_required_event import ToolResponseRequiredEvent++ActionRequiredEvent = typing.Union[McpAuthRequiredEvent, ToolApprovalRequiredEvent, ToolResponseRequiredEvent]diff --git a/python/trueforge_sdk/src/trueforge_sdk/types/agent.py b/python/trueforge_sdk/src/trueforge_sdk/types/agent.pynew file mode 100644index 000000000..0289e1fd2--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/agent.py@@ -0,0 +1,30 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .agent_spec import AgentSpec+from .created_by_subject import CreatedBySubject+from .resource_name import ResourceName+++class Agent(UncheckedBaseModel):+ created_by_subject: CreatedBySubject+ description: str+ id: str = pydantic.Field()+ """+ Immutable server-generated agent identifier.+ """++ manifest: AgentSpec+ name: ResourceName++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/agent_code_snippet.py b/python/trueforge_sdk/src/trueforge_sdk/types/agent_code_snippet.pynew file mode 100644index 000000000..ea4b52e6a--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/agent_code_snippet.py@@ -0,0 +1,23 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .agent_code_snippet_sample_code import AgentCodeSnippetSampleCode+++class AgentCodeSnippet(UncheckedBaseModel):+ icon: str+ label_name: str+ language: str+ sample_code: AgentCodeSnippetSampleCode++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/agent_code_snippet_sample_code.py b/python/trueforge_sdk/src/trueforge_sdk/types/agent_code_snippet_sample_code.pynew file mode 100644index 000000000..e9067196c--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/agent_code_snippet_sample_code.py@@ -0,0 +1,27 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+++class AgentCodeSnippetSampleCode(UncheckedBaseModel):+ non_stream: str = pydantic.Field()+ """+ SDK sample that creates a turn without streaming.+ """++ stream: str = pydantic.Field()+ """+ SDK sample that streams turn events.+ """++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/agent_code_snippets.py b/python/trueforge_sdk/src/trueforge_sdk/types/agent_code_snippets.pynew file mode 100644index 000000000..072e6cc59--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/agent_code_snippets.py@@ -0,0 +1,25 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .agent_code_snippet import AgentCodeSnippet+++class AgentCodeSnippets(UncheckedBaseModel):+ base_url: str = pydantic.Field()+ """+ Public base URL for the TrueForge SDK `baseUrl`.+ """++ snippets: typing.List[AgentCodeSnippet]++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/agent_info.py b/python/trueforge_sdk/src/trueforge_sdk/types/agent_info.pynew file mode 100644index 000000000..53a14069f--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/agent_info.py@@ -0,0 +1,37 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+++class AgentInfo(UncheckedBaseModel):+ input: str = pydantic.Field()+ """+ Input prompt passed to the subagent.+ """++ model: typing.Optional[str] = pydantic.Field(default=None)+ """+ Optional model override for the subagent.+ """++ name: str = pydantic.Field()+ """+ Display name of the dynamic subagent.+ """++ type: typing.Literal["dynamic"] = pydantic.Field(default="dynamic")+ """+ Subagent kind.+ """++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/agent_parent.py b/python/trueforge_sdk/src/trueforge_sdk/types/agent_parent.pynew file mode 100644index 000000000..0ffcdbdaa--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/agent_parent.py@@ -0,0 +1,27 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+++class AgentParent(UncheckedBaseModel):+ thread_id: str = pydantic.Field()+ """+ Parent thread that spawned the child agent.+ """++ tool_call_id: str = pydantic.Field()+ """+ Tool call on the parent thread that created the child.+ """++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/agent_spec.py b/python/trueforge_sdk/src/trueforge_sdk/types/agent_spec.pynew file mode 100644index 000000000..c009ee0ca--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/agent_spec.py@@ -0,0 +1,50 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .initial_user_message import InitialUserMessage+from .mcp_server import McpServer+from .model import Model+from .response_format import ResponseFormat+from .runtime_config import RuntimeConfig+from .skill import Skill+++class AgentSpec(UncheckedBaseModel):+ """+ Complete agent definition used inline on a session or saved as a named agent.+ """++ config: typing.Optional[RuntimeConfig] = None+ instructions: typing.Optional[str] = pydantic.Field(default=None)+ """+ Optional system prompt — the agent's role, behavior, and constraints.+ """++ mcp_servers: typing.Optional[typing.List[McpServer]] = pydantic.Field(default=None)+ """+ Optional MCP servers attached by configured name.+ """++ messages: typing.Optional[typing.List[InitialUserMessage]] = pydantic.Field(default=None)+ """+ Optional initial user messages injected at the start of every session.+ """++ model: Model+ response_format: typing.Optional[ResponseFormat] = None+ skills: typing.Optional[typing.List[Skill]] = pydantic.Field(default=None)+ """+ Skills used in this agent.+ """++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/alibaba_model_provider.py b/python/trueforge_sdk/src/trueforge_sdk/types/alibaba_model_provider.pynew file mode 100644index 000000000..d5f6a6e72--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/alibaba_model_provider.py@@ -0,0 +1,32 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .configured_model import ConfiguredModel+from .model_provider_auth import ModelProviderAuth+++class AlibabaModelProvider(UncheckedBaseModel):+ auth: ModelProviderAuth+ base_url: typing.Optional[str] = pydantic.Field(default="https://dashscope-intl.aliyuncs.com/compatible-mode/v1")+ """+ Override of the provider's default API base URL.+ """++ models: typing.List[ConfiguredModel] = pydantic.Field()+ """+ Models exposed by this provider (at least one).+ """++ type: typing.Literal["alibaba"] = "alibaba"++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/anthropic_model_provider.py b/python/trueforge_sdk/src/trueforge_sdk/types/anthropic_model_provider.pynew file mode 100644index 000000000..7330aeae7--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/anthropic_model_provider.py@@ -0,0 +1,32 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .configured_model import ConfiguredModel+from .model_provider_auth import ModelProviderAuth+++class AnthropicModelProvider(UncheckedBaseModel):+ auth: ModelProviderAuth+ base_url: typing.Optional[str] = pydantic.Field(default="https://api.anthropic.com/v1")+ """+ Override of the provider's default API base URL.+ """++ models: typing.List[ConfiguredModel] = pydantic.Field()+ """+ Models exposed by this provider (at least one).+ """++ type: typing.Literal["anthropic"] = "anthropic"++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/approval_allow.py b/python/trueforge_sdk/src/trueforge_sdk/types/approval_allow.pynew file mode 100644index 000000000..6ae4bb598--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/approval_allow.py@@ -0,0 +1,19 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+++class ApprovalAllow(UncheckedBaseModel):+ status: typing.Literal["allow"] = "allow"++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/approval_decision.py b/python/trueforge_sdk/src/trueforge_sdk/types/approval_decision.pynew file mode 100644index 000000000..aa156aef1--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/approval_decision.py@@ -0,0 +1,8 @@+# This file was auto-generated by Fern from our API Definition.++import typing++from .approval_allow import ApprovalAllow+from .approval_deny import ApprovalDeny++ApprovalDecision = typing.Union[ApprovalAllow, ApprovalDeny]diff --git a/python/trueforge_sdk/src/trueforge_sdk/types/approval_deny.py b/python/trueforge_sdk/src/trueforge_sdk/types/approval_deny.pynew file mode 100644index 000000000..0c178afcc--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/approval_deny.py@@ -0,0 +1,24 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+++class ApprovalDeny(UncheckedBaseModel):+ reason: typing.Optional[str] = pydantic.Field(default=None)+ """+ Optional reason shown to the agent when denied.+ """++ status: typing.Literal["deny"] = "deny"++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/ask_user_questions_config.py b/python/trueforge_sdk/src/trueforge_sdk/types/ask_user_questions_config.pynew file mode 100644index 000000000..300b53568--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/ask_user_questions_config.py@@ -0,0 +1,22 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+++class AskUserQuestionsConfig(UncheckedBaseModel):+ enabled: typing.Optional[bool] = pydantic.Field(default=True)+ """+ Enable the `ask_user_question` tool. Default: true.+ """++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/available_mcp_server.py b/python/trueforge_sdk/src/trueforge_sdk/types/available_mcp_server.pynew file mode 100644index 000000000..f8e469969--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/available_mcp_server.py@@ -0,0 +1,28 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .mcp_auth_status import McpAuthStatus+from .mcp_server_auth_public import McpServerAuthPublic+from .resource_name import ResourceName+++class AvailableMcpServer(UncheckedBaseModel):+ auth: typing.Optional[McpServerAuthPublic] = None+ auth_status: McpAuthStatus+ name: ResourceName+ url: str = pydantic.Field()+ """+ URL of the remote MCP server.+ """++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/available_model.py b/python/trueforge_sdk/src/trueforge_sdk/types/available_model.pynew file mode 100644index 000000000..c683de00d--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/available_model.py@@ -0,0 +1,32 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .available_model_provider import AvailableModelProvider+from .model_properties import ModelProperties+++class AvailableModel(UncheckedBaseModel):+ model_id: str = pydantic.Field()+ """+ Upstream, provider-specific identifier sent to the provider API.+ """++ name: str = pydantic.Field()+ """+ Fully qualified name `provider_name/model_name`, e.g. "openai/gpt-5-6-sol". Unique within a tenant.+ """++ properties: ModelProperties+ provider: AvailableModelProvider++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/available_model_provider.py b/python/trueforge_sdk/src/trueforge_sdk/types/available_model_provider.pynew file mode 100644index 000000000..42b21567e--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/available_model_provider.py@@ -0,0 +1,26 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+++class AvailableModelProvider(UncheckedBaseModel):+ """+ Owning configured provider.+ """++ name: str = pydantic.Field()+ """+ Configured provider resource name; matches the FQN prefix of `name`.+ """++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/available_skill.py b/python/trueforge_sdk/src/trueforge_sdk/types/available_skill.pynew file mode 100644index 000000000..60f4e681f--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/available_skill.py@@ -0,0 +1,32 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+++class AvailableSkill(UncheckedBaseModel):+ description: str = pydantic.Field()+ """+ Concise guidance for when the agent should use the skill.+ """++ metadata: typing.Optional[typing.Dict[str, str]] = pydantic.Field(default=None)+ """+ Optional skill metadata.+ """++ name: str = pydantic.Field()+ """+ Skill name.+ """++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/base_mcp_auth_required_event.py b/python/trueforge_sdk/src/trueforge_sdk/types/base_mcp_auth_required_event.pynew file mode 100644index 000000000..fb47a1bf7--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/base_mcp_auth_required_event.py@@ -0,0 +1,32 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+++class BaseMcpAuthRequiredEvent(UncheckedBaseModel):+ created_at: str = pydantic.Field()+ """+ ISO 8601 event timestamp.+ """++ id: str = pydantic.Field()+ """+ Unique identifier for the event (monotonic ULID).+ """++ thread_id: typing.Optional[str] = pydantic.Field(default=None)+ """+ Always null — this is a run-level event.+ """++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/base_thread_done_event.py b/python/trueforge_sdk/src/trueforge_sdk/types/base_thread_done_event.pynew file mode 100644index 000000000..2b604a655--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/base_thread_done_event.py@@ -0,0 +1,29 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .agent_parent import AgentParent+++class BaseThreadDoneEvent(UncheckedBaseModel):+ parent: typing.Optional[AgentParent] = None+ thread_id: str = pydantic.Field()+ """+ Thread that finished.+ """++ title: str = pydantic.Field()+ """+ Human-readable thread title.+ """++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/cancel_session_response.py b/python/trueforge_sdk/src/trueforge_sdk/types/cancel_session_response.pynew file mode 100644index 000000000..92b4a1679--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/cancel_session_response.py@@ -0,0 +1,21 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+++class CancelSessionResponse(UncheckedBaseModel):+ """+ Empty success body. HTTP 200 means the cancel request was accepted (or nothing was running).+ """++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/capabilities_data.py b/python/trueforge_sdk/src/trueforge_sdk/types/capabilities_data.pynew file mode 100644index 000000000..fe095fd67--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/capabilities_data.py@@ -0,0 +1,24 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .sandbox_capability import SandboxCapability+from .settings_capability import SettingsCapability+from .skill_capability import SkillCapability+++class CapabilitiesData(UncheckedBaseModel):+ sandbox: SandboxCapability+ settings: SettingsCapability+ skill: SkillCapability++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/catalog_custom_model_provider.py b/python/trueforge_sdk/src/trueforge_sdk/types/catalog_custom_model_provider.pynew file mode 100644index 000000000..300bafe73--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/catalog_custom_model_provider.py@@ -0,0 +1,25 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .reasoning_effort import ReasoningEffort+++class CatalogCustomModelProvider(UncheckedBaseModel):+ supported_reasoning_efforts: typing.List[ReasoningEffort] = pydantic.Field()+ """+ Supported reasoning-effort values for this provider+ """++ type: typing.Literal["custom"] = "custom"++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/catalog_mcp_server.py b/python/trueforge_sdk/src/trueforge_sdk/types/catalog_mcp_server.pynew file mode 100644index 000000000..2ad3159f5--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/catalog_mcp_server.py@@ -0,0 +1,38 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .catalog_mcp_server_type import CatalogMcpServerType+from .mcp_server_manifest_auth import McpServerManifestAuth+from .resource_name import ResourceName+++class CatalogMcpServer(UncheckedBaseModel):+ auth: typing.Optional[McpServerManifestAuth] = None+ description: str = pydantic.Field()+ """+ Concise summary of what this MCP server provides.+ """++ logo: typing.Optional[str] = pydantic.Field(default=None)+ """+ URL of the MCP server logo asset.+ """++ name: ResourceName+ type: CatalogMcpServerType = "remote"+ url: str = pydantic.Field()+ """+ URL of the remote MCP server.+ """++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/catalog_mcp_server_type.py b/python/trueforge_sdk/src/trueforge_sdk/types/catalog_mcp_server_type.pynew file mode 100644index 000000000..cb0af3c8c--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/catalog_mcp_server_type.py@@ -0,0 +1,5 @@+# This file was auto-generated by Fern from our API Definition.++import typing++CatalogMcpServerType = typing.Literal["remote"]diff --git a/python/trueforge_sdk/src/trueforge_sdk/types/catalog_model.py b/python/trueforge_sdk/src/trueforge_sdk/types/catalog_model.pynew file mode 100644index 000000000..3005a1b61--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/catalog_model.py@@ -0,0 +1,27 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .model_properties import ModelProperties+from .resource_name import ResourceName+++class CatalogModel(UncheckedBaseModel):+ model_id: str = pydantic.Field()+ """+ Upstream, provider-specific identifier sent to the provider API.+ """++ name: ResourceName+ properties: ModelProperties++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/catalog_model_provider.py b/python/trueforge_sdk/src/trueforge_sdk/types/catalog_model_provider.pynew file mode 100644index 000000000..922ed127b--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/catalog_model_provider.py@@ -0,0 +1,8 @@+# This file was auto-generated by Fern from our API Definition.++import typing++from .catalog_custom_model_provider import CatalogCustomModelProvider+from .catalog_well_known_model_provider import CatalogWellKnownModelProvider++CatalogModelProvider = typing.Union[CatalogWellKnownModelProvider, CatalogCustomModelProvider]diff --git a/python/trueforge_sdk/src/trueforge_sdk/types/catalog_sandbox_provider.py b/python/trueforge_sdk/src/trueforge_sdk/types/catalog_sandbox_provider.pynew file mode 100644index 000000000..eb5c01ba2--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/catalog_sandbox_provider.py@@ -0,0 +1,42 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+++class CatalogSandboxProvider(UncheckedBaseModel):+ auto_archive_interval_in_minutes: int = pydantic.Field()+ """+ Minutes before Daytona auto-archives the sandbox (0 disables).+ """++ auto_delete_interval_in_minutes: int = pydantic.Field()+ """+ Minutes before Daytona auto-deletes the sandbox (0 disables).+ """++ auto_stop_interval_in_minutes: int = pydantic.Field()+ """+ Minutes of idle time before Daytona auto-stops the sandbox (0 disables).+ """++ exec_timeout_ms: int = pydantic.Field()+ """+ Default sandbox command exec timeout in milliseconds.+ """++ type: typing.Literal["daytona"] = pydantic.Field(default="daytona")+ """+ Daytona sandbox provider.+ """++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/catalog_skill.py b/python/trueforge_sdk/src/trueforge_sdk/types/catalog_skill.pynew file mode 100644index 000000000..9c4f58468--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/catalog_skill.py@@ -0,0 +1,41 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .catalog_skill_type import CatalogSkillType+from .resource_name import ResourceName+++class CatalogSkill(UncheckedBaseModel):+ description: str = pydantic.Field()+ """+ Concise guidance for when the agent should use the skill.+ """++ name: ResourceName+ path: typing.Optional[str] = pydantic.Field(default=None)+ """+ Path to the skill directory within the repository. Omit to use the repository root.+ """++ ref: str = pydantic.Field()+ """+ Git ref — branch name, tag, or commit SHA.+ """++ type: CatalogSkillType = "git"+ url: str = pydantic.Field()+ """+ Full HTTPS URL of a GitHub or GitLab repository.+ """++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/catalog_skill_type.py b/python/trueforge_sdk/src/trueforge_sdk/types/catalog_skill_type.pynew file mode 100644index 000000000..e403da868--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/catalog_skill_type.py@@ -0,0 +1,5 @@+# This file was auto-generated by Fern from our API Definition.++import typing++CatalogSkillType = typing.Literal["git"]diff --git a/python/trueforge_sdk/src/trueforge_sdk/types/catalog_well_known_model_provider.py b/python/trueforge_sdk/src/trueforge_sdk/types/catalog_well_known_model_provider.pynew file mode 100644index 000000000..cca86bc73--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/catalog_well_known_model_provider.py@@ -0,0 +1,31 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .catalog_model import CatalogModel+from .catalog_well_known_model_provider_type import CatalogWellKnownModelProviderType+++class CatalogWellKnownModelProvider(UncheckedBaseModel):+ logo: typing.Optional[str] = pydantic.Field(default=None)+ """+ URL of the provider logo asset+ """++ models: typing.List[CatalogModel] = pydantic.Field()+ """+ Preset models+ """++ type: CatalogWellKnownModelProviderType++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/catalog_well_known_model_provider_type.py b/python/trueforge_sdk/src/trueforge_sdk/types/catalog_well_known_model_provider_type.pynew file mode 100644index 000000000..a159d9dda--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/catalog_well_known_model_provider_type.py@@ -0,0 +1,58 @@+# This file was auto-generated by Fern from our API Definition.++import typing++from ..core import enum++T_Result = typing.TypeVar("T_Result")+++class CatalogWellKnownModelProviderType(enum.StrEnum):+ OPENAI = "openai"+ ANTHROPIC = "anthropic"+ GOOGLE_GEMINI = "google-gemini"+ FIREWORKS = "fireworks"+ ZAI = "zai"+ MOONSHOT = "moonshot"+ ALIBABA = "alibaba"+ TOGETHER = "together"+ _UNKNOWN = "__CATALOGWELLKNOWNMODELPROVIDERTYPE_UNKNOWN__"+ """+ This member is used for forward compatibility. If the value is not recognized by the enum, it will be stored here, and the raw value is accessible through `.value`.+ """++ @classmethod+ def _missing_(cls, value: typing.Any) -> "CatalogWellKnownModelProviderType":+ unknown = cls._UNKNOWN+ unknown._value_ = value+ return unknown++ def visit(+ self,+ openai: typing.Callable[[], T_Result],+ anthropic: typing.Callable[[], T_Result],+ google_gemini: typing.Callable[[], T_Result],+ fireworks: typing.Callable[[], T_Result],+ zai: typing.Callable[[], T_Result],+ moonshot: typing.Callable[[], T_Result],+ alibaba: typing.Callable[[], T_Result],+ together: typing.Callable[[], T_Result],+ _unknown_member: typing.Callable[[str], T_Result],+ ) -> T_Result:+ if self is CatalogWellKnownModelProviderType.OPENAI:+ return openai()+ if self is CatalogWellKnownModelProviderType.ANTHROPIC:+ return anthropic()+ if self is CatalogWellKnownModelProviderType.GOOGLE_GEMINI:+ return google_gemini()+ if self is CatalogWellKnownModelProviderType.FIREWORKS:+ return fireworks()+ if self is CatalogWellKnownModelProviderType.ZAI:+ return zai()+ if self is CatalogWellKnownModelProviderType.MOONSHOT:+ return moonshot()+ if self is CatalogWellKnownModelProviderType.ALIBABA:+ return alibaba()+ if self is CatalogWellKnownModelProviderType.TOGETHER:+ return together()+ return _unknown_member(self._value_)diff --git a/python/trueforge_sdk/src/trueforge_sdk/types/chat_completion_chunk_delta_tool_call.py b/python/trueforge_sdk/src/trueforge_sdk/types/chat_completion_chunk_delta_tool_call.pynew file mode 100644index 000000000..11cd11e5d--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/chat_completion_chunk_delta_tool_call.py@@ -0,0 +1,34 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .chat_completion_chunk_delta_tool_call_function import ChatCompletionChunkDeltaToolCallFunction+++class ChatCompletionChunkDeltaToolCall(UncheckedBaseModel):+ function: typing.Optional[ChatCompletionChunkDeltaToolCallFunction] = None+ id: typing.Optional[str] = pydantic.Field(default=None)+ """+ Tool call id (may arrive across multiple deltas).+ """++ index: int = pydantic.Field()+ """+ Index of this tool call in the streaming delta array.+ """++ type: typing.Optional[typing.Literal["function"]] = pydantic.Field(default=None)+ """+ Tool call type when present on this delta.+ """++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/chat_completion_chunk_delta_tool_call_function.py b/python/trueforge_sdk/src/trueforge_sdk/types/chat_completion_chunk_delta_tool_call_function.pynew file mode 100644index 000000000..fd81e9027--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/chat_completion_chunk_delta_tool_call_function.py@@ -0,0 +1,27 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+++class ChatCompletionChunkDeltaToolCallFunction(UncheckedBaseModel):+ arguments: typing.Optional[str] = pydantic.Field(default=None)+ """+ Partial or complete JSON arguments string.+ """++ name: typing.Optional[str] = pydantic.Field(default=None)+ """+ Partial or complete function name.+ """++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/chat_completion_content_part_refusal.py b/python/trueforge_sdk/src/trueforge_sdk/types/chat_completion_content_part_refusal.pynew file mode 100644index 000000000..9ae46a100--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/chat_completion_content_part_refusal.py@@ -0,0 +1,27 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+++class ChatCompletionContentPartRefusal(UncheckedBaseModel):+ refusal: str = pydantic.Field()+ """+ Refusal message text.+ """++ type: typing.Literal["refusal"] = pydantic.Field(default="refusal")+ """+ Model refusal content part.+ """++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/chat_completion_content_part_text.py b/python/trueforge_sdk/src/trueforge_sdk/types/chat_completion_content_part_text.pynew file mode 100644index 000000000..466bb6afa--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/chat_completion_content_part_text.py@@ -0,0 +1,27 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+++class ChatCompletionContentPartText(UncheckedBaseModel):+ text: str = pydantic.Field()+ """+ Plain-text content.+ """++ type: typing.Literal["text"] = pydantic.Field(default="text")+ """+ Text content part.+ """++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/chat_completion_message_tool_call.py b/python/trueforge_sdk/src/trueforge_sdk/types/chat_completion_message_tool_call.pynew file mode 100644index 000000000..83e6b8e60--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/chat_completion_message_tool_call.py@@ -0,0 +1,29 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .chat_completion_message_tool_call_function import ChatCompletionMessageToolCallFunction+++class ChatCompletionMessageToolCall(UncheckedBaseModel):+ function: ChatCompletionMessageToolCallFunction+ id: str = pydantic.Field()+ """+ Tool call id.+ """++ type: typing.Literal["function"] = pydantic.Field(default="function")+ """+ Tool call type.+ """++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/chat_completion_message_tool_call_function.py b/python/trueforge_sdk/src/trueforge_sdk/types/chat_completion_message_tool_call_function.pynew file mode 100644index 000000000..7aece126f--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/chat_completion_message_tool_call_function.py@@ -0,0 +1,27 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+++class ChatCompletionMessageToolCallFunction(UncheckedBaseModel):+ arguments: str = pydantic.Field()+ """+ JSON-encoded function arguments string.+ """++ name: str = pydantic.Field()+ """+ Function/tool name.+ """++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/compaction_config.py b/python/trueforge_sdk/src/trueforge_sdk/types/compaction_config.pynew file mode 100644index 000000000..dade981e5--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/compaction_config.py@@ -0,0 +1,29 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .input_tokens_compaction_trigger import InputTokensCompactionTrigger+++class CompactionConfig(UncheckedBaseModel):+ """+ Uses 80% of the model context length when the explicit trigger is omitted, or 50000 tokens if unknown.+ """++ enabled: typing.Optional[bool] = pydantic.Field(default=True)+ """+ Summarize older history when context grows too large. Default: true.+ """++ trigger: typing.Optional[InputTokensCompactionTrigger] = None++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/configured_mcp_server.py b/python/trueforge_sdk/src/trueforge_sdk/types/configured_mcp_server.pynew file mode 100644index 000000000..7af13dbae--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/configured_mcp_server.py@@ -0,0 +1,24 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .mcp_auth_status import McpAuthStatus+from .mcp_server_manifest import McpServerManifest+from .resource_name import ResourceName+++class ConfiguredMcpServer(UncheckedBaseModel):+ auth_status: McpAuthStatus+ manifest: McpServerManifest+ name: ResourceName++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/configured_model.py b/python/trueforge_sdk/src/trueforge_sdk/types/configured_model.pynew file mode 100644index 000000000..2581d0817--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/configured_model.py@@ -0,0 +1,27 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .model_properties import ModelProperties+from .resource_name import ResourceName+++class ConfiguredModel(UncheckedBaseModel):+ model_id: str = pydantic.Field()+ """+ Upstream, provider-specific identifier sent to the provider API.+ """++ name: ResourceName+ properties: ModelProperties++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/configured_model_provider.py b/python/trueforge_sdk/src/trueforge_sdk/types/configured_model_provider.pynew file mode 100644index 000000000..c239d8baa--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/configured_model_provider.py@@ -0,0 +1,22 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .model_provider_manifest import ModelProviderManifest+from .resource_name import ResourceName+++class ConfiguredModelProvider(UncheckedBaseModel):+ manifest: ModelProviderManifest+ name: ResourceName++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/configured_sandbox_provider.py b/python/trueforge_sdk/src/trueforge_sdk/types/configured_sandbox_provider.pynew file mode 100644index 000000000..557c21dc9--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/configured_sandbox_provider.py@@ -0,0 +1,26 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .sandbox_build_status import SandboxBuildStatus+from .sandbox_provider_manifest import SandboxProviderManifest+++class ConfiguredSandboxProvider(UncheckedBaseModel):+ manifest: SandboxProviderManifest+ status: SandboxBuildStatus+ status_reason: typing.Optional[str] = pydantic.Field(default=None)+ """+ Human-readable detail for the current status; null when ready.+ """++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/configured_skill.py b/python/trueforge_sdk/src/trueforge_sdk/types/configured_skill.pynew file mode 100644index 000000000..4d32a7e85--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/configured_skill.py@@ -0,0 +1,21 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .skill_manifest import SkillManifest+++class ConfiguredSkill(UncheckedBaseModel):+ manifest: SkillManifest+ name: str++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/context_management_config.py b/python/trueforge_sdk/src/trueforge_sdk/types/context_management_config.pynew file mode 100644index 000000000..c0d5c04f5--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/context_management_config.py@@ -0,0 +1,22 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .compaction_config import CompactionConfig+from .large_tool_response_config import LargeToolResponseConfig+++class ContextManagementConfig(UncheckedBaseModel):+ compaction: typing.Optional[CompactionConfig] = None+ large_tool_response: typing.Optional[LargeToolResponseConfig] = None++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/create_schedule_run_response.py b/python/trueforge_sdk/src/trueforge_sdk/types/create_schedule_run_response.pynew file mode 100644index 000000000..59c98d91e--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/create_schedule_run_response.py@@ -0,0 +1,20 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .schedule_run import ScheduleRun+++class CreateScheduleRunResponse(UncheckedBaseModel):+ data: ScheduleRun++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/create_session_agent.py b/python/trueforge_sdk/src/trueforge_sdk/types/create_session_agent.pynew file mode 100644index 000000000..5612f6743--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/create_session_agent.py@@ -0,0 +1,8 @@+# This file was auto-generated by Fern from our API Definition.++import typing++from .session_agent_name_ref import SessionAgentNameRef+from .session_agent_spec_body import SessionAgentSpecBody++CreateSessionAgent = typing.Union[SessionAgentNameRef, SessionAgentSpecBody]diff --git a/python/trueforge_sdk/src/trueforge_sdk/types/created_by_subject.py b/python/trueforge_sdk/src/trueforge_sdk/types/created_by_subject.pynew file mode 100644index 000000000..4d9c07b15--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/created_by_subject.py@@ -0,0 +1,36 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+++class CreatedBySubject(UncheckedBaseModel):+ """+ Who created this resource.+ """++ subject_display_name: str = pydantic.Field()+ """+ Display name.+ """++ subject_id: str = pydantic.Field()+ """+ Subject id.+ """++ subject_type: str = pydantic.Field()+ """+ Subject type.+ """++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/cron_expression.py b/python/trueforge_sdk/src/trueforge_sdk/types/cron_expression.pynew file mode 100644index 000000000..df2cfb232--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/cron_expression.py@@ -0,0 +1,6 @@+# This file was auto-generated by Fern from our API Definition.++CronExpression = str+"""+Standard 5-field cron expression, evaluated in `timezone`.+"""diff --git a/python/trueforge_sdk/src/trueforge_sdk/types/custom_model_provider.py b/python/trueforge_sdk/src/trueforge_sdk/types/custom_model_provider.pynew file mode 100644index 000000000..a1b14e733--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/custom_model_provider.py@@ -0,0 +1,34 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .configured_model import ConfiguredModel+from .model_provider_auth import ModelProviderAuth+from .resource_name import ResourceName+++class CustomModelProvider(UncheckedBaseModel):+ auth: typing.Optional[ModelProviderAuth] = None+ base_url: str = pydantic.Field()+ """+ Base URL of the provider's API.+ """++ models: typing.List[ConfiguredModel] = pydantic.Field()+ """+ Models exposed by this provider (at least one).+ """++ name: ResourceName+ type: typing.Literal["custom"] = "custom"++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/daytona_sandbox_provider_auth.py b/python/trueforge_sdk/src/trueforge_sdk/types/daytona_sandbox_provider_auth.pynew file mode 100644index 000000000..6be23eb26--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/daytona_sandbox_provider_auth.py@@ -0,0 +1,26 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+++class DaytonaSandboxProviderAuth(UncheckedBaseModel):+ """+ Daytona authentication credentials.+ """++ api_key: str = pydantic.Field()+ """+ Daytona API key. Responses are redacted; on PUT, a real value sets/rotates and a redacted value keeps the stored key.+ """++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/delete_agent_response.py b/python/trueforge_sdk/src/trueforge_sdk/types/delete_agent_response.pynew file mode 100644index 000000000..bb7161412--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/delete_agent_response.py@@ -0,0 +1,17 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+++class DeleteAgentResponse(UncheckedBaseModel):+ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/delete_schedule_response.py b/python/trueforge_sdk/src/trueforge_sdk/types/delete_schedule_response.pynew file mode 100644index 000000000..65dd45ba0--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/delete_schedule_response.py@@ -0,0 +1,17 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+++class DeleteScheduleResponse(UncheckedBaseModel):+ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/dynamic_sub_agents_config.py b/python/trueforge_sdk/src/trueforge_sdk/types/dynamic_sub_agents_config.pynew file mode 100644index 000000000..b9ebd811b--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/dynamic_sub_agents_config.py@@ -0,0 +1,22 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+++class DynamicSubAgentsConfig(UncheckedBaseModel):+ enabled: typing.Optional[bool] = pydantic.Field(default=True)+ """+ Allow the agent to spawn dynamic subagents. Default: true.+ """++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/extended_chunk_delta_tool_call.py b/python/trueforge_sdk/src/trueforge_sdk/types/extended_chunk_delta_tool_call.pynew file mode 100644index 000000000..fc97369f6--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/extended_chunk_delta_tool_call.py@@ -0,0 +1,21 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from .chat_completion_chunk_delta_tool_call import ChatCompletionChunkDeltaToolCall+from .tool_info import ToolInfo+++class ExtendedChunkDeltaToolCall(ChatCompletionChunkDeltaToolCall):+ provider_specific_fields: typing.Optional[typing.Dict[str, typing.Any]] = None+ tool_info: typing.Optional[ToolInfo] = None++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/file_content.py b/python/trueforge_sdk/src/trueforge_sdk/types/file_content.pynew file mode 100644index 000000000..8de0e328f--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/file_content.py@@ -0,0 +1,29 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+++class FileContent(UncheckedBaseModel):+ data: str = pydantic.Field()+ """+ Data URI: `data:<mime>;base64,<payload>`. MIME type is parsed from the URI.+ """++ name: str = pydantic.Field()+ """+ Filename presented to the agent.+ """++ type: typing.Literal["file"] = "file"++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/finish_reason.py b/python/trueforge_sdk/src/trueforge_sdk/types/finish_reason.pynew file mode 100644index 000000000..1f82f503b--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/finish_reason.py@@ -0,0 +1,50 @@+# This file was auto-generated by Fern from our API Definition.++import typing++from ..core import enum++T_Result = typing.TypeVar("T_Result")+++class FinishReason(enum.StrEnum):+ """+ Why the model stopped generating.+ """++ STOP = "stop"+ LENGTH = "length"+ TOOL_CALLS = "tool_calls"+ CONTENT_FILTER = "content_filter"+ FUNCTION_CALL = "function_call"+ _UNKNOWN = "__FINISHREASON_UNKNOWN__"+ """+ This member is used for forward compatibility. If the value is not recognized by the enum, it will be stored here, and the raw value is accessible through `.value`.+ """++ @classmethod+ def _missing_(cls, value: typing.Any) -> "FinishReason":+ unknown = cls._UNKNOWN+ unknown._value_ = value+ return unknown++ def visit(+ self,+ stop: typing.Callable[[], T_Result],+ length: typing.Callable[[], T_Result],+ tool_calls: typing.Callable[[], T_Result],+ content_filter: typing.Callable[[], T_Result],+ function_call: typing.Callable[[], T_Result],+ _unknown_member: typing.Callable[[str], T_Result],+ ) -> T_Result:+ if self is FinishReason.STOP:+ return stop()+ if self is FinishReason.LENGTH:+ return length()+ if self is FinishReason.TOOL_CALLS:+ return tool_calls()+ if self is FinishReason.CONTENT_FILTER:+ return content_filter()+ if self is FinishReason.FUNCTION_CALL:+ return function_call()+ return _unknown_member(self._value_)diff --git a/python/trueforge_sdk/src/trueforge_sdk/types/fireworks_model_provider.py b/python/trueforge_sdk/src/trueforge_sdk/types/fireworks_model_provider.pynew file mode 100644index 000000000..19d5f71b8--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/fireworks_model_provider.py@@ -0,0 +1,32 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .configured_model import ConfiguredModel+from .model_provider_auth import ModelProviderAuth+++class FireworksModelProvider(UncheckedBaseModel):+ auth: ModelProviderAuth+ base_url: typing.Optional[str] = pydantic.Field(default="https://api.fireworks.ai/inference/v1")+ """+ Override of the provider's default API base URL.+ """++ models: typing.List[ConfiguredModel] = pydantic.Field()+ """+ Models exposed by this provider (at least one).+ """++ type: typing.Literal["fireworks"] = "fireworks"++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/generative_ui_config.py b/python/trueforge_sdk/src/trueforge_sdk/types/generative_ui_config.pynew file mode 100644index 000000000..9ba42eeb7--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/generative_ui_config.py@@ -0,0 +1,22 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+++class GenerativeUiConfig(UncheckedBaseModel):+ enabled: typing.Optional[bool] = pydantic.Field(default=True)+ """+ Enable Generative UI (OpenUI blocks). Default: true.+ """++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/get_agent_code_snippets_response.py b/python/trueforge_sdk/src/trueforge_sdk/types/get_agent_code_snippets_response.pynew file mode 100644index 000000000..e9769c091--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/get_agent_code_snippets_response.py@@ -0,0 +1,20 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .agent_code_snippets import AgentCodeSnippets+++class GetAgentCodeSnippetsResponse(UncheckedBaseModel):+ data: AgentCodeSnippets++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/get_agent_response.py b/python/trueforge_sdk/src/trueforge_sdk/types/get_agent_response.pynew file mode 100644index 000000000..cace76ab4--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/get_agent_response.py@@ -0,0 +1,20 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .agent import Agent+++class GetAgentResponse(UncheckedBaseModel):+ data: Agent++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/get_available_mcp_server_response.py b/python/trueforge_sdk/src/trueforge_sdk/types/get_available_mcp_server_response.pynew file mode 100644index 000000000..07641eef3--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/get_available_mcp_server_response.py@@ -0,0 +1,20 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .available_mcp_server import AvailableMcpServer+++class GetAvailableMcpServerResponse(UncheckedBaseModel):+ data: AvailableMcpServer++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/get_capabilities_response.py b/python/trueforge_sdk/src/trueforge_sdk/types/get_capabilities_response.pynew file mode 100644index 000000000..7f55ca553--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/get_capabilities_response.py@@ -0,0 +1,20 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .capabilities_data import CapabilitiesData+++class GetCapabilitiesResponse(UncheckedBaseModel):+ data: CapabilitiesData++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/get_mcp_server_catalog_response.py b/python/trueforge_sdk/src/trueforge_sdk/types/get_mcp_server_catalog_response.pynew file mode 100644index 000000000..b15a252b1--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/get_mcp_server_catalog_response.py@@ -0,0 +1,20 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .catalog_mcp_server import CatalogMcpServer+++class GetMcpServerCatalogResponse(UncheckedBaseModel):+ data: typing.List[CatalogMcpServer]++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/get_mcp_server_response.py b/python/trueforge_sdk/src/trueforge_sdk/types/get_mcp_server_response.pynew file mode 100644index 000000000..12dbd4916--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/get_mcp_server_response.py@@ -0,0 +1,20 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .configured_mcp_server import ConfiguredMcpServer+++class GetMcpServerResponse(UncheckedBaseModel):+ data: ConfiguredMcpServer++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/get_me_response.py b/python/trueforge_sdk/src/trueforge_sdk/types/get_me_response.pynew file mode 100644index 000000000..34b34231d--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/get_me_response.py@@ -0,0 +1,20 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .me import Me+++class GetMeResponse(UncheckedBaseModel):+ data: Me++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/get_me_subject.py b/python/trueforge_sdk/src/trueforge_sdk/types/get_me_subject.pynew file mode 100644index 000000000..27c787b84--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/get_me_subject.py@@ -0,0 +1,32 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+++class GetMeSubject(UncheckedBaseModel):+ display_name: str = pydantic.Field()+ """+ Human-readable name for the caller.+ """++ id: str = pydantic.Field()+ """+ Stable subject identifier for the caller.+ """++ type: str = pydantic.Field()+ """+ Subject kind as returned by the identity provider (stored as-is).+ """++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/get_model_provider_catalog_response.py b/python/trueforge_sdk/src/trueforge_sdk/types/get_model_provider_catalog_response.pynew file mode 100644index 000000000..752ce7eeb--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/get_model_provider_catalog_response.py@@ -0,0 +1,20 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .catalog_model_provider import CatalogModelProvider+++class GetModelProviderCatalogResponse(UncheckedBaseModel):+ data: typing.List[CatalogModelProvider]++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/get_model_provider_response.py b/python/trueforge_sdk/src/trueforge_sdk/types/get_model_provider_response.pynew file mode 100644index 000000000..6384b96a0--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/get_model_provider_response.py@@ -0,0 +1,20 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .configured_model_provider import ConfiguredModelProvider+++class GetModelProviderResponse(UncheckedBaseModel):+ data: ConfiguredModelProvider++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/get_sandbox_provider_catalog_response.py b/python/trueforge_sdk/src/trueforge_sdk/types/get_sandbox_provider_catalog_response.pynew file mode 100644index 000000000..77bc66dd4--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/get_sandbox_provider_catalog_response.py@@ -0,0 +1,20 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .catalog_sandbox_provider import CatalogSandboxProvider+++class GetSandboxProviderCatalogResponse(UncheckedBaseModel):+ data: typing.List[CatalogSandboxProvider]++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/get_sandbox_provider_response.py b/python/trueforge_sdk/src/trueforge_sdk/types/get_sandbox_provider_response.pynew file mode 100644index 000000000..fc4dd2a53--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/get_sandbox_provider_response.py@@ -0,0 +1,20 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .configured_sandbox_provider import ConfiguredSandboxProvider+++class GetSandboxProviderResponse(UncheckedBaseModel):+ data: ConfiguredSandboxProvider++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/get_schedule_response.py b/python/trueforge_sdk/src/trueforge_sdk/types/get_schedule_response.pynew file mode 100644index 000000000..0b5bda555--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/get_schedule_response.py@@ -0,0 +1,20 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .schedule import Schedule+++class GetScheduleResponse(UncheckedBaseModel):+ data: Schedule++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/get_session_metrics_chart_data_response.py b/python/trueforge_sdk/src/trueforge_sdk/types/get_session_metrics_chart_data_response.pynew file mode 100644index 000000000..cb22d9e7c--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/get_session_metrics_chart_data_response.py@@ -0,0 +1,20 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .session_metrics_chart_data_response import SessionMetricsChartDataResponse+++class GetSessionMetricsChartDataResponse(UncheckedBaseModel):+ data: SessionMetricsChartDataResponse++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/get_session_metrics_chart_response.py b/python/trueforge_sdk/src/trueforge_sdk/types/get_session_metrics_chart_response.pynew file mode 100644index 000000000..63f5495c7--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/get_session_metrics_chart_response.py@@ -0,0 +1,20 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .session_metrics_chart_response import SessionMetricsChartResponse+++class GetSessionMetricsChartResponse(UncheckedBaseModel):+ data: SessionMetricsChartResponse++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/get_session_metrics_meter_response.py b/python/trueforge_sdk/src/trueforge_sdk/types/get_session_metrics_meter_response.pynew file mode 100644index 000000000..4c0e880c5--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/get_session_metrics_meter_response.py@@ -0,0 +1,20 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .session_metrics_meter_response import SessionMetricsMeterResponse+++class GetSessionMetricsMeterResponse(UncheckedBaseModel):+ data: SessionMetricsMeterResponse++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/get_session_response.py b/python/trueforge_sdk/src/trueforge_sdk/types/get_session_response.pynew file mode 100644index 000000000..0f3634b76--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/get_session_response.py@@ -0,0 +1,20 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .session import Session+++class GetSessionResponse(UncheckedBaseModel):+ data: Session++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/get_skill_catalog_response.py b/python/trueforge_sdk/src/trueforge_sdk/types/get_skill_catalog_response.pynew file mode 100644index 000000000..377a11282--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/get_skill_catalog_response.py@@ -0,0 +1,20 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .catalog_skill import CatalogSkill+++class GetSkillCatalogResponse(UncheckedBaseModel):+ data: typing.List[CatalogSkill]++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/get_skill_response.py b/python/trueforge_sdk/src/trueforge_sdk/types/get_skill_response.pynew file mode 100644index 000000000..b16f4c051--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/get_skill_response.py@@ -0,0 +1,20 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .configured_skill import ConfiguredSkill+++class GetSkillResponse(UncheckedBaseModel):+ data: ConfiguredSkill++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/get_turn_response.py b/python/trueforge_sdk/src/trueforge_sdk/types/get_turn_response.pynew file mode 100644index 000000000..3e7bd2a6b--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/get_turn_response.py@@ -0,0 +1,20 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .turn import Turn+++class GetTurnResponse(UncheckedBaseModel):+ data: Turn++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/git_skill.py b/python/trueforge_sdk/src/trueforge_sdk/types/git_skill.pynew file mode 100644index 000000000..e80b39eff--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/git_skill.py@@ -0,0 +1,40 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .resource_name import ResourceName+++class GitSkill(UncheckedBaseModel):+ description: str = pydantic.Field()+ """+ Concise guidance for when the agent should use the skill.+ """++ name: ResourceName+ path: typing.Optional[str] = pydantic.Field(default=None)+ """+ Path to the skill directory within the repository. Omit to use the repository root.+ """++ ref: str = pydantic.Field()+ """+ Git ref — branch name, tag, or commit SHA.+ """++ type: typing.Literal["git"] = "git"+ url: str = pydantic.Field()+ """+ Full HTTPS URL of a GitHub or GitLab repository.+ """++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/google_gemini_model_provider.py b/python/trueforge_sdk/src/trueforge_sdk/types/google_gemini_model_provider.pynew file mode 100644index 000000000..77e9b8e45--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/google_gemini_model_provider.py@@ -0,0 +1,32 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .configured_model import ConfiguredModel+from .model_provider_auth import ModelProviderAuth+++class GoogleGeminiModelProvider(UncheckedBaseModel):+ auth: ModelProviderAuth+ base_url: typing.Optional[str] = pydantic.Field(default="https://generativelanguage.googleapis.com/v1beta")+ """+ Override of the provider's default API base URL.+ """++ models: typing.List[ConfiguredModel] = pydantic.Field()+ """+ Models exposed by this provider (at least one).+ """++ type: typing.Literal["google-gemini"] = "google-gemini"++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/initial_user_message.py b/python/trueforge_sdk/src/trueforge_sdk/types/initial_user_message.pynew file mode 100644index 000000000..42cd5a52b--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/initial_user_message.py@@ -0,0 +1,27 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+++class InitialUserMessage(UncheckedBaseModel):+ content: str = pydantic.Field()+ """+ Initial user message content injected at the start of every session.+ """++ type: typing.Literal["user.message"] = pydantic.Field(default="user.message")+ """+ Initial message type.+ """++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/input_tokens_compaction_trigger.py b/python/trueforge_sdk/src/trueforge_sdk/types/input_tokens_compaction_trigger.pynew file mode 100644index 000000000..ccde99a00--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/input_tokens_compaction_trigger.py@@ -0,0 +1,27 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+++class InputTokensCompactionTrigger(UncheckedBaseModel):+ type: typing.Literal["input_tokens"] = pydantic.Field(default="input_tokens")+ """+ Trigger compaction when the estimated input reaches a token limit.+ """++ value: int = pydantic.Field()+ """+ Estimated input-token count that triggers compaction.+ """++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/large_tool_response_config.py b/python/trueforge_sdk/src/trueforge_sdk/types/large_tool_response_config.pynew file mode 100644index 000000000..3ac829894--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/large_tool_response_config.py@@ -0,0 +1,22 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+++class LargeToolResponseConfig(UncheckedBaseModel):+ enabled: typing.Optional[bool] = pydantic.Field(default=True)+ """+ Offload oversized tool responses to a sandbox file. Default: true.+ """++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/list_agents_response.py b/python/trueforge_sdk/src/trueforge_sdk/types/list_agents_response.pynew file mode 100644index 000000000..b91c0ba7f--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/list_agents_response.py@@ -0,0 +1,22 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .agent import Agent+from .token_pagination import TokenPagination+++class ListAgentsResponse(UncheckedBaseModel):+ data: typing.List[Agent]+ pagination: TokenPagination++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/list_available_mcp_servers_response.py b/python/trueforge_sdk/src/trueforge_sdk/types/list_available_mcp_servers_response.pynew file mode 100644index 000000000..4ef79c365--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/list_available_mcp_servers_response.py@@ -0,0 +1,20 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .available_mcp_server import AvailableMcpServer+++class ListAvailableMcpServersResponse(UncheckedBaseModel):+ data: typing.List[AvailableMcpServer]++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/list_available_models_response.py b/python/trueforge_sdk/src/trueforge_sdk/types/list_available_models_response.pynew file mode 100644index 000000000..bd7a74bc2--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/list_available_models_response.py@@ -0,0 +1,20 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .available_model import AvailableModel+++class ListAvailableModelsResponse(UncheckedBaseModel):+ data: typing.List[AvailableModel]++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/list_available_skills_response.py b/python/trueforge_sdk/src/trueforge_sdk/types/list_available_skills_response.pynew file mode 100644index 000000000..68d0dd77b--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/list_available_skills_response.py@@ -0,0 +1,20 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .available_skill import AvailableSkill+++class ListAvailableSkillsResponse(UncheckedBaseModel):+ data: typing.List[AvailableSkill]++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/list_mcp_server_tools_response.py b/python/trueforge_sdk/src/trueforge_sdk/types/list_mcp_server_tools_response.pynew file mode 100644index 000000000..231ff6f91--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/list_mcp_server_tools_response.py@@ -0,0 +1,22 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+++class ListMcpServerToolsResponse(UncheckedBaseModel):+ data: typing.List[typing.Dict[str, typing.Any]] = pydantic.Field()+ """+ MCP `tools/list` entries, passed through verbatim from the MCP server.+ """++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/list_mcp_servers_response.py b/python/trueforge_sdk/src/trueforge_sdk/types/list_mcp_servers_response.pynew file mode 100644index 000000000..2f94a8c3b--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/list_mcp_servers_response.py@@ -0,0 +1,20 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .configured_mcp_server import ConfiguredMcpServer+++class ListMcpServersResponse(UncheckedBaseModel):+ data: typing.List[ConfiguredMcpServer]++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/list_model_providers_response.py b/python/trueforge_sdk/src/trueforge_sdk/types/list_model_providers_response.pynew file mode 100644index 000000000..290608443--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/list_model_providers_response.py@@ -0,0 +1,20 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .configured_model_provider import ConfiguredModelProvider+++class ListModelProvidersResponse(UncheckedBaseModel):+ data: typing.List[ConfiguredModelProvider]++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/list_permissions_response.py b/python/trueforge_sdk/src/trueforge_sdk/types/list_permissions_response.pynew file mode 100644index 000000000..8ea35697b--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/list_permissions_response.py@@ -0,0 +1,23 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .resource_permission import ResourcePermission+++class ListPermissionsResponse(UncheckedBaseModel):+ data: typing.Dict[str, typing.List[ResourcePermission]] = pydantic.Field()+ """+ Permissions granted to the caller, keyed by resource id. Missing or inaccessible ids are `[]`.+ """++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/list_schedule_runs_response.py b/python/trueforge_sdk/src/trueforge_sdk/types/list_schedule_runs_response.pynew file mode 100644index 000000000..2a725cbe7--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/list_schedule_runs_response.py@@ -0,0 +1,22 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .schedule_run import ScheduleRun+from .token_pagination import TokenPagination+++class ListScheduleRunsResponse(UncheckedBaseModel):+ data: typing.List[ScheduleRun]+ pagination: TokenPagination++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/list_schedules_response.py b/python/trueforge_sdk/src/trueforge_sdk/types/list_schedules_response.pynew file mode 100644index 000000000..ab72ca007--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/list_schedules_response.py@@ -0,0 +1,22 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .schedule import Schedule+from .token_pagination import TokenPagination+++class ListSchedulesResponse(UncheckedBaseModel):+ data: typing.List[Schedule]+ pagination: TokenPagination++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/list_session_events_response.py b/python/trueforge_sdk/src/trueforge_sdk/types/list_session_events_response.pynew file mode 100644index 000000000..feba77e3d--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/list_session_events_response.py@@ -0,0 +1,22 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .session_event_item import SessionEventItem+from .token_pagination import TokenPagination+++class ListSessionEventsResponse(UncheckedBaseModel):+ data: typing.List[SessionEventItem]+ pagination: TokenPagination++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/list_sessions_order.py b/python/trueforge_sdk/src/trueforge_sdk/types/list_sessions_order.pynew file mode 100644index 000000000..07a01f4e9--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/list_sessions_order.py@@ -0,0 +1,38 @@+# This file was auto-generated by Fern from our API Definition.++import typing++from ..core import enum++T_Result = typing.TypeVar("T_Result")+++class ListSessionsOrder(enum.StrEnum):+ """+ Sort sessions by `updated_at`. Defaults to "desc".+ """++ ASC = "asc"+ DESC = "desc"+ _UNKNOWN = "__LISTSESSIONSORDER_UNKNOWN__"+ """+ This member is used for forward compatibility. If the value is not recognized by the enum, it will be stored here, and the raw value is accessible through `.value`.+ """++ @classmethod+ def _missing_(cls, value: typing.Any) -> "ListSessionsOrder":+ unknown = cls._UNKNOWN+ unknown._value_ = value+ return unknown++ def visit(+ self,+ asc: typing.Callable[[], T_Result],+ desc: typing.Callable[[], T_Result],+ _unknown_member: typing.Callable[[str], T_Result],+ ) -> T_Result:+ if self is ListSessionsOrder.ASC:+ return asc()+ if self is ListSessionsOrder.DESC:+ return desc()+ return _unknown_member(self._value_)diff --git a/python/trueforge_sdk/src/trueforge_sdk/types/list_sessions_response.py b/python/trueforge_sdk/src/trueforge_sdk/types/list_sessions_response.pynew file mode 100644index 000000000..7c42e0f93--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/list_sessions_response.py@@ -0,0 +1,22 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .session import Session+from .token_pagination import TokenPagination+++class ListSessionsResponse(UncheckedBaseModel):+ data: typing.List[Session]+ pagination: TokenPagination++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/list_skill_versions_response.py b/python/trueforge_sdk/src/trueforge_sdk/types/list_skill_versions_response.pynew file mode 100644index 000000000..87c3be46f--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/list_skill_versions_response.py@@ -0,0 +1,20 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .skill_version import SkillVersion+++class ListSkillVersionsResponse(UncheckedBaseModel):+ data: typing.List[SkillVersion]++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/list_skills_response.py b/python/trueforge_sdk/src/trueforge_sdk/types/list_skills_response.pynew file mode 100644index 000000000..17c09063d--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/list_skills_response.py@@ -0,0 +1,20 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .configured_skill import ConfiguredSkill+++class ListSkillsResponse(UncheckedBaseModel):+ data: typing.List[ConfiguredSkill]++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/list_turn_events_order.py b/python/trueforge_sdk/src/trueforge_sdk/types/list_turn_events_order.pynew file mode 100644index 000000000..8adb478ea--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/list_turn_events_order.py@@ -0,0 +1,38 @@+# This file was auto-generated by Fern from our API Definition.++import typing++from ..core import enum++T_Result = typing.TypeVar("T_Result")+++class ListTurnEventsOrder(enum.StrEnum):+ """+ Sort events by insertion order. Defaults to "asc".+ """++ ASC = "asc"+ DESC = "desc"+ _UNKNOWN = "__LISTTURNEVENTSORDER_UNKNOWN__"+ """+ This member is used for forward compatibility. If the value is not recognized by the enum, it will be stored here, and the raw value is accessible through `.value`.+ """++ @classmethod+ def _missing_(cls, value: typing.Any) -> "ListTurnEventsOrder":+ unknown = cls._UNKNOWN+ unknown._value_ = value+ return unknown++ def visit(+ self,+ asc: typing.Callable[[], T_Result],+ desc: typing.Callable[[], T_Result],+ _unknown_member: typing.Callable[[str], T_Result],+ ) -> T_Result:+ if self is ListTurnEventsOrder.ASC:+ return asc()+ if self is ListTurnEventsOrder.DESC:+ return desc()+ return _unknown_member(self._value_)diff --git a/python/trueforge_sdk/src/trueforge_sdk/types/list_turn_events_response.py b/python/trueforge_sdk/src/trueforge_sdk/types/list_turn_events_response.pynew file mode 100644index 000000000..a4fe277c4--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/list_turn_events_response.py@@ -0,0 +1,22 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .session_event import SessionEvent+from .token_pagination import TokenPagination+++class ListTurnEventsResponse(UncheckedBaseModel):+ data: typing.List[SessionEvent]+ pagination: TokenPagination++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/list_turns_response.py b/python/trueforge_sdk/src/trueforge_sdk/types/list_turns_response.pynew file mode 100644index 000000000..96783f66f--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/list_turns_response.py@@ -0,0 +1,22 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .token_pagination import TokenPagination+from .turn import Turn+++class ListTurnsResponse(UncheckedBaseModel):+ data: typing.List[Turn]+ pagination: TokenPagination++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/mcp_auth_required_event.py b/python/trueforge_sdk/src/trueforge_sdk/types/mcp_auth_required_event.pynew file mode 100644index 000000000..6fca68ed3--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/mcp_auth_required_event.py@@ -0,0 +1,25 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from .base_mcp_auth_required_event import BaseMcpAuthRequiredEvent+from .mcp_server_auth_info import McpServerAuthInfo+++class McpAuthRequiredEvent(BaseMcpAuthRequiredEvent):+ mcp_servers: typing.List[McpServerAuthInfo] = pydantic.Field()+ """+ Servers that need authorization, each with an auth_url.+ """++ type: typing.Literal["mcp.auth_required"] = "mcp.auth_required"++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/mcp_auth_status.py b/python/trueforge_sdk/src/trueforge_sdk/types/mcp_auth_status.pynew file mode 100644index 000000000..1289afc42--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/mcp_auth_status.py@@ -0,0 +1,32 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .mcp_auth_status_status import McpAuthStatusStatus+++class McpAuthStatus(UncheckedBaseModel):+ """+ Current auth state.+ """++ authorization_url: typing.Optional[str] = pydantic.Field(default=None)+ """+ When auth is required, this contains the URL to redirect the user to for authorization.+ """++ status: McpAuthStatusStatus = pydantic.Field()+ """+ Current auth state for this MCP server.+ """++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/mcp_auth_status_status.py b/python/trueforge_sdk/src/trueforge_sdk/types/mcp_auth_status_status.pynew file mode 100644index 000000000..4660723d0--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/mcp_auth_status_status.py@@ -0,0 +1,42 @@+# This file was auto-generated by Fern from our API Definition.++import typing++from ..core import enum++T_Result = typing.TypeVar("T_Result")+++class McpAuthStatusStatus(enum.StrEnum):+ """+ Current auth state for this MCP server.+ """++ AUTHENTICATED = "authenticated"+ AUTH_REQUIRED = "auth_required"+ NOT_REQUIRED = "not_required"+ _UNKNOWN = "__MCPAUTHSTATUSSTATUS_UNKNOWN__"+ """+ This member is used for forward compatibility. If the value is not recognized by the enum, it will be stored here, and the raw value is accessible through `.value`.+ """++ @classmethod+ def _missing_(cls, value: typing.Any) -> "McpAuthStatusStatus":+ unknown = cls._UNKNOWN+ unknown._value_ = value+ return unknown++ def visit(+ self,+ authenticated: typing.Callable[[], T_Result],+ auth_required: typing.Callable[[], T_Result],+ not_required: typing.Callable[[], T_Result],+ _unknown_member: typing.Callable[[str], T_Result],+ ) -> T_Result:+ if self is McpAuthStatusStatus.AUTHENTICATED:+ return authenticated()+ if self is McpAuthStatusStatus.AUTH_REQUIRED:+ return auth_required()+ if self is McpAuthStatusStatus.NOT_REQUIRED:+ return not_required()+ return _unknown_member(self._value_)diff --git a/python/trueforge_sdk/src/trueforge_sdk/types/mcp_initialize_event.py b/python/trueforge_sdk/src/trueforge_sdk/types/mcp_initialize_event.pynew file mode 100644index 000000000..f267baf4e--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/mcp_initialize_event.py@@ -0,0 +1,40 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .mcp_server_init_info import McpServerInitInfo+++class McpInitializeEvent(UncheckedBaseModel):+ created_at: str = pydantic.Field()+ """+ ISO 8601 event timestamp.+ """++ id: str = pydantic.Field()+ """+ Unique identifier for the event (monotonic ULID).+ """++ mcp_servers: typing.List[McpServerInitInfo] = pydantic.Field()+ """+ Servers that were initialized.+ """++ thread_id: str = pydantic.Field()+ """+ Thread that triggered initialization.+ """++ type: typing.Literal["mcp.initialize"] = "mcp.initialize"++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/mcp_server.py b/python/trueforge_sdk/src/trueforge_sdk/types/mcp_server.pynew file mode 100644index 000000000..539a3ca52--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/mcp_server.py@@ -0,0 +1,51 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .mcp_server_approval_tool_selector import McpServerApprovalToolSelector+from .mcp_server_tool_selector import McpServerToolSelector+++class McpServer(UncheckedBaseModel):+ disable_tools: typing.Optional[typing.List[McpServerToolSelector]] = pydantic.Field(default=None)+ """+ Tools subtracted from the enabled set. Default: none.+ """++ enable_tools: typing.Optional[typing.List[McpServerToolSelector]] = pydantic.Field(default=None)+ """+ Tools exposed to the agent: `@all`, `@read-only`, or literal tool names. Default: `["@all"]`.+ """++ name: str = pydantic.Field()+ """+ Name of a configured MCP server (Settings → Connectors).+ """++ preload: typing.Optional[bool] = pydantic.Field(default=False)+ """+ When true, load all tool schemas upfront. Default: false (deferred discovery).+ """++ preload_tools: typing.Optional[typing.List[McpServerToolSelector]] = pydantic.Field(default=None)+ """+ Tools loaded eagerly into context while the rest stay deferred. A non-empty list implies `preload: false`.+ """++ require_approval_for_tools: typing.Optional[typing.List[McpServerApprovalToolSelector]] = pydantic.Field(+ default=None+ )+ """+ Tools that pause for human approval: `@all`, `@write`, `@destructive`, or literal names. Default: `["@write", "@destructive"]`.+ """++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/mcp_server_approval_tool_selector.py b/python/trueforge_sdk/src/trueforge_sdk/types/mcp_server_approval_tool_selector.pynew file mode 100644index 000000000..8fa73f111--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/mcp_server_approval_tool_selector.py@@ -0,0 +1,7 @@+# This file was auto-generated by Fern from our API Definition.++import typing++McpServerApprovalToolSelector = typing.Union[+ typing.Literal["@all"], typing.Literal["@write"], typing.Literal["@destructive"], str+]diff --git a/python/trueforge_sdk/src/trueforge_sdk/types/mcp_server_auth_info.py b/python/trueforge_sdk/src/trueforge_sdk/types/mcp_server_auth_info.pynew file mode 100644index 000000000..0efcb0dd3--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/mcp_server_auth_info.py@@ -0,0 +1,32 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+++class McpServerAuthInfo(UncheckedBaseModel):+ auth_url: str = pydantic.Field()+ """+ URL the user must visit to complete OAuth for this server.+ """++ id: str = pydantic.Field()+ """+ Internal MCP server id.+ """++ name: str = pydantic.Field()+ """+ Configured MCP server name.+ """++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/mcp_server_auth_public.py b/python/trueforge_sdk/src/trueforge_sdk/types/mcp_server_auth_public.pynew file mode 100644index 000000000..3f4d2e719--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/mcp_server_auth_public.py@@ -0,0 +1,8 @@+# This file was auto-generated by Fern from our API Definition.++import typing++from .mcp_server_auth_public_one import McpServerAuthPublicOne+from .mcp_server_auth_public_zero import McpServerAuthPublicZero++McpServerAuthPublic = typing.Union[McpServerAuthPublicZero, McpServerAuthPublicOne]diff --git a/python/trueforge_sdk/src/trueforge_sdk/types/mcp_server_auth_public_one.py b/python/trueforge_sdk/src/trueforge_sdk/types/mcp_server_auth_public_one.pynew file mode 100644index 000000000..b8fd1a1c8--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/mcp_server_auth_public_one.py@@ -0,0 +1,19 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+++class McpServerAuthPublicOne(UncheckedBaseModel):+ type: typing.Literal["header"] = "header"++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/mcp_server_auth_public_zero.py b/python/trueforge_sdk/src/trueforge_sdk/types/mcp_server_auth_public_zero.pynew file mode 100644index 000000000..0b9ff1ed8--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/mcp_server_auth_public_zero.py@@ -0,0 +1,19 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+++class McpServerAuthPublicZero(UncheckedBaseModel):+ type: typing.Literal["dcr"] = "dcr"++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/mcp_server_dcr_auth.py b/python/trueforge_sdk/src/trueforge_sdk/types/mcp_server_dcr_auth.pynew file mode 100644index 000000000..5b94b8168--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/mcp_server_dcr_auth.py@@ -0,0 +1,19 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+++class McpServerDcrAuth(UncheckedBaseModel):+ type: typing.Literal["dcr"] = "dcr"++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/mcp_server_header_auth.py b/python/trueforge_sdk/src/trueforge_sdk/types/mcp_server_header_auth.pynew file mode 100644index 000000000..54596c094--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/mcp_server_header_auth.py@@ -0,0 +1,24 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+++class McpServerHeaderAuth(UncheckedBaseModel):+ headers: typing.Dict[str, str] = pydantic.Field()+ """+ Request headers for this MCP server. Responses are redacted; on PUT, a real value sets/rotates and a redacted value keeps the stored secret for that header name.+ """++ type: typing.Literal["header"] = "header"++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/mcp_server_init_info.py b/python/trueforge_sdk/src/trueforge_sdk/types/mcp_server_init_info.pynew file mode 100644index 000000000..74bb464f2--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/mcp_server_init_info.py@@ -0,0 +1,38 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .mcp_server_init_info_transport_type import McpServerInitInfoTransportType+++class McpServerInitInfo(UncheckedBaseModel):+ id: str = pydantic.Field()+ """+ Internal MCP server id.+ """++ name: str = pydantic.Field()+ """+ Configured MCP server name.+ """++ session_id: typing.Optional[str] = pydantic.Field(default=None)+ """+ Optional MCP session id from the transport.+ """++ transport_type: typing.Optional[McpServerInitInfoTransportType] = pydantic.Field(default=None)+ """+ Transport used to connect to the MCP server.+ """++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/mcp_server_init_info_transport_type.py b/python/trueforge_sdk/src/trueforge_sdk/types/mcp_server_init_info_transport_type.pynew file mode 100644index 000000000..8184a8135--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/mcp_server_init_info_transport_type.py@@ -0,0 +1,38 @@+# This file was auto-generated by Fern from our API Definition.++import typing++from ..core import enum++T_Result = typing.TypeVar("T_Result")+++class McpServerInitInfoTransportType(enum.StrEnum):+ """+ Transport used to connect to the MCP server.+ """++ STREAMABLE_HTTP = "streamable-http"+ SSE = "sse"+ _UNKNOWN = "__MCPSERVERINITINFOTRANSPORTTYPE_UNKNOWN__"+ """+ This member is used for forward compatibility. If the value is not recognized by the enum, it will be stored here, and the raw value is accessible through `.value`.+ """++ @classmethod+ def _missing_(cls, value: typing.Any) -> "McpServerInitInfoTransportType":+ unknown = cls._UNKNOWN+ unknown._value_ = value+ return unknown++ def visit(+ self,+ streamable_http: typing.Callable[[], T_Result],+ sse: typing.Callable[[], T_Result],+ _unknown_member: typing.Callable[[str], T_Result],+ ) -> T_Result:+ if self is McpServerInitInfoTransportType.STREAMABLE_HTTP:+ return streamable_http()+ if self is McpServerInitInfoTransportType.SSE:+ return sse()+ return _unknown_member(self._value_)diff --git a/python/trueforge_sdk/src/trueforge_sdk/types/mcp_server_manifest.py b/python/trueforge_sdk/src/trueforge_sdk/types/mcp_server_manifest.pynew file mode 100644index 000000000..e6dd6affa--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/mcp_server_manifest.py@@ -0,0 +1,8 @@+# This file was auto-generated by Fern from our API Definition.++import typing++from .remote_mcp_server_manifest import RemoteMcpServerManifest+from .true_foundry_mcp_server_manifest import TrueFoundryMcpServerManifest++McpServerManifest = typing.Union[RemoteMcpServerManifest, TrueFoundryMcpServerManifest]diff --git a/python/trueforge_sdk/src/trueforge_sdk/types/mcp_server_manifest_auth.py b/python/trueforge_sdk/src/trueforge_sdk/types/mcp_server_manifest_auth.pynew file mode 100644index 000000000..547199de3--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/mcp_server_manifest_auth.py@@ -0,0 +1,8 @@+# This file was auto-generated by Fern from our API Definition.++import typing++from .mcp_server_dcr_auth import McpServerDcrAuth+from .mcp_server_header_auth import McpServerHeaderAuth++McpServerManifestAuth = typing.Union[McpServerDcrAuth, McpServerHeaderAuth]diff --git a/python/trueforge_sdk/src/trueforge_sdk/types/mcp_server_tool_selector.py b/python/trueforge_sdk/src/trueforge_sdk/types/mcp_server_tool_selector.pynew file mode 100644index 000000000..66d29937d--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/mcp_server_tool_selector.py@@ -0,0 +1,5 @@+# This file was auto-generated by Fern from our API Definition.++import typing++McpServerToolSelector = typing.Union[typing.Literal["@all"], typing.Literal["@read-only"], str]diff --git a/python/trueforge_sdk/src/trueforge_sdk/types/mcp_tool_info.py b/python/trueforge_sdk/src/trueforge_sdk/types/mcp_tool_info.pynew file mode 100644index 000000000..357efa106--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/mcp_tool_info.py@@ -0,0 +1,34 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+++class McpToolInfo(UncheckedBaseModel):+ name: str = pydantic.Field()+ """+ Tool name on the MCP server.+ """++ server_id: str = pydantic.Field()+ """+ Internal MCP server id.+ """++ server_name: str = pydantic.Field()+ """+ Configured MCP server name.+ """++ type: typing.Literal["mcp"] = "mcp"++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/me.py b/python/trueforge_sdk/src/trueforge_sdk/types/me.pynew file mode 100644index 000000000..20bb6c71f--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/me.py@@ -0,0 +1,32 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .get_me_subject import GetMeSubject+from .me_session_type import MeSessionType+++class Me(UncheckedBaseModel):+ roles: typing.List[str] = pydantic.Field()+ """+ Roles for the authenticated caller.+ """++ subject: GetMeSubject+ tenant_id: str = pydantic.Field()+ """+ Tenant scope for the authenticated caller.+ """++ type: MeSessionType++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/me_session_type.py b/python/trueforge_sdk/src/trueforge_sdk/types/me_session_type.pynew file mode 100644index 000000000..ca59a6876--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/me_session_type.py@@ -0,0 +1,38 @@+# This file was auto-generated by Fern from our API Definition.++import typing++from ..core import enum++T_Result = typing.TypeVar("T_Result")+++class MeSessionType(enum.StrEnum):+ """+ `oidc-connected` when the process is running with browser OIDC login; `default` for standalone or TrueFoundry token auth.+ """++ DEFAULT = "default"+ OIDC_CONNECTED = "oidc-connected"+ _UNKNOWN = "__MESESSIONTYPE_UNKNOWN__"+ """+ This member is used for forward compatibility. If the value is not recognized by the enum, it will be stored here, and the raw value is accessible through `.value`.+ """++ @classmethod+ def _missing_(cls, value: typing.Any) -> "MeSessionType":+ unknown = cls._UNKNOWN+ unknown._value_ = value+ return unknown++ def visit(+ self,+ default: typing.Callable[[], T_Result],+ oidc_connected: typing.Callable[[], T_Result],+ _unknown_member: typing.Callable[[str], T_Result],+ ) -> T_Result:+ if self is MeSessionType.DEFAULT:+ return default()+ if self is MeSessionType.OIDC_CONNECTED:+ return oidc_connected()+ return _unknown_member(self._value_)diff --git a/python/trueforge_sdk/src/trueforge_sdk/types/metrics_unit.py b/python/trueforge_sdk/src/trueforge_sdk/types/metrics_unit.pynew file mode 100644index 000000000..b276ef35f--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/metrics_unit.py@@ -0,0 +1,38 @@+# This file was auto-generated by Fern from our API Definition.++import typing++from ..core import enum++T_Result = typing.TypeVar("T_Result")+++class MetricsUnit(enum.StrEnum):+ COUNT = "count"+ USD = "$"+ MS = "ms"+ _UNKNOWN = "__METRICSUNIT_UNKNOWN__"+ """+ This member is used for forward compatibility. If the value is not recognized by the enum, it will be stored here, and the raw value is accessible through `.value`.+ """++ @classmethod+ def _missing_(cls, value: typing.Any) -> "MetricsUnit":+ unknown = cls._UNKNOWN+ unknown._value_ = value+ return unknown++ def visit(+ self,+ count: typing.Callable[[], T_Result],+ usd: typing.Callable[[], T_Result],+ ms: typing.Callable[[], T_Result],+ _unknown_member: typing.Callable[[str], T_Result],+ ) -> T_Result:+ if self is MetricsUnit.COUNT:+ return count()+ if self is MetricsUnit.USD:+ return usd()+ if self is MetricsUnit.MS:+ return ms()+ return _unknown_member(self._value_)diff --git a/python/trueforge_sdk/src/trueforge_sdk/types/model.py b/python/trueforge_sdk/src/trueforge_sdk/types/model.pynew file mode 100644index 000000000..142153cb1--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/model.py@@ -0,0 +1,25 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .model_params import ModelParams+++class Model(UncheckedBaseModel):+ name: str = pydantic.Field()+ """+ Model FQN: `provider/model`, e.g. `openai/gpt-5.2`.+ """++ params: typing.Optional[ModelParams] = None++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/model_message_delta_event.py b/python/trueforge_sdk/src/trueforge_sdk/types/model_message_delta_event.pynew file mode 100644index 000000000..be220000e--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/model_message_delta_event.py@@ -0,0 +1,55 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .extended_chunk_delta_tool_call import ExtendedChunkDeltaToolCall+from .finish_reason import FinishReason+from .model_message_usage import ModelMessageUsage+++class ModelMessageDeltaEvent(UncheckedBaseModel):+ content: typing.Optional[str] = pydantic.Field(default=None)+ """+ Incremental assistant text content.+ """++ created_at: typing.Optional[str] = pydantic.Field(default=None)+ """+ Optional ISO 8601 event timestamp.+ """++ finish_reason: typing.Optional[FinishReason] = pydantic.Field(default=None)+ """+ Finish reason when this delta completes the stream.+ """++ id: str = pydantic.Field()+ """+ Unique identifier for the event (monotonic ULID).+ """++ reasoning_content: typing.Optional[str] = None+ refusal: typing.Optional[str] = pydantic.Field(default=None)+ """+ Incremental refusal text when present.+ """++ thread_id: str = pydantic.Field()+ """+ Thread that emitted this delta.+ """++ tool_calls: typing.Optional[typing.List[ExtendedChunkDeltaToolCall]] = None+ type: typing.Literal["model.message.delta"] = "model.message.delta"+ usage: typing.Optional[ModelMessageUsage] = None++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/model_message_event.py b/python/trueforge_sdk/src/trueforge_sdk/types/model_message_event.pynew file mode 100644index 000000000..e3b4157bf--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/model_message_event.py@@ -0,0 +1,61 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .finish_reason import FinishReason+from .model_message_event_content import ModelMessageEventContent+from .model_message_usage import ModelMessageUsage+from .tool_call import ToolCall+++class ModelMessageEvent(UncheckedBaseModel):+ content: typing.Optional[ModelMessageEventContent] = pydantic.Field(default=None)+ """+ Assistant message content as text or content parts.+ """++ created_at: str = pydantic.Field()+ """+ ISO 8601 event timestamp.+ """++ finish_reason: typing.Optional[FinishReason] = pydantic.Field(default=None)+ """+ Model finish reason; null when the provider omitted it.+ """++ id: str = pydantic.Field()+ """+ Unique identifier for the event (monotonic ULID).+ """++ name: typing.Optional[str] = pydantic.Field(default=None)+ """+ Optional participant name.+ """++ reasoning_content: typing.Optional[str] = None+ refusal: typing.Optional[str] = pydantic.Field(default=None)+ """+ Optional refusal text.+ """++ thread_id: str = pydantic.Field()+ """+ Thread that emitted this message (`main` for the root agent).+ """++ tool_calls: typing.Optional[typing.List[ToolCall]] = None+ type: typing.Literal["model.message"] = "model.message"+ usage: typing.Optional[ModelMessageUsage] = None++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/model_message_event_content.py b/python/trueforge_sdk/src/trueforge_sdk/types/model_message_event_content.pynew file mode 100644index 000000000..a374ec9d7--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/model_message_event_content.py@@ -0,0 +1,7 @@+# This file was auto-generated by Fern from our API Definition.++import typing++from .model_message_event_content_one_item import ModelMessageEventContentOneItem++ModelMessageEventContent = typing.Union[str, typing.List[ModelMessageEventContentOneItem]]diff --git a/python/trueforge_sdk/src/trueforge_sdk/types/model_message_event_content_one_item.py b/python/trueforge_sdk/src/trueforge_sdk/types/model_message_event_content_one_item.pynew file mode 100644index 000000000..9921ddec9--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/model_message_event_content_one_item.py@@ -0,0 +1,8 @@+# This file was auto-generated by Fern from our API Definition.++import typing++from .chat_completion_content_part_refusal import ChatCompletionContentPartRefusal+from .chat_completion_content_part_text import ChatCompletionContentPartText++ModelMessageEventContentOneItem = typing.Union[ChatCompletionContentPartText, ChatCompletionContentPartRefusal]diff --git a/python/trueforge_sdk/src/trueforge_sdk/types/model_message_usage.py b/python/trueforge_sdk/src/trueforge_sdk/types/model_message_usage.pynew file mode 100644index 000000000..3c7b40df9--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/model_message_usage.py@@ -0,0 +1,39 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .model_message_usage_input_tokens_breakdown import ModelMessageUsageInputTokensBreakdown+++class ModelMessageUsage(UncheckedBaseModel):+ cache_read_tokens: typing.Optional[int] = pydantic.Field(default=None)+ """+ Optional cache-read tokens.+ """++ cache_write_tokens: typing.Optional[int] = pydantic.Field(default=None)+ """+ Optional cache-write tokens.+ """++ input_tokens: int = pydantic.Field()+ """+ Input tokens for this model call.+ """++ input_tokens_breakdown: ModelMessageUsageInputTokensBreakdown+ output_tokens: int = pydantic.Field()+ """+ Output tokens for this model call.+ """++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/model_message_usage_input_tokens_breakdown.py b/python/trueforge_sdk/src/trueforge_sdk/types/model_message_usage_input_tokens_breakdown.pynew file mode 100644index 000000000..17c883f8d--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/model_message_usage_input_tokens_breakdown.py@@ -0,0 +1,42 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+++class ModelMessageUsageInputTokensBreakdown(UncheckedBaseModel):+ harness: int = pydantic.Field()+ """+ Tokens attributed to harness system framing.+ """++ instructions: int = pydantic.Field()+ """+ Tokens attributed to agent instructions.+ """++ messages: int = pydantic.Field()+ """+ Tokens attributed to conversation messages.+ """++ skills: int = pydantic.Field()+ """+ Tokens attributed to skill instructions.+ """++ tool_definitions: int = pydantic.Field()+ """+ Tokens attributed to tool schemas.+ """++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/model_params.py b/python/trueforge_sdk/src/trueforge_sdk/types/model_params.pynew file mode 100644index 000000000..b0b5a1c98--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/model_params.py@@ -0,0 +1,51 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+++class ModelParams(UncheckedBaseModel):+ """+ Model call parameters passed through to the provider. Known keys are documented; extra keys are allowed and forwarded as-is.+ """++ max_tokens: typing.Optional[float] = pydantic.Field(default=None)+ """+ Maximum tokens to generate in the model response.+ """++ parallel_tool_calls: typing.Optional[bool] = pydantic.Field(default=None)+ """+ Whether the model may emit multiple tool calls in one response.+ """++ reasoning_effort: typing.Optional[str] = pydantic.Field(default=None)+ """+ Provider-specific reasoning effort (e.g. low/medium/high).+ """++ temperature: typing.Optional[float] = pydantic.Field(default=None)+ """+ Sampling temperature; higher values increase randomness.+ """++ top_k: typing.Optional[float] = pydantic.Field(default=None)+ """+ Top-k sampling; keep only the k highest-probability tokens.+ """++ top_p: typing.Optional[float] = pydantic.Field(default=None)+ """+ Nucleus sampling probability mass.+ """++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/model_properties.py b/python/trueforge_sdk/src/trueforge_sdk/types/model_properties.pynew file mode 100644index 000000000..b3175a8e9--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/model_properties.py@@ -0,0 +1,37 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .reasoning_effort import ReasoningEffort+++class ModelProperties(UncheckedBaseModel):+ """+ Optional model capability metadata.+ """++ context_length: typing.Optional[int] = pydantic.Field(default=None)+ """+ Maximum context window size in tokens.+ """++ max_output_tokens: typing.Optional[int] = pydantic.Field(default=None)+ """+ Maximum output tokens the model can generate.+ """++ reasoning_efforts: typing.Optional[typing.List[ReasoningEffort]] = pydantic.Field(default=None)+ """+ Supported reasoning-effort values for this model.+ """++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/model_provider_auth.py b/python/trueforge_sdk/src/trueforge_sdk/types/model_provider_auth.pynew file mode 100644index 000000000..166460def--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/model_provider_auth.py@@ -0,0 +1,26 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+++class ModelProviderAuth(UncheckedBaseModel):+ """+ Provider authentication credentials.+ """++ api_key: str = pydantic.Field()+ """+ Provider API key. Responses are redacted; on PUT, a real value sets/rotates and a redacted value keeps the stored key.+ """++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/model_provider_manifest.py b/python/trueforge_sdk/src/trueforge_sdk/types/model_provider_manifest.pynew file mode 100644index 000000000..abfea71ae--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/model_provider_manifest.py@@ -0,0 +1,27 @@+# This file was auto-generated by Fern from our API Definition.++import typing++from .alibaba_model_provider import AlibabaModelProvider+from .anthropic_model_provider import AnthropicModelProvider+from .custom_model_provider import CustomModelProvider+from .fireworks_model_provider import FireworksModelProvider+from .google_gemini_model_provider import GoogleGeminiModelProvider+from .moonshot_model_provider import MoonshotModelProvider+from .open_ai_model_provider import OpenAiModelProvider+from .together_ai_model_provider import TogetherAiModelProvider+from .true_foundry_model_provider import TrueFoundryModelProvider+from .zai_model_provider import ZaiModelProvider++ModelProviderManifest = typing.Union[+ AlibabaModelProvider,+ AnthropicModelProvider,+ CustomModelProvider,+ FireworksModelProvider,+ GoogleGeminiModelProvider,+ MoonshotModelProvider,+ OpenAiModelProvider,+ TogetherAiModelProvider,+ TrueFoundryModelProvider,+ ZaiModelProvider,+]diff --git a/python/trueforge_sdk/src/trueforge_sdk/types/moonshot_model_provider.py b/python/trueforge_sdk/src/trueforge_sdk/types/moonshot_model_provider.pynew file mode 100644index 000000000..2f5b61ccd--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/moonshot_model_provider.py@@ -0,0 +1,32 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .configured_model import ConfiguredModel+from .model_provider_auth import ModelProviderAuth+++class MoonshotModelProvider(UncheckedBaseModel):+ auth: ModelProviderAuth+ base_url: typing.Optional[str] = pydantic.Field(default="https://api.moonshot.ai/v1")+ """+ Override of the provider's default API base URL.+ """++ models: typing.List[ConfiguredModel] = pydantic.Field()+ """+ Models exposed by this provider (at least one).+ """++ type: typing.Literal["moonshot"] = "moonshot"++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/open_ai_model_provider.py b/python/trueforge_sdk/src/trueforge_sdk/types/open_ai_model_provider.pynew file mode 100644index 000000000..b9d2d08aa--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/open_ai_model_provider.py@@ -0,0 +1,32 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .configured_model import ConfiguredModel+from .model_provider_auth import ModelProviderAuth+++class OpenAiModelProvider(UncheckedBaseModel):+ auth: ModelProviderAuth+ base_url: typing.Optional[str] = pydantic.Field(default="https://api.openai.com/v1")+ """+ Override of the provider's default API base URL.+ """++ models: typing.List[ConfiguredModel] = pydantic.Field()+ """+ Models exposed by this provider (at least one).+ """++ type: typing.Literal["openai"] = "openai"++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/permission_resource_type.py b/python/trueforge_sdk/src/trueforge_sdk/types/permission_resource_type.pynew file mode 100644index 000000000..59ca69be1--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/permission_resource_type.py@@ -0,0 +1,42 @@+# This file was auto-generated by Fern from our API Definition.++import typing++from ..core import enum++T_Result = typing.TypeVar("T_Result")+++class PermissionResourceType(enum.StrEnum):+ """+ Resource type to evaluate permissions for.+ """++ AGENT = "agent"+ SCHEDULE = "schedule"+ SESSION = "session"+ _UNKNOWN = "__PERMISSIONRESOURCETYPE_UNKNOWN__"+ """+ This member is used for forward compatibility. If the value is not recognized by the enum, it will be stored here, and the raw value is accessible through `.value`.+ """++ @classmethod+ def _missing_(cls, value: typing.Any) -> "PermissionResourceType":+ unknown = cls._UNKNOWN+ unknown._value_ = value+ return unknown++ def visit(+ self,+ agent: typing.Callable[[], T_Result],+ schedule: typing.Callable[[], T_Result],+ session: typing.Callable[[], T_Result],+ _unknown_member: typing.Callable[[str], T_Result],+ ) -> T_Result:+ if self is PermissionResourceType.AGENT:+ return agent()+ if self is PermissionResourceType.SCHEDULE:+ return schedule()+ if self is PermissionResourceType.SESSION:+ return session()+ return _unknown_member(self._value_)diff --git a/python/trueforge_sdk/src/trueforge_sdk/types/previous_turn_id_input.py b/python/trueforge_sdk/src/trueforge_sdk/types/previous_turn_id_input.pynew file mode 100644index 000000000..0e5f035f9--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/previous_turn_id_input.py@@ -0,0 +1,5 @@+# This file was auto-generated by Fern from our API Definition.++import typing++PreviousTurnIdInput = typing.Union[typing.Literal["auto"], typing.Literal["none"], str]diff --git a/python/trueforge_sdk/src/trueforge_sdk/types/raw_tool_call.py b/python/trueforge_sdk/src/trueforge_sdk/types/raw_tool_call.pynew file mode 100644index 000000000..baed6a381--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/raw_tool_call.py@@ -0,0 +1,19 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from .chat_completion_message_tool_call import ChatCompletionMessageToolCall+++class RawToolCall(ChatCompletionMessageToolCall):+ provider_specific_fields: typing.Optional[typing.Dict[str, typing.Any]] = None++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/reasoning_effort.py b/python/trueforge_sdk/src/trueforge_sdk/types/reasoning_effort.pynew file mode 100644index 000000000..4b71d9b98--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/reasoning_effort.py@@ -0,0 +1,54 @@+# This file was auto-generated by Fern from our API Definition.++import typing++from ..core import enum++T_Result = typing.TypeVar("T_Result")+++class ReasoningEffort(enum.StrEnum):+ NONE = "none"+ MINIMAL = "minimal"+ LOW = "low"+ MEDIUM = "medium"+ HIGH = "high"+ XHIGH = "xhigh"+ MAX = "max"+ _UNKNOWN = "__REASONINGEFFORT_UNKNOWN__"+ """+ This member is used for forward compatibility. If the value is not recognized by the enum, it will be stored here, and the raw value is accessible through `.value`.+ """++ @classmethod+ def _missing_(cls, value: typing.Any) -> "ReasoningEffort":+ unknown = cls._UNKNOWN+ unknown._value_ = value+ return unknown++ def visit(+ self,+ none: typing.Callable[[], T_Result],+ minimal: typing.Callable[[], T_Result],+ low: typing.Callable[[], T_Result],+ medium: typing.Callable[[], T_Result],+ high: typing.Callable[[], T_Result],+ xhigh: typing.Callable[[], T_Result],+ max: typing.Callable[[], T_Result],+ _unknown_member: typing.Callable[[str], T_Result],+ ) -> T_Result:+ if self is ReasoningEffort.NONE:+ return none()+ if self is ReasoningEffort.MINIMAL:+ return minimal()+ if self is ReasoningEffort.LOW:+ return low()+ if self is ReasoningEffort.MEDIUM:+ return medium()+ if self is ReasoningEffort.HIGH:+ return high()+ if self is ReasoningEffort.XHIGH:+ return xhigh()+ if self is ReasoningEffort.MAX:+ return max()+ return _unknown_member(self._value_)diff --git a/python/trueforge_sdk/src/trueforge_sdk/types/remote_mcp_server_manifest.py b/python/trueforge_sdk/src/trueforge_sdk/types/remote_mcp_server_manifest.pynew file mode 100644index 000000000..185f3eb61--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/remote_mcp_server_manifest.py@@ -0,0 +1,32 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .mcp_server_manifest_auth import McpServerManifestAuth+from .resource_name import ResourceName+++class RemoteMcpServerManifest(UncheckedBaseModel):+ auth: typing.Optional[McpServerManifestAuth] = None+ description: str = pydantic.Field()+ """+ Concise summary of what this MCP server provides.+ """++ name: ResourceName+ type: typing.Literal["remote"] = "remote"+ url: str = pydantic.Field()+ """+ MCP endpoint URL.+ """++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/request_error_response.py b/python/trueforge_sdk/src/trueforge_sdk/types/request_error_response.pynew file mode 100644index 000000000..a720ca592--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/request_error_response.py@@ -0,0 +1,20 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .request_error_response_error import RequestErrorResponseError+++class RequestErrorResponse(UncheckedBaseModel):+ error: RequestErrorResponseError++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/request_error_response_error.py b/python/trueforge_sdk/src/trueforge_sdk/types/request_error_response_error.pynew file mode 100644index 000000000..760a84d23--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/request_error_response_error.py@@ -0,0 +1,37 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+++class RequestErrorResponseError(UncheckedBaseModel):+ code: typing.Optional[str] = pydantic.Field(default=None)+ """+ Optional machine-readable error code; null when not applicable.+ """++ message: str = pydantic.Field()+ """+ Human-readable explanation of the failure.+ """++ param: typing.Optional[str] = pydantic.Field(default=None)+ """+ Optional request field that caused the error; null when not field-specific.+ """++ type: typing.Optional[str] = pydantic.Field(default=None)+ """+ Optional error category (e.g. validation vs conflict).+ """++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/resource_name.py b/python/trueforge_sdk/src/trueforge_sdk/types/resource_name.pynew file mode 100644index 000000000..4537b61f9--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/resource_name.py@@ -0,0 +1,3 @@+# This file was auto-generated by Fern from our API Definition.++ResourceName = strdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/resource_permission.py b/python/trueforge_sdk/src/trueforge_sdk/types/resource_permission.pynew file mode 100644index 000000000..a26c3601e--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/resource_permission.py@@ -0,0 +1,42 @@+# This file was auto-generated by Fern from our API Definition.++import typing++from ..core import enum++T_Result = typing.TypeVar("T_Result")+++class ResourcePermission(enum.StrEnum):+ """+ Granted action on a resource.+ """++ USE = "USE"+ MANAGE = "MANAGE"+ DELETE = "DELETE"+ _UNKNOWN = "__RESOURCEPERMISSION_UNKNOWN__"+ """+ This member is used for forward compatibility. If the value is not recognized by the enum, it will be stored here, and the raw value is accessible through `.value`.+ """++ @classmethod+ def _missing_(cls, value: typing.Any) -> "ResourcePermission":+ unknown = cls._UNKNOWN+ unknown._value_ = value+ return unknown++ def visit(+ self,+ use: typing.Callable[[], T_Result],+ manage: typing.Callable[[], T_Result],+ delete: typing.Callable[[], T_Result],+ _unknown_member: typing.Callable[[str], T_Result],+ ) -> T_Result:+ if self is ResourcePermission.USE:+ return use()+ if self is ResourcePermission.MANAGE:+ return manage()+ if self is ResourcePermission.DELETE:+ return delete()+ return _unknown_member(self._value_)diff --git a/python/trueforge_sdk/src/trueforge_sdk/types/response_format.py b/python/trueforge_sdk/src/trueforge_sdk/types/response_format.pynew file mode 100644index 000000000..6f7b373d8--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/response_format.py@@ -0,0 +1,9 @@+# This file was auto-generated by Fern from our API Definition.++import typing++from .response_format_json_object import ResponseFormatJsonObject+from .response_format_json_schema import ResponseFormatJsonSchema+from .response_format_text import ResponseFormatText++ResponseFormat = typing.Union[ResponseFormatJsonObject, ResponseFormatJsonSchema, ResponseFormatText]diff --git a/python/trueforge_sdk/src/trueforge_sdk/types/response_format_json_object.py b/python/trueforge_sdk/src/trueforge_sdk/types/response_format_json_object.pynew file mode 100644index 000000000..b04736c2a--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/response_format_json_object.py@@ -0,0 +1,23 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+++class ResponseFormatJsonObject(UncheckedBaseModel):+ """+ JSON object response format. Extra provider fields are allowed.+ """++ type: typing.Literal["json_object"] = "json_object"++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/response_format_json_schema.py b/python/trueforge_sdk/src/trueforge_sdk/types/response_format_json_schema.pynew file mode 100644index 000000000..24a2147fc--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/response_format_json_schema.py@@ -0,0 +1,29 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .response_format_json_schema_json_schema import ResponseFormatJsonSchemaJsonSchema+++class ResponseFormatJsonSchema(UncheckedBaseModel):+ """+ JSON Schema response format. Extra provider fields are allowed.+ """++ json_schema: ResponseFormatJsonSchemaJsonSchema = pydantic.Field()+ """+ JSON Schema payload. Extra provider fields are allowed.+ """++ type: typing.Literal["json_schema"] = "json_schema"++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/response_format_json_schema_json_schema.py b/python/trueforge_sdk/src/trueforge_sdk/types/response_format_json_schema_json_schema.pynew file mode 100644index 000000000..bd1f6ec4b--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/response_format_json_schema_json_schema.py@@ -0,0 +1,47 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+import typing_extensions+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.serialization import FieldMetadata+from ..core.unchecked_base_model import UncheckedBaseModel+++class ResponseFormatJsonSchemaJsonSchema(UncheckedBaseModel):+ """+ JSON Schema payload. Extra provider fields are allowed.+ """++ description: typing.Optional[str] = pydantic.Field(default=None)+ """+ Optional schema description for the model.+ """++ name: str = pydantic.Field()+ """+ Schema name sent to the provider.+ """++ schema_: typing_extensions.Annotated[+ typing.Optional[typing.Dict[str, typing.Any]],+ FieldMetadata(alias="schema"),+ pydantic.Field(alias="schema", description="JSON Schema object for the response."),+ ] = None+ """+ JSON Schema object for the response.+ """++ strict: typing.Optional[bool] = pydantic.Field(default=None)+ """+ When true, ask the provider to enforce the schema strictly.+ """++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/response_format_text.py b/python/trueforge_sdk/src/trueforge_sdk/types/response_format_text.pynew file mode 100644index 000000000..0461a9f35--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/response_format_text.py@@ -0,0 +1,23 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+++class ResponseFormatText(UncheckedBaseModel):+ """+ Default text response format. Extra provider fields are allowed.+ """++ type: typing.Literal["text"] = "text"++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/runtime_config.py b/python/trueforge_sdk/src/trueforge_sdk/types/runtime_config.pynew file mode 100644index 000000000..322242491--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/runtime_config.py@@ -0,0 +1,33 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .ask_user_questions_config import AskUserQuestionsConfig+from .context_management_config import ContextManagementConfig+from .dynamic_sub_agents_config import DynamicSubAgentsConfig+from .generative_ui_config import GenerativeUiConfig+from .sandbox_config import SandboxConfig+++class RuntimeConfig(UncheckedBaseModel):+ ask_user_questions: typing.Optional[AskUserQuestionsConfig] = None+ context_management: typing.Optional[ContextManagementConfig] = None+ dynamic_sub_agents: typing.Optional[DynamicSubAgentsConfig] = None+ generative_ui: typing.Optional[GenerativeUiConfig] = None+ iteration_limit: typing.Optional[int] = pydantic.Field(default=100)+ """+ Max agent-loop iterations per turn (1–1024). Default: 100.+ """++ sandbox: typing.Optional[SandboxConfig] = None++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/sandbox_build_status.py b/python/trueforge_sdk/src/trueforge_sdk/types/sandbox_build_status.pynew file mode 100644index 000000000..1f7627450--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/sandbox_build_status.py@@ -0,0 +1,42 @@+# This file was auto-generated by Fern from our API Definition.++import typing++from ..core import enum++T_Result = typing.TypeVar("T_Result")+++class SandboxBuildStatus(enum.StrEnum):+ """+ Current build status.+ """++ PENDING = "pending"+ READY = "ready"+ FAILED = "failed"+ _UNKNOWN = "__SANDBOXBUILDSTATUS_UNKNOWN__"+ """+ This member is used for forward compatibility. If the value is not recognized by the enum, it will be stored here, and the raw value is accessible through `.value`.+ """++ @classmethod+ def _missing_(cls, value: typing.Any) -> "SandboxBuildStatus":+ unknown = cls._UNKNOWN+ unknown._value_ = value+ return unknown++ def visit(+ self,+ pending: typing.Callable[[], T_Result],+ ready: typing.Callable[[], T_Result],+ failed: typing.Callable[[], T_Result],+ _unknown_member: typing.Callable[[str], T_Result],+ ) -> T_Result:+ if self is SandboxBuildStatus.PENDING:+ return pending()+ if self is SandboxBuildStatus.READY:+ return ready()+ if self is SandboxBuildStatus.FAILED:+ return failed()+ return _unknown_member(self._value_)diff --git a/python/trueforge_sdk/src/trueforge_sdk/types/sandbox_capability.py b/python/trueforge_sdk/src/trueforge_sdk/types/sandbox_capability.pynew file mode 100644index 000000000..3e663c8f2--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/sandbox_capability.py@@ -0,0 +1,22 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+++class SandboxCapability(UncheckedBaseModel):+ enabled: bool = pydantic.Field()+ """+ Whether a sandbox provider is configured for this tenant.+ """++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/sandbox_config.py b/python/trueforge_sdk/src/trueforge_sdk/types/sandbox_config.pynew file mode 100644index 000000000..d3e7b3ae5--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/sandbox_config.py@@ -0,0 +1,27 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+++class SandboxConfig(UncheckedBaseModel):+ enabled: bool = pydantic.Field()+ """+ Give the agent a sandbox. Required for skills and Code Mode.+ """++ file_downloads: typing.Optional[bool] = pydantic.Field(default=True)+ """+ Allow downloading agent-produced files via the turn download endpoint. Default: true.+ """++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/sandbox_created_event.py b/python/trueforge_sdk/src/trueforge_sdk/types/sandbox_created_event.pynew file mode 100644index 000000000..c7217ff30--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/sandbox_created_event.py@@ -0,0 +1,39 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+++class SandboxCreatedEvent(UncheckedBaseModel):+ created_at: str = pydantic.Field()+ """+ ISO 8601 event timestamp.+ """++ id: str = pydantic.Field()+ """+ Unique identifier for the event (monotonic ULID).+ """++ sandbox_id: str = pydantic.Field()+ """+ Provider sandbox id.+ """++ thread_id: typing.Optional[str] = pydantic.Field(default=None)+ """+ Always null — sandbox is session-scoped.+ """++ type: typing.Literal["sandbox.created"] = "sandbox.created"++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/sandbox_provider_manifest.py b/python/trueforge_sdk/src/trueforge_sdk/types/sandbox_provider_manifest.pynew file mode 100644index 000000000..d6f363b82--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/sandbox_provider_manifest.py@@ -0,0 +1,44 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .daytona_sandbox_provider_auth import DaytonaSandboxProviderAuth+++class SandboxProviderManifest(UncheckedBaseModel):+ auth: DaytonaSandboxProviderAuth+ auto_archive_interval_in_minutes: int = pydantic.Field()+ """+ Minutes before Daytona auto-archives the sandbox (0 disables).+ """++ auto_delete_interval_in_minutes: int = pydantic.Field()+ """+ Minutes before Daytona auto-deletes the sandbox (0 disables).+ """++ auto_stop_interval_in_minutes: int = pydantic.Field()+ """+ Minutes of idle time before Daytona auto-stops the sandbox (0 disables).+ """++ exec_timeout_ms: int = pydantic.Field()+ """+ Default sandbox command exec timeout in milliseconds.+ """++ type: typing.Literal["daytona"] = pydantic.Field(default="daytona")+ """+ Daytona sandbox provider.+ """++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/schedule.py b/python/trueforge_sdk/src/trueforge_sdk/types/schedule.pynew file mode 100644index 000000000..4deb9fa7b--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/schedule.py@@ -0,0 +1,29 @@+# This file was auto-generated by Fern from our API Definition.++import datetime as dt+import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .created_by_subject import CreatedBySubject+from .resource_name import ResourceName+from .schedule_manifest import ScheduleManifest+++class Schedule(UncheckedBaseModel):+ agent_name: ResourceName+ created_at: dt.datetime+ created_by_subject: CreatedBySubject+ id: str+ manifest: ScheduleManifest+ name: ResourceName+ updated_at: dt.datetime++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/schedule_manifest.py b/python/trueforge_sdk/src/trueforge_sdk/types/schedule_manifest.pynew file mode 100644index 000000000..e3849885d--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/schedule_manifest.py@@ -0,0 +1,29 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .cron_expression import CronExpression+from .schedule_status import ScheduleStatus+from .timezone import Timezone+++class ScheduleManifest(UncheckedBaseModel):+ cron: CronExpression+ status: typing.Optional[ScheduleStatus] = None+ task: str = pydantic.Field()+ """+ First user message sent to the agent on every run.+ """++ timezone: typing.Optional[Timezone] = None++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/schedule_run.py b/python/trueforge_sdk/src/trueforge_sdk/types/schedule_run.pynew file mode 100644index 000000000..9baeaf1cf--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/schedule_run.py@@ -0,0 +1,31 @@+# This file was auto-generated by Fern from our API Definition.++import datetime as dt+import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .created_by_subject import CreatedBySubject+from .schedule_run_status import ScheduleRunStatus+++class ScheduleRun(UncheckedBaseModel):+ created_at: dt.datetime+ created_by_subject: CreatedBySubject+ id: str+ name: str+ reason: typing.Optional[str] = None+ schedule_id: str+ scheduled_for: dt.datetime+ status: ScheduleRunStatus+ triggered_at: typing.Optional[dt.datetime] = None+ updated_at: dt.datetime++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/schedule_run_status.py b/python/trueforge_sdk/src/trueforge_sdk/types/schedule_run_status.pynew file mode 100644index 000000000..64d1a1d7a--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/schedule_run_status.py@@ -0,0 +1,38 @@+# This file was auto-generated by Fern from our API Definition.++import typing++from ..core import enum++T_Result = typing.TypeVar("T_Result")+++class ScheduleRunStatus(enum.StrEnum):+ SCHEDULED = "scheduled"+ TRIGGERED = "triggered"+ FAILED = "failed"+ _UNKNOWN = "__SCHEDULERUNSTATUS_UNKNOWN__"+ """+ This member is used for forward compatibility. If the value is not recognized by the enum, it will be stored here, and the raw value is accessible through `.value`.+ """++ @classmethod+ def _missing_(cls, value: typing.Any) -> "ScheduleRunStatus":+ unknown = cls._UNKNOWN+ unknown._value_ = value+ return unknown++ def visit(+ self,+ scheduled: typing.Callable[[], T_Result],+ triggered: typing.Callable[[], T_Result],+ failed: typing.Callable[[], T_Result],+ _unknown_member: typing.Callable[[str], T_Result],+ ) -> T_Result:+ if self is ScheduleRunStatus.SCHEDULED:+ return scheduled()+ if self is ScheduleRunStatus.TRIGGERED:+ return triggered()+ if self is ScheduleRunStatus.FAILED:+ return failed()+ return _unknown_member(self._value_)diff --git a/python/trueforge_sdk/src/trueforge_sdk/types/schedule_status.py b/python/trueforge_sdk/src/trueforge_sdk/types/schedule_status.pynew file mode 100644index 000000000..6d67b63bc--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/schedule_status.py@@ -0,0 +1,34 @@+# This file was auto-generated by Fern from our API Definition.++import typing++from ..core import enum++T_Result = typing.TypeVar("T_Result")+++class ScheduleStatus(enum.StrEnum):+ ACTIVE = "active"+ PAUSED = "paused"+ _UNKNOWN = "__SCHEDULESTATUS_UNKNOWN__"+ """+ This member is used for forward compatibility. If the value is not recognized by the enum, it will be stored here, and the raw value is accessible through `.value`.+ """++ @classmethod+ def _missing_(cls, value: typing.Any) -> "ScheduleStatus":+ unknown = cls._UNKNOWN+ unknown._value_ = value+ return unknown++ def visit(+ self,+ active: typing.Callable[[], T_Result],+ paused: typing.Callable[[], T_Result],+ _unknown_member: typing.Callable[[str], T_Result],+ ) -> T_Result:+ if self is ScheduleStatus.ACTIVE:+ return active()+ if self is ScheduleStatus.PAUSED:+ return paused()+ return _unknown_member(self._value_)diff --git a/python/trueforge_sdk/src/trueforge_sdk/types/session.py b/python/trueforge_sdk/src/trueforge_sdk/types/session.pynew file mode 100644index 000000000..69b629dc6--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/session.py@@ -0,0 +1,47 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .created_by_subject import CreatedBySubject+from .session_agent import SessionAgent+from .session_metadata import SessionMetadata+from .session_metrics import SessionMetrics+from .session_source import SessionSource+++class Session(UncheckedBaseModel):+ agent: SessionAgent+ created_at: str = pydantic.Field()+ """+ ISO 8601 creation timestamp.+ """++ created_by_subject: CreatedBySubject+ id: str = pydantic.Field()+ """+ Unique session id.+ """++ metadata: SessionMetadata+ metrics: SessionMetrics+ source: typing.Optional[SessionSource] = None+ title: typing.Optional[str] = pydantic.Field(default=None)+ """+ Optional human-readable title; null until set.+ """++ updated_at: str = pydantic.Field()+ """+ ISO 8601 last-update timestamp.+ """++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/session_agent.py b/python/trueforge_sdk/src/trueforge_sdk/types/session_agent.pynew file mode 100644index 000000000..86c1ee102--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/session_agent.py@@ -0,0 +1,8 @@+# This file was auto-generated by Fern from our API Definition.++import typing++from .session_agent_inline import SessionAgentInline+from .session_agent_reference import SessionAgentReference++SessionAgent = typing.Union[SessionAgentInline, SessionAgentReference]diff --git a/python/trueforge_sdk/src/trueforge_sdk/types/session_agent_inline.py b/python/trueforge_sdk/src/trueforge_sdk/types/session_agent_inline.pynew file mode 100644index 000000000..4e3b65131--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/session_agent_inline.py@@ -0,0 +1,21 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .agent_spec import AgentSpec+++class SessionAgentInline(UncheckedBaseModel):+ spec: AgentSpec+ type: typing.Literal["inline"] = "inline"++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/session_agent_name_ref.py b/python/trueforge_sdk/src/trueforge_sdk/types/session_agent_name_ref.pynew file mode 100644index 000000000..dfda31371--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/session_agent_name_ref.py@@ -0,0 +1,20 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .resource_name import ResourceName+++class SessionAgentNameRef(UncheckedBaseModel):+ name: ResourceName++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/session_agent_reference.py b/python/trueforge_sdk/src/trueforge_sdk/types/session_agent_reference.pynew file mode 100644index 000000000..9f397db0e--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/session_agent_reference.py@@ -0,0 +1,29 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+++class SessionAgentReference(UncheckedBaseModel):+ id: str = pydantic.Field()+ """+ Registry agent id.+ """++ name: typing.Optional[str] = pydantic.Field(default=None)+ """+ Create-time snapshot of the registry agent name; null for legacy or orphan rows.+ """++ type: typing.Literal["reference"] = "reference"++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/session_agent_spec_body.py b/python/trueforge_sdk/src/trueforge_sdk/types/session_agent_spec_body.pynew file mode 100644index 000000000..df612002e--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/session_agent_spec_body.py@@ -0,0 +1,20 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .agent_spec import AgentSpec+++class SessionAgentSpecBody(UncheckedBaseModel):+ spec: AgentSpec++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/session_event.py b/python/trueforge_sdk/src/trueforge_sdk/types/session_event.pynew file mode 100644index 000000000..94f737c15--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/session_event.py@@ -0,0 +1,29 @@+# This file was auto-generated by Fern from our API Definition.++import typing++from .mcp_auth_required_event import McpAuthRequiredEvent+from .mcp_initialize_event import McpInitializeEvent+from .model_message_event import ModelMessageEvent+from .sandbox_created_event import SandboxCreatedEvent+from .thread_created_event import ThreadCreatedEvent+from .thread_done_event import ThreadDoneEvent+from .tool_approval_required_event import ToolApprovalRequiredEvent+from .tool_response_event import ToolResponseEvent+from .tool_response_required_event import ToolResponseRequiredEvent+from .turn_created_event import TurnCreatedEvent+from .turn_done_event import TurnDoneEvent++SessionEvent = typing.Union[+ McpAuthRequiredEvent,+ McpInitializeEvent,+ ModelMessageEvent,+ SandboxCreatedEvent,+ ThreadCreatedEvent,+ ThreadDoneEvent,+ ToolApprovalRequiredEvent,+ ToolResponseEvent,+ ToolResponseRequiredEvent,+ TurnCreatedEvent,+ TurnDoneEvent,+]diff --git a/python/trueforge_sdk/src/trueforge_sdk/types/session_event_item.py b/python/trueforge_sdk/src/trueforge_sdk/types/session_event_item.pynew file mode 100644index 000000000..6ce90907a--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/session_event_item.py@@ -0,0 +1,24 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .session_event import SessionEvent+++class SessionEventItem(UncheckedBaseModel):+ event: SessionEvent+ turn_id: str = pydantic.Field()+ """+ Turn that emitted this event.+ """++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/session_metadata.py b/python/trueforge_sdk/src/trueforge_sdk/types/session_metadata.pynew file mode 100644index 000000000..260fbb0fd--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/session_metadata.py@@ -0,0 +1,8 @@+# This file was auto-generated by Fern from our API Definition.++import typing++SessionMetadata = typing.Dict[str, str]+"""+Caller-owned session metadata+"""diff --git a/python/trueforge_sdk/src/trueforge_sdk/types/session_metrics.py b/python/trueforge_sdk/src/trueforge_sdk/types/session_metrics.pynew file mode 100644index 000000000..39e772df0--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/session_metrics.py@@ -0,0 +1,29 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+++class SessionMetrics(UncheckedBaseModel):+ """+ Rolled-up cost, duration, and turn counters for a session.+ """++ total_cost_in_usd: typing.Optional[float] = pydantic.Field(default=None)+ """+ Estimated total cost in USD for this session+ """++ total_duration_ms: int+ total_turns: int++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/session_metrics_chart.py b/python/trueforge_sdk/src/trueforge_sdk/types/session_metrics_chart.pynew file mode 100644index 000000000..e817decc5--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/session_metrics_chart.py@@ -0,0 +1,23 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .session_metrics_chart_name import SessionMetricsChartName+++class SessionMetricsChart(UncheckedBaseModel):+ chart_type: typing.Literal["line"] = "line"+ description: str+ display_name: str+ name: SessionMetricsChartName++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/session_metrics_chart_data_response.py b/python/trueforge_sdk/src/trueforge_sdk/types/session_metrics_chart_data_response.pynew file mode 100644index 000000000..f0be8de0c--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/session_metrics_chart_data_response.py@@ -0,0 +1,21 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .session_metrics_graph import SessionMetricsGraph+++class SessionMetricsChartDataResponse(UncheckedBaseModel):+ graphs: typing.List[SessionMetricsGraph]+ step: str++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/session_metrics_chart_name.py b/python/trueforge_sdk/src/trueforge_sdk/types/session_metrics_chart_name.pynew file mode 100644index 000000000..92c4ab43b--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/session_metrics_chart_name.py@@ -0,0 +1,42 @@+# This file was auto-generated by Fern from our API Definition.++import typing++from ..core import enum++T_Result = typing.TypeVar("T_Result")+++class SessionMetricsChartName(enum.StrEnum):+ """+ Session metrics chart to return.+ """++ SESSIONS_OVER_TIME = "sessions_over_time"+ SESSIONS_COST_OVER_TIME = "sessions_cost_over_time"+ TURNS_OVER_TIME = "turns_over_time"+ _UNKNOWN = "__SESSIONMETRICSCHARTNAME_UNKNOWN__"+ """+ This member is used for forward compatibility. If the value is not recognized by the enum, it will be stored here, and the raw value is accessible through `.value`.+ """++ @classmethod+ def _missing_(cls, value: typing.Any) -> "SessionMetricsChartName":+ unknown = cls._UNKNOWN+ unknown._value_ = value+ return unknown++ def visit(+ self,+ sessions_over_time: typing.Callable[[], T_Result],+ sessions_cost_over_time: typing.Callable[[], T_Result],+ turns_over_time: typing.Callable[[], T_Result],+ _unknown_member: typing.Callable[[str], T_Result],+ ) -> T_Result:+ if self is SessionMetricsChartName.SESSIONS_OVER_TIME:+ return sessions_over_time()+ if self is SessionMetricsChartName.SESSIONS_COST_OVER_TIME:+ return sessions_cost_over_time()+ if self is SessionMetricsChartName.TURNS_OVER_TIME:+ return turns_over_time()+ return _unknown_member(self._value_)diff --git a/python/trueforge_sdk/src/trueforge_sdk/types/session_metrics_chart_response.py b/python/trueforge_sdk/src/trueforge_sdk/types/session_metrics_chart_response.pynew file mode 100644index 000000000..92594d14b--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/session_metrics_chart_response.py@@ -0,0 +1,20 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .session_metrics_chart import SessionMetricsChart+++class SessionMetricsChartResponse(UncheckedBaseModel):+ charts: typing.List[SessionMetricsChart]++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/session_metrics_graph.py b/python/trueforge_sdk/src/trueforge_sdk/types/session_metrics_graph.pynew file mode 100644index 000000000..4dc219e15--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/session_metrics_graph.py@@ -0,0 +1,27 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .metrics_unit import MetricsUnit+from .session_metrics_chart_name import SessionMetricsChartName+from .session_metrics_graph_line import SessionMetricsGraphLine+++class SessionMetricsGraph(UncheckedBaseModel):+ chart_type: typing.Literal["line"] = "line"+ description: str+ display_name: str+ graph_lines: typing.List[SessionMetricsGraphLine]+ name: SessionMetricsChartName+ unit: MetricsUnit++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/session_metrics_graph_line.py b/python/trueforge_sdk/src/trueforge_sdk/types/session_metrics_graph_line.pynew file mode 100644index 000000000..d839a8dfe--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/session_metrics_graph_line.py@@ -0,0 +1,21 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .session_metrics_point import SessionMetricsPoint+++class SessionMetricsGraphLine(UncheckedBaseModel):+ name: str+ values: typing.List[SessionMetricsPoint]++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/session_metrics_meter.py b/python/trueforge_sdk/src/trueforge_sdk/types/session_metrics_meter.pynew file mode 100644index 000000000..fc4d649ad--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/session_metrics_meter.py@@ -0,0 +1,24 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .metrics_unit import MetricsUnit+from .session_metrics_meter_name import SessionMetricsMeterName+++class SessionMetricsMeter(UncheckedBaseModel):+ aggregate_value: float+ description: str+ name: SessionMetricsMeterName+ unit: MetricsUnit++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/session_metrics_meter_name.py b/python/trueforge_sdk/src/trueforge_sdk/types/session_metrics_meter_name.pynew file mode 100644index 000000000..d59bd5d03--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/session_metrics_meter_name.py@@ -0,0 +1,74 @@+# This file was auto-generated by Fern from our API Definition.++import typing++from ..core import enum++T_Result = typing.TypeVar("T_Result")+++class SessionMetricsMeterName(enum.StrEnum):+ TOTAL_SESSIONS = "total_sessions"+ TOTAL_COST_IN_USD = "total_cost_in_usd"+ TOTAL_TURNS = "total_turns"+ COST_PER_SESSION_IN_USD = "cost_per_session_in_usd"+ AVG_TURNS_PER_SESSION = "avg_turns_per_session"+ MIN_TURNS_PER_SESSION = "min_turns_per_session"+ MAX_TURNS_PER_SESSION = "max_turns_per_session"+ MEDIAN_TURNS_PER_SESSION = "median_turns_per_session"+ MIN_SESSION_DURATION_MS = "min_session_duration_ms"+ MAX_SESSION_DURATION_MS = "max_session_duration_ms"+ MEDIAN_SESSION_DURATION_MS = "median_session_duration_ms"+ P95SESSION_DURATION_MS = "p95_session_duration_ms"+ _UNKNOWN = "__SESSIONMETRICSMETERNAME_UNKNOWN__"+ """+ This member is used for forward compatibility. If the value is not recognized by the enum, it will be stored here, and the raw value is accessible through `.value`.+ """++ @classmethod+ def _missing_(cls, value: typing.Any) -> "SessionMetricsMeterName":+ unknown = cls._UNKNOWN+ unknown._value_ = value+ return unknown++ def visit(+ self,+ total_sessions: typing.Callable[[], T_Result],+ total_cost_in_usd: typing.Callable[[], T_Result],+ total_turns: typing.Callable[[], T_Result],+ cost_per_session_in_usd: typing.Callable[[], T_Result],+ avg_turns_per_session: typing.Callable[[], T_Result],+ min_turns_per_session: typing.Callable[[], T_Result],+ max_turns_per_session: typing.Callable[[], T_Result],+ median_turns_per_session: typing.Callable[[], T_Result],+ min_session_duration_ms: typing.Callable[[], T_Result],+ max_session_duration_ms: typing.Callable[[], T_Result],+ median_session_duration_ms: typing.Callable[[], T_Result],+ p95session_duration_ms: typing.Callable[[], T_Result],+ _unknown_member: typing.Callable[[str], T_Result],+ ) -> T_Result:+ if self is SessionMetricsMeterName.TOTAL_SESSIONS:+ return total_sessions()+ if self is SessionMetricsMeterName.TOTAL_COST_IN_USD:+ return total_cost_in_usd()+ if self is SessionMetricsMeterName.TOTAL_TURNS:+ return total_turns()+ if self is SessionMetricsMeterName.COST_PER_SESSION_IN_USD:+ return cost_per_session_in_usd()+ if self is SessionMetricsMeterName.AVG_TURNS_PER_SESSION:+ return avg_turns_per_session()+ if self is SessionMetricsMeterName.MIN_TURNS_PER_SESSION:+ return min_turns_per_session()+ if self is SessionMetricsMeterName.MAX_TURNS_PER_SESSION:+ return max_turns_per_session()+ if self is SessionMetricsMeterName.MEDIAN_TURNS_PER_SESSION:+ return median_turns_per_session()+ if self is SessionMetricsMeterName.MIN_SESSION_DURATION_MS:+ return min_session_duration_ms()+ if self is SessionMetricsMeterName.MAX_SESSION_DURATION_MS:+ return max_session_duration_ms()+ if self is SessionMetricsMeterName.MEDIAN_SESSION_DURATION_MS:+ return median_session_duration_ms()+ if self is SessionMetricsMeterName.P95SESSION_DURATION_MS:+ return p95session_duration_ms()+ return _unknown_member(self._value_)diff --git a/python/trueforge_sdk/src/trueforge_sdk/types/session_metrics_meter_response.py b/python/trueforge_sdk/src/trueforge_sdk/types/session_metrics_meter_response.pynew file mode 100644index 000000000..66b637007--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/session_metrics_meter_response.py@@ -0,0 +1,20 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .session_metrics_meter import SessionMetricsMeter+++class SessionMetricsMeterResponse(UncheckedBaseModel):+ meters: typing.List[SessionMetricsMeter]++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/session_metrics_point.py b/python/trueforge_sdk/src/trueforge_sdk/types/session_metrics_point.pynew file mode 100644index 000000000..4f11f9fd5--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/session_metrics_point.py@@ -0,0 +1,20 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+++class SessionMetricsPoint(UncheckedBaseModel):+ timestamp: str+ value: float++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/session_source.py b/python/trueforge_sdk/src/trueforge_sdk/types/session_source.pynew file mode 100644index 000000000..dda2353c9--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/session_source.py@@ -0,0 +1,36 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+++class SessionSource(UncheckedBaseModel):+ """+ How this session was created (e.g. a schedule run). Null for interactive sessions.+ """++ id: str = pydantic.Field()+ """+ Schedule id.+ """++ run_id: str = pydantic.Field()+ """+ Schedule run id.+ """++ type: typing.Literal["schedule"] = pydantic.Field(default="schedule")+ """+ Session was created by a schedule run.+ """++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/session_source_schedule.py b/python/trueforge_sdk/src/trueforge_sdk/types/session_source_schedule.pynew file mode 100644index 000000000..c8b4b4f2f--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/session_source_schedule.py@@ -0,0 +1,32 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+++class SessionSourceSchedule(UncheckedBaseModel):+ id: str = pydantic.Field()+ """+ Schedule id.+ """++ run_id: str = pydantic.Field()+ """+ Schedule run id.+ """++ type: typing.Literal["schedule"] = pydantic.Field(default="schedule")+ """+ Session was created by a schedule run.+ """++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/session_source_type.py b/python/trueforge_sdk/src/trueforge_sdk/types/session_source_type.pynew file mode 100644index 000000000..d82e7f67a--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/session_source_type.py@@ -0,0 +1,8 @@+# This file was auto-generated by Fern from our API Definition.++import typing++SessionSourceType = typing.Literal["schedule"]+"""+When set, returns only sessions created by this source type.+"""diff --git a/python/trueforge_sdk/src/trueforge_sdk/types/settings_capability.py b/python/trueforge_sdk/src/trueforge_sdk/types/settings_capability.pynew file mode 100644index 000000000..dff3e54e2--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/settings_capability.py@@ -0,0 +1,22 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+++class SettingsCapability(UncheckedBaseModel):+ enabled: bool = pydantic.Field()+ """+ Whether the settings UI/API is enabled.+ """++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/skill.py b/python/trueforge_sdk/src/trueforge_sdk/types/skill.pynew file mode 100644index 000000000..833890d4c--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/skill.py@@ -0,0 +1,27 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+++class Skill(UncheckedBaseModel):+ name: str = pydantic.Field()+ """+ Skill name.+ """++ preload: typing.Optional[bool] = pydantic.Field(default=False)+ """+ Inline SKILL.md into the prompt.+ """++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/skill_capability.py b/python/trueforge_sdk/src/trueforge_sdk/types/skill_capability.pynew file mode 100644index 000000000..d6dd4f939--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/skill_capability.py@@ -0,0 +1,27 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+++class SkillCapability(UncheckedBaseModel):+ enabled: bool = pydantic.Field()+ """+ Whether skills are available. False when sandbox is not enabled (skills require a sandbox).+ """++ reason: typing.Optional[str] = pydantic.Field(default=None)+ """+ Present when skills are disabled. Explains why.+ """++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/skill_manifest.py b/python/trueforge_sdk/src/trueforge_sdk/types/skill_manifest.pynew file mode 100644index 000000000..cb8680e87--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/skill_manifest.py@@ -0,0 +1,8 @@+# This file was auto-generated by Fern from our API Definition.++import typing++from .git_skill import GitSkill+from .true_foundry_registry_skill import TrueFoundryRegistrySkill++SkillManifest = typing.Union[GitSkill, TrueFoundryRegistrySkill]diff --git a/python/trueforge_sdk/src/trueforge_sdk/types/skill_version.py b/python/trueforge_sdk/src/trueforge_sdk/types/skill_version.pynew file mode 100644index 000000000..f9136e768--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/skill_version.py@@ -0,0 +1,26 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+++class SkillVersion(UncheckedBaseModel):+ description: str = pydantic.Field()+ """+ Concise guidance for when the agent should use the skill.+ """++ display_name: str+ name: str+ version: int++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/text_content.py b/python/trueforge_sdk/src/trueforge_sdk/types/text_content.pynew file mode 100644index 000000000..6893a0e98--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/text_content.py@@ -0,0 +1,24 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+++class TextContent(UncheckedBaseModel):+ text: str = pydantic.Field()+ """+ Plain-text content.+ """++ type: typing.Literal["text"] = "text"++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/thread_created_event.py b/python/trueforge_sdk/src/trueforge_sdk/types/thread_created_event.pynew file mode 100644index 000000000..3ca2750bf--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/thread_created_event.py@@ -0,0 +1,43 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .agent_info import AgentInfo+from .agent_parent import AgentParent+++class ThreadCreatedEvent(UncheckedBaseModel):+ agent_info: AgentInfo+ created_at: str = pydantic.Field()+ """+ ISO 8601 event timestamp.+ """++ id: str = pydantic.Field()+ """+ Unique identifier for the event (monotonic ULID).+ """++ parent: AgentParent+ thread_id: str = pydantic.Field()+ """+ Id of the new thread.+ """++ title: str = pydantic.Field()+ """+ Human-readable thread title.+ """++ type: typing.Literal["thread.created"] = "thread.created"++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/thread_done_event.py b/python/trueforge_sdk/src/trueforge_sdk/types/thread_done_event.pynew file mode 100644index 000000000..c1857c1c9--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/thread_done_event.py@@ -0,0 +1,31 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from .base_thread_done_event import BaseThreadDoneEvent+from .thread_state import ThreadState+++class ThreadDoneEvent(BaseThreadDoneEvent):+ created_at: str = pydantic.Field()+ """+ ISO 8601 event timestamp.+ """++ id: str = pydantic.Field()+ """+ Unique identifier for the event (monotonic ULID).+ """++ state: ThreadState+ type: typing.Literal["thread.done"] = "thread.done"++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/thread_state.py b/python/trueforge_sdk/src/trueforge_sdk/types/thread_state.pynew file mode 100644index 000000000..d69da3db5--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/thread_state.py@@ -0,0 +1,8 @@+# This file was auto-generated by Fern from our API Definition.++import typing++from .thread_state_done import ThreadStateDone+from .thread_state_error import ThreadStateError++ThreadState = typing.Union[ThreadStateDone, ThreadStateError]diff --git a/python/trueforge_sdk/src/trueforge_sdk/types/thread_state_done.py b/python/trueforge_sdk/src/trueforge_sdk/types/thread_state_done.pynew file mode 100644index 000000000..912c2bb7e--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/thread_state_done.py@@ -0,0 +1,21 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .model_message_event import ModelMessageEvent+++class ThreadStateDone(UncheckedBaseModel):+ output: ModelMessageEvent+ status: typing.Literal["done"] = "done"++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/thread_state_error.py b/python/trueforge_sdk/src/trueforge_sdk/types/thread_state_error.pynew file mode 100644index 000000000..7ce8b1250--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/thread_state_error.py@@ -0,0 +1,26 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .model_message_event import ModelMessageEvent+++class ThreadStateError(UncheckedBaseModel):+ error: str = pydantic.Field()+ """+ Human-readable error message.+ """++ output: typing.Optional[ModelMessageEvent] = None+ status: typing.Literal["error"] = "error"++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/timezone.py b/python/trueforge_sdk/src/trueforge_sdk/types/timezone.pynew file mode 100644index 000000000..28b517a60--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/timezone.py@@ -0,0 +1,6 @@+# This file was auto-generated by Fern from our API Definition.++Timezone = str+"""+IANA time zone the cron expression is evaluated in.+"""diff --git a/python/trueforge_sdk/src/trueforge_sdk/types/together_ai_model_provider.py b/python/trueforge_sdk/src/trueforge_sdk/types/together_ai_model_provider.pynew file mode 100644index 000000000..5c22a45fa--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/together_ai_model_provider.py@@ -0,0 +1,32 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .configured_model import ConfiguredModel+from .model_provider_auth import ModelProviderAuth+++class TogetherAiModelProvider(UncheckedBaseModel):+ auth: ModelProviderAuth+ base_url: typing.Optional[str] = pydantic.Field(default="https://api.together.xyz/v1")+ """+ Override of the provider's default API base URL.+ """++ models: typing.List[ConfiguredModel] = pydantic.Field()+ """+ Models exposed by this provider (at least one).+ """++ type: typing.Literal["together"] = "together"++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/token_pagination.py b/python/trueforge_sdk/src/trueforge_sdk/types/token_pagination.pynew file mode 100644index 000000000..a80563a4b--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/token_pagination.py@@ -0,0 +1,32 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+++class TokenPagination(UncheckedBaseModel):+ limit: int = pydantic.Field()+ """+ Page size used for this response.+ """++ next_page_token: typing.Optional[str] = pydantic.Field(default=None)+ """+ Opaque token for the next page. Omit or absent when there is no next page.+ """++ previous_page_token: typing.Optional[str] = pydantic.Field(default=None)+ """+ Opaque token for the previous page. Omit or absent when there is no previous page.+ """++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/tool_approval_required_event.py b/python/trueforge_sdk/src/trueforge_sdk/types/tool_approval_required_event.pynew file mode 100644index 000000000..cf1cbaa22--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/tool_approval_required_event.py@@ -0,0 +1,40 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .tool_call_ref import ToolCallRef+++class ToolApprovalRequiredEvent(UncheckedBaseModel):+ created_at: str = pydantic.Field()+ """+ ISO 8601 event timestamp.+ """++ id: str = pydantic.Field()+ """+ Unique identifier for the event (monotonic ULID).+ """++ thread_id: str = pydantic.Field()+ """+ Thread that owns the pending tool calls.+ """++ tool_calls: typing.List[ToolCallRef] = pydantic.Field()+ """+ Tool calls waiting for approval.+ """++ type: typing.Literal["tool.approval_required"] = "tool.approval_required"++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/tool_call.py b/python/trueforge_sdk/src/trueforge_sdk/types/tool_call.pynew file mode 100644index 000000000..29ffe6400--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/tool_call.py@@ -0,0 +1,20 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from .raw_tool_call import RawToolCall+from .tool_info import ToolInfo+++class ToolCall(RawToolCall):+ tool_info: ToolInfo++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/tool_call_ref.py b/python/trueforge_sdk/src/trueforge_sdk/types/tool_call_ref.pynew file mode 100644index 000000000..6f99d511b--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/tool_call_ref.py@@ -0,0 +1,27 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+++class ToolCallRef(UncheckedBaseModel):+ id: str = pydantic.Field()+ """+ Tool call id awaiting action.+ """++ source_event_id: str = pydantic.Field()+ """+ Event id of the model.message that requested the tool call.+ """++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/tool_info.py b/python/trueforge_sdk/src/trueforge_sdk/types/tool_info.pynew file mode 100644index 000000000..8e9c15f38--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/tool_info.py@@ -0,0 +1,8 @@+# This file was auto-generated by Fern from our API Definition.++import typing++from .mcp_tool_info import McpToolInfo+from .true_foundry_system_tool_info import TrueFoundrySystemToolInfo++ToolInfo = typing.Union[McpToolInfo, TrueFoundrySystemToolInfo]diff --git a/python/trueforge_sdk/src/trueforge_sdk/types/tool_response_event.py b/python/trueforge_sdk/src/trueforge_sdk/types/tool_response_event.pynew file mode 100644index 000000000..8f729dca7--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/tool_response_event.py@@ -0,0 +1,40 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+++class ToolResponseEvent(UncheckedBaseModel):+ content: str+ created_at: str = pydantic.Field()+ """+ ISO 8601 event timestamp.+ """++ id: str = pydantic.Field()+ """+ Unique identifier for the event (monotonic ULID).+ """++ thread_id: str = pydantic.Field()+ """+ Thread that owns the tool call.+ """++ tool_call_id: str = pydantic.Field()+ """+ Id of the tool call this message responds to.+ """++ type: typing.Literal["tool.response"] = "tool.response"++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/tool_response_required_event.py b/python/trueforge_sdk/src/trueforge_sdk/types/tool_response_required_event.pynew file mode 100644index 000000000..615038aee--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/tool_response_required_event.py@@ -0,0 +1,40 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .tool_call_ref import ToolCallRef+++class ToolResponseRequiredEvent(UncheckedBaseModel):+ created_at: str = pydantic.Field()+ """+ ISO 8601 event timestamp.+ """++ id: str = pydantic.Field()+ """+ Unique identifier for the event (monotonic ULID).+ """++ thread_id: str = pydantic.Field()+ """+ Thread that owns the pending tool calls.+ """++ tool_calls: typing.List[ToolCallRef] = pydantic.Field()+ """+ Tool calls waiting for a client response.+ """++ type: typing.Literal["tool.response_required"] = "tool.response_required"++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/true_foundry_mcp_server_manifest.py b/python/trueforge_sdk/src/trueforge_sdk/types/true_foundry_mcp_server_manifest.pynew file mode 100644index 000000000..675f83503--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/true_foundry_mcp_server_manifest.py@@ -0,0 +1,32 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .mcp_server_manifest_auth import McpServerManifestAuth+from .resource_name import ResourceName+++class TrueFoundryMcpServerManifest(UncheckedBaseModel):+ auth: typing.Optional[McpServerManifestAuth] = None+ description: str = pydantic.Field()+ """+ Concise summary of what this MCP server provides.+ """++ name: ResourceName+ type: typing.Literal["truefoundry"] = "truefoundry"+ url: str = pydantic.Field()+ """+ Resolved AI Gateway proxy URL for this TrueFoundry-managed MCP server.+ """++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/true_foundry_model_provider.py b/python/trueforge_sdk/src/trueforge_sdk/types/true_foundry_model_provider.pynew file mode 100644index 000000000..763c50c7f--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/true_foundry_model_provider.py@@ -0,0 +1,32 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .configured_model import ConfiguredModel+from .model_provider_auth import ModelProviderAuth+++class TrueFoundryModelProvider(UncheckedBaseModel):+ auth: typing.Optional[ModelProviderAuth] = None+ base_url: str = pydantic.Field()+ """+ Base URL of the TrueFoundry AI gateway the models are invoked against.+ """++ models: typing.List[ConfiguredModel] = pydantic.Field()+ """+ Models exposed by this provider (at least one).+ """++ type: typing.Literal["truefoundry"] = "truefoundry"++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/true_foundry_registry_skill.py b/python/trueforge_sdk/src/trueforge_sdk/types/true_foundry_registry_skill.pynew file mode 100644index 000000000..ac6faef20--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/true_foundry_registry_skill.py@@ -0,0 +1,32 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+++class TrueFoundryRegistrySkill(UncheckedBaseModel):+ description: str = pydantic.Field()+ """+ Concise guidance for when the agent should use the skill.+ """++ display_name: str+ name: str+ repository_name: str = pydantic.Field()+ """+ Repo where the skill is registered.+ """++ type: typing.Literal["truefoundry"] = "truefoundry"+ version: int++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/true_foundry_system_tool_info.py b/python/trueforge_sdk/src/trueforge_sdk/types/true_foundry_system_tool_info.pynew file mode 100644index 000000000..3115d70b2--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/true_foundry_system_tool_info.py@@ -0,0 +1,24 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+++class TrueFoundrySystemToolInfo(UncheckedBaseModel):+ name: str = pydantic.Field()+ """+ System tool name.+ """++ type: typing.Literal["truefoundry-system"] = "truefoundry-system"++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/turn.py b/python/trueforge_sdk/src/trueforge_sdk/types/turn.pynew file mode 100644index 000000000..7ef2e05ee--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/turn.py@@ -0,0 +1,46 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .turn_input_item import TurnInputItem+from .turn_state import TurnState+++class Turn(UncheckedBaseModel):+ created_at: str = pydantic.Field()+ """+ ISO 8601 creation timestamp.+ """++ id: str = pydantic.Field()+ """+ Unique turn id.+ """++ input: typing.Optional[typing.List[TurnInputItem]] = pydantic.Field(default=None)+ """+ Input items supplied when the turn was created.+ """++ previous_turn_id: typing.Optional[str] = pydantic.Field(default=None)+ """+ Prior turn this turn chains from; null for a root turn.+ """++ session_id: str = pydantic.Field()+ """+ Session that owns this turn.+ """++ state: TurnState++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/turn_created_event.py b/python/trueforge_sdk/src/trueforge_sdk/types/turn_created_event.pynew file mode 100644index 000000000..89283a321--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/turn_created_event.py@@ -0,0 +1,52 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .turn_input_item import TurnInputItem+from .turn_state_running import TurnStateRunning+++class TurnCreatedEvent(UncheckedBaseModel):+ created_at: str = pydantic.Field()+ """+ ISO 8601 event timestamp.+ """++ id: str = pydantic.Field()+ """+ Unique identifier for the event (monotonic ULID).+ """++ input: typing.Optional[typing.List[TurnInputItem]] = pydantic.Field(default=None)+ """+ Input items supplied when the turn was created.+ """++ previous_turn_id: typing.Optional[str] = pydantic.Field(default=None)+ """+ Prior turn this turn chains from; null for a root turn.+ """++ state: TurnStateRunning+ thread_id: typing.Optional[str] = pydantic.Field(default=None)+ """+ Thread that owns the event; null for turn-level lifecycle events.+ """++ turn_id: str = pydantic.Field()+ """+ Id of the newly created turn.+ """++ type: typing.Literal["turn.created"] = "turn.created"++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/turn_done_event.py b/python/trueforge_sdk/src/trueforge_sdk/types/turn_done_event.pynew file mode 100644index 000000000..8683bee14--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/turn_done_event.py@@ -0,0 +1,40 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .turn_done_event_state import TurnDoneEventState+++class TurnDoneEvent(UncheckedBaseModel):+ created_at: str = pydantic.Field()+ """+ ISO 8601 event timestamp.+ """++ id: str = pydantic.Field()+ """+ Unique identifier for the event (monotonic ULID).+ """++ state: TurnDoneEventState = pydantic.Field()+ """+ Terminal turn state (done, cancelled, or error).+ """++ thread_id: typing.Optional[str] = pydantic.Field(default=None)+ """+ Thread that owns the event; null for turn-level lifecycle events.+ """++ type: typing.Literal["turn.done"] = "turn.done"++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/turn_done_event_state.py b/python/trueforge_sdk/src/trueforge_sdk/types/turn_done_event_state.pynew file mode 100644index 000000000..4518451dc--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/turn_done_event_state.py@@ -0,0 +1,9 @@+# This file was auto-generated by Fern from our API Definition.++import typing++from .turn_state_cancelled import TurnStateCancelled+from .turn_state_done import TurnStateDone+from .turn_state_error import TurnStateError++TurnDoneEventState = typing.Union[TurnStateCancelled, TurnStateDone, TurnStateError]diff --git a/python/trueforge_sdk/src/trueforge_sdk/types/turn_input_item.py b/python/trueforge_sdk/src/trueforge_sdk/types/turn_input_item.pynew file mode 100644index 000000000..9e1c299ac--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/turn_input_item.py@@ -0,0 +1,9 @@+# This file was auto-generated by Fern from our API Definition.++import typing++from .user_message import UserMessage+from .user_tool_approval_event import UserToolApprovalEvent+from .user_tool_response_event import UserToolResponseEvent++TurnInputItem = typing.Union[UserMessage, UserToolApprovalEvent, UserToolResponseEvent]diff --git a/python/trueforge_sdk/src/trueforge_sdk/types/turn_metrics.py b/python/trueforge_sdk/src/trueforge_sdk/types/turn_metrics.pynew file mode 100644index 000000000..85dfe8195--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/turn_metrics.py@@ -0,0 +1,56 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+++class TurnMetrics(UncheckedBaseModel):+ """+ Optional billable aggregate for the whole turn.+ """++ total_cache_read_tokens: typing.Optional[int] = pydantic.Field(default=None)+ """+ Total cache-read tokens across model calls in this turn.+ """++ total_cache_write_tokens: typing.Optional[int] = pydantic.Field(default=None)+ """+ Total cache-write tokens across model calls in this turn.+ """++ total_cost_in_usd: typing.Optional[float] = pydantic.Field(default=None)+ """+ Estimated total cost in USD for this turn.+ """++ total_input_tokens: typing.Optional[int] = pydantic.Field(default=None)+ """+ Total input tokens across model calls in this turn.+ """++ total_output_tokens: typing.Optional[int] = pydantic.Field(default=None)+ """+ Total output tokens across model calls in this turn.+ """++ total_reasoning_tokens: typing.Optional[int] = pydantic.Field(default=None)+ """+ Total reasoning tokens across model calls in this turn.+ """++ total_tokens: typing.Optional[int] = pydantic.Field(default=None)+ """+ Total tokens (input + output) across model calls in this turn.+ """++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/turn_state.py b/python/trueforge_sdk/src/trueforge_sdk/types/turn_state.pynew file mode 100644index 000000000..868df1ae3--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/turn_state.py@@ -0,0 +1,10 @@+# This file was auto-generated by Fern from our API Definition.++import typing++from .turn_state_cancelled import TurnStateCancelled+from .turn_state_done import TurnStateDone+from .turn_state_error import TurnStateError+from .turn_state_running import TurnStateRunning++TurnState = typing.Union[TurnStateCancelled, TurnStateDone, TurnStateError, TurnStateRunning]diff --git a/python/trueforge_sdk/src/trueforge_sdk/types/turn_state_cancelled.py b/python/trueforge_sdk/src/trueforge_sdk/types/turn_state_cancelled.pynew file mode 100644index 000000000..566b56acb--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/turn_state_cancelled.py@@ -0,0 +1,32 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .turn_state_cancelled_metrics import TurnStateCancelledMetrics+from .turn_state_cancelled_reason import TurnStateCancelledReason+++class TurnStateCancelled(UncheckedBaseModel):+ completed_at: str = pydantic.Field()+ """+ ISO 8601 time when cancellation completed.+ """++ metrics: typing.Optional[TurnStateCancelledMetrics] = pydantic.Field(default=None)+ """+ Optional billable aggregate for work done before cancel.+ """++ reason: TurnStateCancelledReason+ status: typing.Literal["cancelled"] = "cancelled"++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/turn_state_cancelled_metrics.py b/python/trueforge_sdk/src/trueforge_sdk/types/turn_state_cancelled_metrics.pynew file mode 100644index 000000000..5f4bdcd35--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/turn_state_cancelled_metrics.py@@ -0,0 +1,56 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+++class TurnStateCancelledMetrics(UncheckedBaseModel):+ """+ Optional billable aggregate for work done before cancel.+ """++ total_cache_read_tokens: typing.Optional[int] = pydantic.Field(default=None)+ """+ Total cache-read tokens across model calls in this turn.+ """++ total_cache_write_tokens: typing.Optional[int] = pydantic.Field(default=None)+ """+ Total cache-write tokens across model calls in this turn.+ """++ total_cost_in_usd: typing.Optional[float] = pydantic.Field(default=None)+ """+ Estimated total cost in USD for this turn.+ """++ total_input_tokens: typing.Optional[int] = pydantic.Field(default=None)+ """+ Total input tokens across model calls in this turn.+ """++ total_output_tokens: typing.Optional[int] = pydantic.Field(default=None)+ """+ Total output tokens across model calls in this turn.+ """++ total_reasoning_tokens: typing.Optional[int] = pydantic.Field(default=None)+ """+ Total reasoning tokens across model calls in this turn.+ """++ total_tokens: typing.Optional[int] = pydantic.Field(default=None)+ """+ Total tokens (input + output) across model calls in this turn.+ """++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/turn_state_cancelled_reason.py b/python/trueforge_sdk/src/trueforge_sdk/types/turn_state_cancelled_reason.pynew file mode 100644index 000000000..40dfcb5b7--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/turn_state_cancelled_reason.py@@ -0,0 +1,46 @@+# This file was auto-generated by Fern from our API Definition.++import typing++from ..core import enum++T_Result = typing.TypeVar("T_Result")+++class TurnStateCancelledReason(enum.StrEnum):+ """+ Reason for the cancellation.+ """++ SERVER_EXECUTION_TIMEOUT = "server-execution-timeout"+ CLIENT_CANCELLED = "client-cancelled"+ CANCELLED_FOR_NEXT_TURN = "cancelled-for-next-turn"+ ABANDONED = "abandoned"+ _UNKNOWN = "__TURNSTATECANCELLEDREASON_UNKNOWN__"+ """+ This member is used for forward compatibility. If the value is not recognized by the enum, it will be stored here, and the raw value is accessible through `.value`.+ """++ @classmethod+ def _missing_(cls, value: typing.Any) -> "TurnStateCancelledReason":+ unknown = cls._UNKNOWN+ unknown._value_ = value+ return unknown++ def visit(+ self,+ server_execution_timeout: typing.Callable[[], T_Result],+ client_cancelled: typing.Callable[[], T_Result],+ cancelled_for_next_turn: typing.Callable[[], T_Result],+ abandoned: typing.Callable[[], T_Result],+ _unknown_member: typing.Callable[[str], T_Result],+ ) -> T_Result:+ if self is TurnStateCancelledReason.SERVER_EXECUTION_TIMEOUT:+ return server_execution_timeout()+ if self is TurnStateCancelledReason.CLIENT_CANCELLED:+ return client_cancelled()+ if self is TurnStateCancelledReason.CANCELLED_FOR_NEXT_TURN:+ return cancelled_for_next_turn()+ if self is TurnStateCancelledReason.ABANDONED:+ return abandoned()+ return _unknown_member(self._value_)diff --git a/python/trueforge_sdk/src/trueforge_sdk/types/turn_state_done.py b/python/trueforge_sdk/src/trueforge_sdk/types/turn_state_done.pynew file mode 100644index 000000000..17ab1bf82--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/turn_state_done.py@@ -0,0 +1,38 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .action_required_event import ActionRequiredEvent+from .model_message_event import ModelMessageEvent+from .turn_metrics import TurnMetrics+++class TurnStateDone(UncheckedBaseModel):+ completed_at: str = pydantic.Field()+ """+ ISO 8601 time when the turn reached a terminal state.+ """++ metrics: typing.Optional[TurnMetrics] = None+ output: typing.Optional[ModelMessageEvent] = pydantic.Field(default=None)+ """+ Final `model.message` for the turn, or null when the turn ended paused without a final message.+ """++ required_actions: typing.List[ActionRequiredEvent] = pydantic.Field()+ """+ Pending actions (`tool.approval_required`, `tool.response_required`, `mcp.auth_required`); empty when none.+ """++ status: typing.Literal["done"] = "done"++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/turn_state_error.py b/python/trueforge_sdk/src/trueforge_sdk/types/turn_state_error.pynew file mode 100644index 000000000..e61f1aa25--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/turn_state_error.py@@ -0,0 +1,35 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .turn_state_error_metrics import TurnStateErrorMetrics+++class TurnStateError(UncheckedBaseModel):+ completed_at: str = pydantic.Field()+ """+ ISO 8601 time when the error state was recorded.+ """++ message: str = pydantic.Field()+ """+ Human-readable error message.+ """++ metrics: typing.Optional[TurnStateErrorMetrics] = pydantic.Field(default=None)+ """+ Optional billable aggregate for work done before the error.+ """++ status: typing.Literal["error"] = "error"++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/turn_state_error_metrics.py b/python/trueforge_sdk/src/trueforge_sdk/types/turn_state_error_metrics.pynew file mode 100644index 000000000..161b6ceec--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/turn_state_error_metrics.py@@ -0,0 +1,56 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+++class TurnStateErrorMetrics(UncheckedBaseModel):+ """+ Optional billable aggregate for work done before the error.+ """++ total_cache_read_tokens: typing.Optional[int] = pydantic.Field(default=None)+ """+ Total cache-read tokens across model calls in this turn.+ """++ total_cache_write_tokens: typing.Optional[int] = pydantic.Field(default=None)+ """+ Total cache-write tokens across model calls in this turn.+ """++ total_cost_in_usd: typing.Optional[float] = pydantic.Field(default=None)+ """+ Estimated total cost in USD for this turn.+ """++ total_input_tokens: typing.Optional[int] = pydantic.Field(default=None)+ """+ Total input tokens across model calls in this turn.+ """++ total_output_tokens: typing.Optional[int] = pydantic.Field(default=None)+ """+ Total output tokens across model calls in this turn.+ """++ total_reasoning_tokens: typing.Optional[int] = pydantic.Field(default=None)+ """+ Total reasoning tokens across model calls in this turn.+ """++ total_tokens: typing.Optional[int] = pydantic.Field(default=None)+ """+ Total tokens (input + output) across model calls in this turn.+ """++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/turn_state_running.py b/python/trueforge_sdk/src/trueforge_sdk/types/turn_state_running.pynew file mode 100644index 000000000..b155b427b--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/turn_state_running.py@@ -0,0 +1,19 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+++class TurnStateRunning(UncheckedBaseModel):+ status: typing.Literal["running"] = "running"++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/turn_streaming_event.py b/python/trueforge_sdk/src/trueforge_sdk/types/turn_streaming_event.pynew file mode 100644index 000000000..be08f0c0a--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/turn_streaming_event.py@@ -0,0 +1,31 @@+# This file was auto-generated by Fern from our API Definition.++import typing++from .mcp_auth_required_event import McpAuthRequiredEvent+from .mcp_initialize_event import McpInitializeEvent+from .model_message_delta_event import ModelMessageDeltaEvent+from .model_message_event import ModelMessageEvent+from .sandbox_created_event import SandboxCreatedEvent+from .thread_created_event import ThreadCreatedEvent+from .thread_done_event import ThreadDoneEvent+from .tool_approval_required_event import ToolApprovalRequiredEvent+from .tool_response_event import ToolResponseEvent+from .tool_response_required_event import ToolResponseRequiredEvent+from .turn_created_event import TurnCreatedEvent+from .turn_done_event import TurnDoneEvent++TurnStreamingEvent = typing.Union[+ McpAuthRequiredEvent,+ McpInitializeEvent,+ ModelMessageEvent,+ ModelMessageDeltaEvent,+ SandboxCreatedEvent,+ ThreadCreatedEvent,+ ThreadDoneEvent,+ ToolApprovalRequiredEvent,+ ToolResponseEvent,+ ToolResponseRequiredEvent,+ TurnCreatedEvent,+ TurnDoneEvent,+]diff --git a/python/trueforge_sdk/src/trueforge_sdk/types/user_message.py b/python/trueforge_sdk/src/trueforge_sdk/types/user_message.pynew file mode 100644index 000000000..8f836984f--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/user_message.py@@ -0,0 +1,25 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .user_message_content import UserMessageContent+++class UserMessage(UncheckedBaseModel):+ content: UserMessageContent = pydantic.Field()+ """+ Plain string or structured text/file content parts.+ """++ type: typing.Literal["user.message"] = "user.message"++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/user_message_content.py b/python/trueforge_sdk/src/trueforge_sdk/types/user_message_content.pynew file mode 100644index 000000000..9eafe386f--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/user_message_content.py@@ -0,0 +1,7 @@+# This file was auto-generated by Fern from our API Definition.++import typing++from .user_message_content_item import UserMessageContentItem++UserMessageContent = typing.Union[str, typing.List[UserMessageContentItem]]diff --git a/python/trueforge_sdk/src/trueforge_sdk/types/user_message_content_item.py b/python/trueforge_sdk/src/trueforge_sdk/types/user_message_content_item.pynew file mode 100644index 000000000..258bb5305--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/user_message_content_item.py@@ -0,0 +1,8 @@+# This file was auto-generated by Fern from our API Definition.++import typing++from .file_content import FileContent+from .text_content import TextContent++UserMessageContentItem = typing.Union[FileContent, TextContent]diff --git a/python/trueforge_sdk/src/trueforge_sdk/types/user_tool_approval_event.py b/python/trueforge_sdk/src/trueforge_sdk/types/user_tool_approval_event.pynew file mode 100644index 000000000..79939dc2c--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/user_tool_approval_event.py@@ -0,0 +1,31 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .approval_decision import ApprovalDecision+++class UserToolApprovalEvent(UncheckedBaseModel):+ approval: ApprovalDecision+ thread_id: str = pydantic.Field()+ """+ Thread that owns the pending tool call.+ """++ tool_call_id: str = pydantic.Field()+ """+ Tool call id being approved or denied.+ """++ type: typing.Literal["user.tool_approval"] = "user.tool_approval"++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/user_tool_response_event.py b/python/trueforge_sdk/src/trueforge_sdk/types/user_tool_response_event.pynew file mode 100644index 000000000..0fa843bf1--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/user_tool_response_event.py@@ -0,0 +1,34 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+++class UserToolResponseEvent(UncheckedBaseModel):+ content: str = pydantic.Field()+ """+ Client-side tool result content.+ """++ thread_id: str = pydantic.Field()+ """+ Thread that owns the pending tool call.+ """++ tool_call_id: str = pydantic.Field()+ """+ Tool call id receiving the client response.+ """++ type: typing.Literal["user.tool_response"] = "user.tool_response"++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/zai_model_provider.py b/python/trueforge_sdk/src/trueforge_sdk/types/zai_model_provider.pynew file mode 100644index 000000000..9db33a1a2--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/zai_model_provider.py@@ -0,0 +1,32 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+from .configured_model import ConfiguredModel+from .model_provider_auth import ModelProviderAuth+++class ZaiModelProvider(UncheckedBaseModel):+ auth: ModelProviderAuth+ base_url: typing.Optional[str] = pydantic.Field(default="https://api.z.ai/api/paas/v4")+ """+ Override of the provider's default API base URL.+ """++ models: typing.List[ConfiguredModel] = pydantic.Field()+ """+ Models exposed by this provider (at least one).+ """++ type: typing.Literal["zai"] = "zai"++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/version.py b/python/trueforge_sdk/src/trueforge_sdk/version.pynew file mode 100644index 000000000..c28b650cf--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/version.py@@ -0,0 +1,3 @@+from importlib import metadata++__version__ = metadata.version("trueforge_sdk")diff --git a/python/trueforge_sdk/tests/conftest.py b/python/trueforge_sdk/tests/conftest.pynew file mode 100644index 000000000..25710dbe6--- /dev/null+++ b/python/trueforge_sdk/tests/conftest.py@@ -0,0 +1,21 @@+import pytest+++def _has_httpx_aiohttp() -> bool:+ """Check if httpx_aiohttp is importable."""+ try:+ import httpx_aiohttp # type: ignore[import-not-found] # noqa: F401++ return True+ except ImportError:+ return False+++def pytest_collection_modifyitems(config: pytest.Config, items: list) -> None:+ """Auto-skip @pytest.mark.aiohttp tests when httpx_aiohttp is not installed."""+ if _has_httpx_aiohttp():+ return+ skip_aiohttp = pytest.mark.skip(reason="httpx_aiohttp not installed")+ for item in items:+ if "aiohttp" in item.keywords:+ item.add_marker(skip_aiohttp)diff --git a/python/trueforge_sdk/tests/test_aiohttp_autodetect.py b/python/trueforge_sdk/tests/test_aiohttp_autodetect.pynew file mode 100644index 000000000..263bb3c01--- /dev/null+++ b/python/trueforge_sdk/tests/test_aiohttp_autodetect.py@@ -0,0 +1,116 @@+import importlib+import sys+import unittest+from unittest import mock++import httpx+import pytest+++class TestMakeDefaultAsyncClientWithoutAiohttp(unittest.TestCase):+ """Tests for _make_default_async_client when httpx_aiohttp is NOT installed."""++ def test_returns_httpx_async_client(self) -> None:+ """When httpx_aiohttp is not installed, returns plain httpx.AsyncClient."""+ with mock.patch.dict(sys.modules, {"httpx_aiohttp": None}):+ from trueforge_sdk.base_client import _make_default_async_client++ client = _make_default_async_client(timeout=60, follow_redirects=True)+ self.assertIsInstance(client, httpx.AsyncClient)+ self.assertEqual(client.timeout.read, 60)+ self.assertTrue(client.follow_redirects)++ def test_follow_redirects_none(self) -> None:+ """When follow_redirects is None, omits it from httpx.AsyncClient."""+ with mock.patch.dict(sys.modules, {"httpx_aiohttp": None}):+ from trueforge_sdk.base_client import _make_default_async_client++ client = _make_default_async_client(timeout=60, follow_redirects=None)+ self.assertIsInstance(client, httpx.AsyncClient)+ self.assertFalse(client.follow_redirects)++ def test_explicit_httpx_client_bypasses_autodetect(self) -> None:+ """When user passes httpx_client explicitly, _make_default_async_client is not called."""++ explicit_client = httpx.AsyncClient(timeout=120)+ with mock.patch("trueforge_sdk.base_client._make_default_async_client") as mock_make:+ # Replicate the generated conditional: httpx_client if httpx_client is not None else _make_default_async_client(...)+ result = explicit_client if explicit_client is not None else mock_make(timeout=60, follow_redirects=True)+ mock_make.assert_not_called()+ self.assertIs(result, explicit_client)+++class TestMakeDefaultAsyncClientWithAiohttp(unittest.TestCase):+ """Tests for _make_default_async_client when httpx_aiohttp IS installed."""++ def test_returns_aiohttp_client(self) -> None:+ """When httpx_aiohttp is installed, returns HttpxAiohttpClient."""+ import httpx_aiohttp # type: ignore[import-not-found]++ from trueforge_sdk.base_client import _make_default_async_client++ client = _make_default_async_client(timeout=60, follow_redirects=True)+ self.assertIsInstance(client, httpx_aiohttp.HttpxAiohttpClient)+ self.assertEqual(client.timeout.read, 60)+ self.assertTrue(client.follow_redirects)++ def test_follow_redirects_none(self) -> None:+ """When httpx_aiohttp is installed and follow_redirects is None, omits it."""+ import httpx_aiohttp # type: ignore[import-not-found]++ from trueforge_sdk.base_client import _make_default_async_client++ client = _make_default_async_client(timeout=60, follow_redirects=None)+ self.assertIsInstance(client, httpx_aiohttp.HttpxAiohttpClient)+ self.assertFalse(client.follow_redirects)+++class TestDefaultClientsWithoutAiohttp(unittest.TestCase):+ """Tests for _default_clients.py convenience classes (no aiohttp)."""++ def test_default_async_httpx_client_defaults(self) -> None:+ """DefaultAsyncHttpxClient applies SDK defaults."""+ from trueforge_sdk._default_clients import SDK_DEFAULT_TIMEOUT, DefaultAsyncHttpxClient++ client = DefaultAsyncHttpxClient()+ self.assertIsInstance(client, httpx.AsyncClient)+ self.assertEqual(client.timeout.read, SDK_DEFAULT_TIMEOUT)+ self.assertTrue(client.follow_redirects)++ def test_default_async_httpx_client_overrides(self) -> None:+ """DefaultAsyncHttpxClient allows overriding defaults."""+ from trueforge_sdk._default_clients import DefaultAsyncHttpxClient++ client = DefaultAsyncHttpxClient(timeout=30, follow_redirects=False)+ self.assertEqual(client.timeout.read, 30)+ self.assertFalse(client.follow_redirects)++ def test_default_aiohttp_client_raises_without_package(self) -> None:+ """DefaultAioHttpClient raises RuntimeError when httpx_aiohttp not installed."""+ import trueforge_sdk._default_clients++ with mock.patch.dict(sys.modules, {"httpx_aiohttp": None}):+ importlib.reload(trueforge_sdk._default_clients)++ with self.assertRaises(RuntimeError) as ctx:+ trueforge_sdk._default_clients.DefaultAioHttpClient()+ self.assertIn("pip install trueforge_sdk[aiohttp]", str(ctx.exception))++ importlib.reload(trueforge_sdk._default_clients)+++class TestDefaultClientsWithAiohttp(unittest.TestCase):+ """Tests for _default_clients.py when httpx_aiohttp IS installed."""++ def test_default_aiohttp_client_defaults(self) -> None:+ """DefaultAioHttpClient works when httpx_aiohttp is installed."""+ import httpx_aiohttp # type: ignore[import-not-found]++ from trueforge_sdk._default_clients import SDK_DEFAULT_TIMEOUT, DefaultAioHttpClient++ client = DefaultAioHttpClient()+ self.assertIsInstance(client, httpx_aiohttp.HttpxAiohttpClient)+ self.assertEqual(client.timeout.read, SDK_DEFAULT_TIMEOUT)+ self.assertTrue(client.follow_redirects)diff --git a/scripts/generate-sdk.sh b/scripts/generate-sdk.shindex 39dcc0453..fac7967a2 100755--- a/scripts/generate-sdk.sh+++ b/scripts/generate-sdk.sh@@ -1,5 +1,6 @@#!/usr/bin/env bash-# Regenerates OpenAPI (.github/fern + docs/) and packages/trueforge-sdk (same steps as CI).+# Regenerates OpenAPI (.github/fern + docs/), packages/trueforge-sdk, and+# python/trueforge_sdk (same steps as CI).# Requires Docker (Fern --local) and network access for the Fern CLI/image.set -euo pipefail@@ -12,16 +13,22 @@ fern() {(cd .github && pnpm dlx "fern-api@${fern_version}" "$@")}-# Fern --version stamps package.json and baked-in TS literals (SDK_VERSION,-# User-Agent). Pass the version already in package.json so a regen never stomps-# a version changesets (or a human) already set.+# Fern --version stamps package metadata and baked-in SDK version / User-Agent.+# Pass the version already in the TS package.json so a regen never stomps a+# version Changesets (or a human) already set. TS and Python stay on the same+# SemVer (both groups get --version "$current_version"); PyPI publish wiring is+# separate.current_version="$(node -p "require('./packages/trueforge-sdk/package.json').version")"pnpm --filter @truefoundry/trueforge-core buildpnpm openapi:writefern check-# --force skips the overwrite prompt when packages/trueforge-sdk already exists (needed non-interactively / in CI).+# --force skips the overwrite prompt when the SDK dirs already exist (needed non-interactively / in CI).fern generate --group ts-sdk --version "$current_version" --local --generate-tests --force --log-level debug+fern generate --group python-sdk --version "$current_version" --local --generate-tests --force --log-level debug+test -f python/trueforge_sdk/src/trueforge_sdk/client.py++# Dist name is Fern package_name (trueforge_sdk); pip install trueforge-sdk works via PEP 503.# Fern's generated verify.sh runs `pnpm install` from packages/trueforge-sdk, which now# resolves to this workspace. CI sets frozen-lockfile, so refresh the root# lockfile first or that install fails when the generator added/removed deps.