# autnhive-devsecops-org/sami-sdk-python architecture

> Architecture diagram of the GitHub repository autnhive-devsecops-org/sami-sdk-python, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/autnhive-devsecops-org/sami-sdk-python
- Repository: https://github.com/autnhive-devsecops-org/sami-sdk-python

## Overview

This is a generated Python SDK for the SAMI firewall API. A caller builds validated request models, invokes a generated endpoint method, and the shared client serializes/authenticates the request, sends HTTP, then deserializes the response or raises an API exception. The README documents text chat, multimodal chat, and file sanitization; the sampled implementation shows the endpoint-to-client path but not server-side behavior. The graph focuses on runtime components and the documented endpoint capabilities.

Main entry points: [`sami_firewall_client/api_client.py`](https://github.com/autnhive-devsecops-org/sami-sdk-python/blob/master/sami_firewall_client/api_client.py) (API client), [`sami_firewall_client/api/chat_api.py`](https://github.com/autnhive-devsecops-org/sami-sdk-python/blob/master/sami_firewall_client/api/chat_api.py) (Text chat), [`sami_firewall_client/api/default_api.py`](https://github.com/autnhive-devsecops-org/sami-sdk-python/blob/master/sami_firewall_client/api/default_api.py) (Other endpoints), [`sami_firewall_client/models/chat_completion_request.py`](https://github.com/autnhive-devsecops-org/sami-sdk-python/blob/master/sami_firewall_client/models/chat_completion_request.py) (Chat request)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_endpoints["API endpoints"]
  node_chat_api["Text chat<br/>[chat_api.py]"]
  node_default_api["Other endpoints<br/>[default_api.py]"]
end

subgraph group_models["Request and response models"]
  node_chat_request["Chat request"]
  node_chat_message["Chat message<br/>[chat_message.py]"]
  node_signed_payload["Signed URL batch"]
  node_job["Sanitization job<br/>[job.py]"]
  node_validation_error["Validation error"]
  node_location["Error location<br/>[location_inner.py]"]
  node_http_validation["HTTP validation"]
end

subgraph group_transport["Client and transport"]
  node_configuration["Configuration<br/>[configuration.py]"]
  node_api_client["API client<br/>[api_client.py]"]
  node_api_response["Response wrapper<br/>[api_response.py]"]
  node_rest["HTTP transport<br/>[rest.py]"]
end

subgraph group_errors["Errors"]
  node_api_exception["API exceptions<br/>[exceptions.py]"]
end

node_caller(("SDK caller"))
node_firewall_service["SAMI firewall API"]

node_caller -->|"calls"| node_chat_api
node_caller -->|"calls"| node_default_api
node_caller -->|"builds"| node_chat_request
node_chat_request -->|"contains"| node_chat_message
node_signed_payload -->|"contains"| node_job
node_validation_error -->|"contains"| node_location
node_http_validation -->|"uses"| node_validation_error
node_chat_api -->|"serializes"| node_chat_request
node_chat_api -->|"dispatches"| node_api_client
node_default_api -->|"serializes"| node_signed_payload
node_default_api -->|"dispatches"| node_api_client
node_api_client -->|"uses"| node_configuration
node_api_client -->|"sends HTTP"| node_rest
node_api_client -->|"builds response"| node_api_response
node_api_client -->|"raises"| node_api_exception
node_chat_api -->|"POST chat"| node_firewall_service
node_default_api -->|"POST endpoints"| node_firewall_service

click node_chat_api "https://github.com/autnhive-devsecops-org/sami-sdk-python/blob/master/sami_firewall_client/api/chat_api.py"
click node_default_api "https://github.com/autnhive-devsecops-org/sami-sdk-python/blob/master/sami_firewall_client/api/default_api.py"
click node_chat_request "https://github.com/autnhive-devsecops-org/sami-sdk-python/blob/master/sami_firewall_client/models/chat_completion_request.py"
click node_chat_message "https://github.com/autnhive-devsecops-org/sami-sdk-python/blob/master/sami_firewall_client/models/chat_message.py"
click node_signed_payload "https://github.com/autnhive-devsecops-org/sami-sdk-python/blob/master/sami_firewall_client/models/signed_url_payload.py"
click node_job "https://github.com/autnhive-devsecops-org/sami-sdk-python/blob/master/sami_firewall_client/models/job.py"
click node_validation_error "https://github.com/autnhive-devsecops-org/sami-sdk-python/blob/master/sami_firewall_client/models/validation_error.py"
click node_location "https://github.com/autnhive-devsecops-org/sami-sdk-python/blob/master/sami_firewall_client/models/location_inner.py"
click node_http_validation "https://github.com/autnhive-devsecops-org/sami-sdk-python/blob/master/sami_firewall_client/models/http_validation_error.py"
click node_configuration "https://github.com/autnhive-devsecops-org/sami-sdk-python/blob/master/sami_firewall_client/configuration.py"
click node_api_client "https://github.com/autnhive-devsecops-org/sami-sdk-python/blob/master/sami_firewall_client/api_client.py"
click node_api_response "https://github.com/autnhive-devsecops-org/sami-sdk-python/blob/master/sami_firewall_client/api_response.py"
click node_rest "https://github.com/autnhive-devsecops-org/sami-sdk-python/blob/master/sami_firewall_client/rest.py"
click node_api_exception "https://github.com/autnhive-devsecops-org/sami-sdk-python/blob/master/sami_firewall_client/exceptions.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_chat_api,node_default_api toneBlue
class node_chat_request,node_chat_message,node_signed_payload,node_job,node_validation_error,node_location,node_http_validation toneAmber
class node_configuration,node_api_client,node_api_response,node_rest,node_firewall_service toneMint
class node_api_exception toneRose
class node_caller toneIndigo
```

## Components

### API endpoints

- [Text chat](https://github.com/autnhive-devsecops-org/sami-sdk-python/blob/master/sami_firewall_client/api/chat_api.py): `sami_firewall_client/api/chat_api.py`
- [Other endpoints](https://github.com/autnhive-devsecops-org/sami-sdk-python/blob/master/sami_firewall_client/api/default_api.py): `sami_firewall_client/api/default_api.py`

### Request and response models

- [Chat request](https://github.com/autnhive-devsecops-org/sami-sdk-python/blob/master/sami_firewall_client/models/chat_completion_request.py): `sami_firewall_client/models/chat_completion_request.py`
- [Chat message](https://github.com/autnhive-devsecops-org/sami-sdk-python/blob/master/sami_firewall_client/models/chat_message.py): `sami_firewall_client/models/chat_message.py`
- [Signed URL batch](https://github.com/autnhive-devsecops-org/sami-sdk-python/blob/master/sami_firewall_client/models/signed_url_payload.py): `sami_firewall_client/models/signed_url_payload.py`
- [Sanitization job](https://github.com/autnhive-devsecops-org/sami-sdk-python/blob/master/sami_firewall_client/models/job.py): `sami_firewall_client/models/job.py`
- [Validation error](https://github.com/autnhive-devsecops-org/sami-sdk-python/blob/master/sami_firewall_client/models/validation_error.py): `sami_firewall_client/models/validation_error.py`
- [Error location](https://github.com/autnhive-devsecops-org/sami-sdk-python/blob/master/sami_firewall_client/models/location_inner.py): `sami_firewall_client/models/location_inner.py`
- [HTTP validation](https://github.com/autnhive-devsecops-org/sami-sdk-python/blob/master/sami_firewall_client/models/http_validation_error.py): `sami_firewall_client/models/http_validation_error.py`

### Client and transport

- [Configuration](https://github.com/autnhive-devsecops-org/sami-sdk-python/blob/master/sami_firewall_client/configuration.py): `sami_firewall_client/configuration.py`
- [API client](https://github.com/autnhive-devsecops-org/sami-sdk-python/blob/master/sami_firewall_client/api_client.py): `sami_firewall_client/api_client.py`
- [Response wrapper](https://github.com/autnhive-devsecops-org/sami-sdk-python/blob/master/sami_firewall_client/api_response.py): `sami_firewall_client/api_response.py`
- [HTTP transport](https://github.com/autnhive-devsecops-org/sami-sdk-python/blob/master/sami_firewall_client/rest.py): `sami_firewall_client/rest.py`

### Errors

- [API exceptions](https://github.com/autnhive-devsecops-org/sami-sdk-python/blob/master/sami_firewall_client/exceptions.py): `sami_firewall_client/exceptions.py`

### Other components

- **SDK caller**
- **SAMI firewall API**

## Connections

- SDK caller → Text chat: calls (evidence: `README.md`)
- SDK caller → Other endpoints: calls (evidence: `README.md`)
- SDK caller → Chat request: builds (evidence: `README.md`)
- Chat request → Chat message: contains (evidence: `sami_firewall_client/models/chat_completion_request.py`)
- Signed URL batch → Sanitization job: contains (evidence: `sami_firewall_client/models/signed_url_payload.py`)
- Validation error → Error location: contains (evidence: `sami_firewall_client/models/validation_error.py`)
- HTTP validation → Validation error: uses (evidence: `sami_firewall_client/models/http_validation_error.py`)
- Text chat → Chat request: serializes (evidence: `sami_firewall_client/api/chat_api.py`)
- Text chat → API client: dispatches (evidence: `sami_firewall_client/api/chat_api.py`)
- Other endpoints → Signed URL batch: serializes (evidence: `sami_firewall_client/api/default_api.py`)
- Other endpoints → API client: dispatches (evidence: `sami_firewall_client/api/default_api.py`)
- API client → Configuration: uses (evidence: `sami_firewall_client/api_client.py`)
- API client → HTTP transport: sends HTTP (evidence: `sami_firewall_client/api_client.py`)
- API client → Response wrapper: builds response (evidence: `sami_firewall_client/api_client.py`)
- API client → API exceptions: raises (evidence: `sami_firewall_client/api_client.py`)
- Text chat → SAMI firewall API: POST chat (evidence: `README.md`)
- Other endpoints → SAMI firewall API: POST endpoints (evidence: `README.md`)
