> This page is for version Latest (default).
> For other versions, use one of these documentation indexes:
> - Latest (default): https://docs.nvidia.com/nemo/guardrails/latest/llms.txt
> - v0.25.0: https://docs.nvidia.com/nemo/guardrails/v0.25.0/llms.txt
> - v0.24.1: https://docs.nvidia.com/nemo/guardrails/v0.24.1/llms.txt
> - v0.24.0: https://docs.nvidia.com/nemo/guardrails/v0.24.0/llms.txt
> - v0.23.0: https://docs.nvidia.com/nemo/guardrails/v0.23.0/llms.txt
> - v0.22.0: https://docs.nvidia.com/nemo/guardrails/v0.22.0/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.nvidia.com/nemo/guardrails/llms.txt.

# nemoguardrails.server.experimental.provider.contract_export

Export guard contracts from trusted Python endpoint declarations.

Provider integrations supply an endpoint and document identity, not exporter
implementations. Model annotations describe payload policy; endpoint metadata
describes the route and rejection codes. Exporting does not enable runtime
features or serialize arbitrary Python validation and transport behavior.

The CLI imports one explicitly selected module attribute. That import executes
Python code: use only trusted local endpoint declarations, never references from
requests or untrusted documents. YAML and JSON Schema tooling is loaded only by
the CLI; runtime endpoint construction does not depend on this module.

## Module Contents

### Functions

| Name                                                                                                                  | Description                                                                               |
| --------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
| [`_export_stream`](#nemoguardrails-server-experimental-provider-contract_export-_export_stream)                       | Export supported classifier declarations, never instantiate or serialize protocol hooks.  |
| [`_export_stream_event`](#nemoguardrails-server-experimental-provider-contract_export-_export_stream_event)           | Describe a typed event rule without dropping unsupported selection or fallback semantics. |
| [`_load_endpoint`](#nemoguardrails-server-experimental-provider-contract_export-_load_endpoint)                       | Import one trusted module attribute for the CLI, without discovery or eval.               |
| [`_validate_policy_binding`](#nemoguardrails-server-experimental-provider-contract_export-_validate_policy_binding)   | Reject drift between supported runtime bindings and exported field policy.                |
| [`_validate_stream_model`](#nemoguardrails-server-experimental-provider-contract_export-_validate_stream_model)       | Reject custom stream validation that cannot be described by field policy.                 |
| [`_validate_stream_selector`](#nemoguardrails-server-experimental-provider-contract_export-_validate_stream_selector) | Require declarative strict-boolean selection with a representable default.                |
| [`_validator_function`](#nemoguardrails-server-experimental-provider-contract_export-_validator_function)             | -                                                                                         |
| [`export_guard_contract`](#nemoguardrails-server-experimental-provider-contract_export-export_guard_contract)         | Describe the payload and stream policy actually bound to an endpoint.                     |
| [`main`](#nemoguardrails-server-experimental-provider-contract_export-main)                                           | Validate and emit a guard contract, or check an artifact for exact drift.                 |

### API

```python
nemoguardrails.server.experimental.provider.contract_export._export_stream(
    binding: nemoguardrails.server.experimental.provider.stream.StreamBinding
) -> dict[str, typing.Any]
```

Export supported classifier declarations, never instantiate or serialize protocol hooks.

```python
nemoguardrails.server.experimental.provider.contract_export._export_stream_event(
    rule: nemoguardrails.server.experimental.provider.stream_classifier.StreamEventRule
) -> dict[str, typing.Any]
```

Describe a typed event rule without dropping unsupported selection or fallback semantics.

```python
nemoguardrails.server.experimental.provider.contract_export._load_endpoint(
    reference: str
) -> nemoguardrails.server.experimental.provider.endpoint.GuardedJsonEndpoint
```

Import one trusted module attribute for the CLI, without discovery or eval.

```python
nemoguardrails.server.experimental.provider.contract_export._validate_policy_binding(
    model: type[nemoguardrails.server.experimental.provider.payload.GuardedPayloadModel],
    direction: typing.Literal['request', 'response']
) -> nemoguardrails.server.experimental.provider.payload.PayloadProjectionContract
```

Reject drift between supported runtime bindings and exported field policy.

```python
nemoguardrails.server.experimental.provider.contract_export._validate_stream_model(
    model: type[nemoguardrails.server.experimental.provider.projection_policy.PolicyModel]
) -> None
```

Reject custom stream validation that cannot be described by field policy.

```python
nemoguardrails.server.experimental.provider.contract_export._validate_stream_selector(
    model: type[nemoguardrails.server.experimental.provider.payload.GuardedRequestModel]
) -> None
```

Require declarative strict-boolean selection with a representable default.

```python
nemoguardrails.server.experimental.provider.contract_export._validator_function(
    validator: typing.Any
) -> typing.Any
```

```python
nemoguardrails.server.experimental.provider.contract_export.export_guard_contract(
    endpoint: nemoguardrails.server.experimental.provider.endpoint.GuardedJsonEndpoint
) -> dict[str, typing.Any]
```

Describe the payload and stream policy actually bound to an endpoint.

No files are read or written. The CLI separately validates the document
format; neither step proves upstream compatibility or runtime equivalence.

**Parameters:**

**`endpoint`** `GuardedJsonEndpoint`

[`GuardedJsonEndpoint`](/nemo/guardrails/guardrails-python-sdk/nemoguardrails/server/experimental/provider/endpoint#nemoguardrails-server-experimental-provider-endpoint-GuardedJsonEndpoint) — A trusted endpoint with policy-annotated request and response
models and their runtime bindings.

---

**Returns:** `dict[str, Any]`

A fresh document with payload schemas, profile, endpoint labels, and

**Raises:**

* `TypeError`: The endpoint or its models do not support policy export.
* `ValueError`: Bound coverage, extraction, replacement, or stream selection
  disagrees with the field policy, or a schema construct is unsupported.

```python
nemoguardrails.server.experimental.provider.contract_export.main() -> None
```

Validate and emit a guard contract, or check an artifact for exact drift.

The endpoint argument imports trusted Python code. With --output, create
parent directories and overwrite the selected file. With --check, leave files
untouched and exit with status 1 on missing or differing content. With neither
option, write YAML to stdout. Invalid declarations fail before file writes.