# cdot65/prisma-airs-sdk architecture

> Architecture diagram of the GitHub repository cdot65/prisma-airs-sdk, 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/cdot65/prisma-airs-sdk
- Repository: https://github.com/cdot65/prisma-airs-sdk

## Overview

Prisma AIRS SDK is a TypeScript client library for configuring and operating four AIRS service domains. Users configure credentials and instantiate a domain client, then issue typed requests for scanning, management, model security, gateway operations, or red-team workflows and receive validated results. Gateway SCM administration and runtime inference use distinct credentials and endpoints. Shared OAuth, pagination, and HTTP transport support the domain clients. The README documents capabilities whose implementation was not sampled; edges for those are based on that documentation, not inspection of their source.

Main entry points: [`src/management/client.ts`](https://github.com/cdot65/prisma-airs-sdk/blob/main/src/management/client.ts) (Management client), [`src/red-team/client.ts`](https://github.com/cdot65/prisma-airs-sdk/blob/main/src/red-team/client.ts) (Red team client), [`src/http/request.ts`](https://github.com/cdot65/prisma-airs-sdk/blob/main/src/http/request.ts) (HTTP request pipeline), [`src/scan/scanner.ts`](https://github.com/cdot65/prisma-airs-sdk/blob/main/src/scan/scanner.ts) (Scanner)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_transport["Shared transport"]
  node_oauthconfig["OAuth configuration<br/>[oauth-config.ts]"]
  node_oauth["OAuth token client<br/>[oauth-client.ts]"]
  node_http["HTTP request pipeline<br/>[request.ts]"]
  node_pagination["Pagination helpers<br/>[listing.ts]"]
  node_models["Typed models"]
end

subgraph group_runtime["Runtime security"]
  node_runtimeclient["Scanner<br/>[scanner.ts]"]
  node_scancontent["Scan content<br/>[content.ts]"]
end

subgraph group_management["Management"]
  node_managementclient["Management client<br/>[client.ts]"]
  node_mgmtresources["Profiles and DLP<br/>[profiles.ts]"]
  node_dashboard["Dashboard and logs<br/>[dashboard.ts]"]
  node_iam["IAM scopes<br/>[scopes-client.ts]"]
end

subgraph group_gateway["AI Gateway"]
  node_gatewayclient["Gateway SCM client<br/>[client.ts]"]
  node_gatewayresources["Gateway administration"]
  node_inference["Runtime inference"]
  node_runtime_resources["Runtime resources"]
  node_pricing["Public model pricing"]
end

subgraph group_modelsec["Model security"]
  node_modelclient["Model security client<br/>[client.ts]"]
  node_modelscans["Model scans<br/>[scans-client.ts]"]
  node_modelrules["Security groups and rules"]
end

subgraph group_redteam["AI red teaming"]
  node_redteamclient["Red team client<br/>[client.ts]"]
  node_redscans["Red team scans<br/>[scans-client.ts]"]
  node_redreports["Reports and targets<br/>[reports-client.ts]"]
  node_customattacks["Custom attacks"]
end

node_developer(("SDK user"))
node_airs{{"Prisma AIRS services"}}
node_gatewayruntime{{"Gateway runtime service"}}
node_pricingservice{{"Public pricing service"}}

node_developer -->|"creates and scans"| node_runtimeclient
node_runtimeclient -->|"accepts content"| node_scancontent
node_runtimeclient -->|"sends requests"| node_http
node_runtimeclient -->|"scans content"| node_airs
node_developer -->|"configures and calls"| node_managementclient
node_managementclient -->|"resolves credentials"| node_oauthconfig
node_oauthconfig -->|"creates client"| node_oauth
node_managementclient -->|"exposes resources"| node_mgmtresources
node_managementclient -->|"exposes dashboard"| node_dashboard
node_managementclient -->|"sends requests"| node_http
node_mgmtresources -->|"uses pagination"| node_pagination
node_managementclient -->|"manages configuration"| node_airs
node_developer -->|"configures and calls"| node_gatewayclient
node_gatewayclient -->|"exposes administration"| node_gatewayresources
node_gatewayclient -->|"exposes IAM scopes"| node_iam
node_gatewayclient -->|"uses OAuth setup"| node_oauthconfig
node_gatewayresources -->|"sends requests"| node_http
node_gatewayclient -->|"manages gateway"| node_airs
node_developer -->|"sets runtime credentials"| node_inference
node_inference -->|"exposes runtime operations"| node_runtime_resources
node_inference -->|"sends requests"| node_http
node_inference -->|"runs inference"| node_gatewayruntime
node_developer -->|"requests catalog"| node_pricing
node_pricing -->|"fetches public rates"| node_pricingservice
node_developer -->|"configures and calls"| node_modelclient
node_modelclient -->|"exposes scans"| node_modelscans
node_modelclient -->|"exposes rule management"| node_modelrules
node_modelscans -->|"sends requests"| node_http
node_modelscans -->|"uses pagination"| node_pagination
node_modelclient -->|"uses OAuth setup"| node_oauthconfig
node_modelclient -->|"secures models"| node_airs
node_developer -->|"configures and calls"| node_redteamclient
node_redteamclient -->|"exposes scans"| node_redscans
node_redteamclient -->|"exposes reports"| node_redreports
node_redteamclient -->|"exposes custom attacks"| node_customattacks
node_redscans -->|"sends requests"| node_http
node_redscans -->|"uses pagination"| node_pagination
node_redteamclient -->|"uses OAuth setup"| node_oauthconfig
node_redteamclient -->|"runs red-team workflows"| node_airs
node_runtimeclient -->|"uses scan models"| node_models
node_modelscans -->|"uses typed models"| node_models
node_redscans -->|"uses typed models"| node_models

click node_oauthconfig "https://github.com/cdot65/prisma-airs-sdk/blob/main/src/oauth-config.ts"
click node_oauth "https://github.com/cdot65/prisma-airs-sdk/blob/main/src/management/oauth-client.ts"
click node_http "https://github.com/cdot65/prisma-airs-sdk/blob/main/src/http/request.ts"
click node_pagination "https://github.com/cdot65/prisma-airs-sdk/blob/main/src/listing.ts"
click node_models "https://github.com/cdot65/prisma-airs-sdk/tree/main/src/models"
click node_runtimeclient "https://github.com/cdot65/prisma-airs-sdk/blob/main/src/scan/scanner.ts"
click node_scancontent "https://github.com/cdot65/prisma-airs-sdk/blob/main/src/scan/content.ts"
click node_managementclient "https://github.com/cdot65/prisma-airs-sdk/blob/main/src/management/client.ts"
click node_mgmtresources "https://github.com/cdot65/prisma-airs-sdk/blob/main/src/management/profiles.ts"
click node_dashboard "https://github.com/cdot65/prisma-airs-sdk/blob/main/src/management/dashboard.ts"
click node_iam "https://github.com/cdot65/prisma-airs-sdk/blob/main/src/iam/scopes-client.ts"
click node_gatewayclient "https://github.com/cdot65/prisma-airs-sdk/blob/main/src/ai-gateway/client.ts"
click node_gatewayresources "https://github.com/cdot65/prisma-airs-sdk/blob/main/src/ai-gateway/workspaces-client.ts"
click node_inference "https://github.com/cdot65/prisma-airs-sdk/blob/main/src/ai-gateway/inference-client.ts"
click node_runtime_resources "https://github.com/cdot65/prisma-airs-sdk/blob/main/src/ai-gateway/runtime-resources-client.ts"
click node_pricing "https://github.com/cdot65/prisma-airs-sdk/blob/main/src/ai-gateway/model-pricing-client.ts"
click node_modelclient "https://github.com/cdot65/prisma-airs-sdk/blob/main/src/model-security/client.ts"
click node_modelscans "https://github.com/cdot65/prisma-airs-sdk/blob/main/src/model-security/scans-client.ts"
click node_modelrules "https://github.com/cdot65/prisma-airs-sdk/blob/main/src/model-security/security-groups-client.ts"
click node_redteamclient "https://github.com/cdot65/prisma-airs-sdk/blob/main/src/red-team/client.ts"
click node_redscans "https://github.com/cdot65/prisma-airs-sdk/blob/main/src/red-team/scans-client.ts"
click node_redreports "https://github.com/cdot65/prisma-airs-sdk/blob/main/src/red-team/reports-client.ts"
click node_customattacks "https://github.com/cdot65/prisma-airs-sdk/blob/main/src/red-team/custom-attacks-client.ts"

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_oauthconfig,node_oauth,node_http,node_pagination,node_models,node_developer toneBlue
class node_runtimeclient,node_scancontent toneAmber
class node_managementclient,node_mgmtresources,node_dashboard,node_iam toneMint
class node_gatewayclient,node_gatewayresources,node_inference,node_runtime_resources,node_pricing toneRose
class node_modelclient,node_modelscans,node_modelrules,node_airs,node_gatewayruntime,node_pricingservice toneIndigo
class node_redteamclient,node_redscans,node_redreports,node_customattacks toneTeal
```

## Components

### Shared transport

- [OAuth configuration](https://github.com/cdot65/prisma-airs-sdk/blob/main/src/oauth-config.ts): `src/oauth-config.ts`
- [OAuth token client](https://github.com/cdot65/prisma-airs-sdk/blob/main/src/management/oauth-client.ts): `src/management/oauth-client.ts`
- [HTTP request pipeline](https://github.com/cdot65/prisma-airs-sdk/blob/main/src/http/request.ts): `src/http/request.ts`
- [Pagination helpers](https://github.com/cdot65/prisma-airs-sdk/blob/main/src/listing.ts): `src/listing.ts`
- [Typed models](https://github.com/cdot65/prisma-airs-sdk/tree/main/src/models): `src/models`

### Runtime security

- [Scanner](https://github.com/cdot65/prisma-airs-sdk/blob/main/src/scan/scanner.ts): `src/scan/scanner.ts`
- [Scan content](https://github.com/cdot65/prisma-airs-sdk/blob/main/src/scan/content.ts): `src/scan/content.ts`

### Management

- [Management client](https://github.com/cdot65/prisma-airs-sdk/blob/main/src/management/client.ts): `src/management/client.ts`
- [Profiles and DLP](https://github.com/cdot65/prisma-airs-sdk/blob/main/src/management/profiles.ts): `src/management/profiles.ts`
- [Dashboard and logs](https://github.com/cdot65/prisma-airs-sdk/blob/main/src/management/dashboard.ts): `src/management/dashboard.ts`
- [IAM scopes](https://github.com/cdot65/prisma-airs-sdk/blob/main/src/iam/scopes-client.ts): `src/iam/scopes-client.ts`

### AI Gateway

- [Gateway SCM client](https://github.com/cdot65/prisma-airs-sdk/blob/main/src/ai-gateway/client.ts): `src/ai-gateway/client.ts`
- [Gateway administration](https://github.com/cdot65/prisma-airs-sdk/blob/main/src/ai-gateway/workspaces-client.ts): `src/ai-gateway/workspaces-client.ts`
- [Runtime inference](https://github.com/cdot65/prisma-airs-sdk/blob/main/src/ai-gateway/inference-client.ts): `src/ai-gateway/inference-client.ts`
- [Runtime resources](https://github.com/cdot65/prisma-airs-sdk/blob/main/src/ai-gateway/runtime-resources-client.ts): `src/ai-gateway/runtime-resources-client.ts`
- [Public model pricing](https://github.com/cdot65/prisma-airs-sdk/blob/main/src/ai-gateway/model-pricing-client.ts): `src/ai-gateway/model-pricing-client.ts`

### Model security

- [Model security client](https://github.com/cdot65/prisma-airs-sdk/blob/main/src/model-security/client.ts): `src/model-security/client.ts`
- [Model scans](https://github.com/cdot65/prisma-airs-sdk/blob/main/src/model-security/scans-client.ts): `src/model-security/scans-client.ts`
- [Security groups and rules](https://github.com/cdot65/prisma-airs-sdk/blob/main/src/model-security/security-groups-client.ts): `src/model-security/security-groups-client.ts`

### AI red teaming

- [Red team client](https://github.com/cdot65/prisma-airs-sdk/blob/main/src/red-team/client.ts): `src/red-team/client.ts`
- [Red team scans](https://github.com/cdot65/prisma-airs-sdk/blob/main/src/red-team/scans-client.ts): `src/red-team/scans-client.ts`
- [Reports and targets](https://github.com/cdot65/prisma-airs-sdk/blob/main/src/red-team/reports-client.ts): `src/red-team/reports-client.ts`
- [Custom attacks](https://github.com/cdot65/prisma-airs-sdk/blob/main/src/red-team/custom-attacks-client.ts): `src/red-team/custom-attacks-client.ts`

### Other components

- **SDK user**
- **Prisma AIRS services**
- **Gateway runtime service**
- **Public pricing service**

## Connections

- SDK user → Scanner: creates and scans (evidence: `README.md`)
- Scanner → Scan content: accepts content (evidence: `src/scan/scanner.ts`)
- Scanner → HTTP request pipeline: sends requests (evidence: `src/scan/scanner.ts`)
- Scanner → Prisma AIRS services: scans content (evidence: `README.md`)
- SDK user → Management client: configures and calls (evidence: `README.md`)
- Management client → OAuth configuration: resolves credentials (evidence: `src/management/client.ts`)
- OAuth configuration → OAuth token client: creates client (evidence: `src/oauth-config.ts`)
- Management client → Profiles and DLP: exposes resources (evidence: `src/management/client.ts`)
- Management client → Dashboard and logs: exposes dashboard (evidence: `src/management/client.ts`)
- Management client → HTTP request pipeline: sends requests
- Profiles and DLP → Pagination helpers: uses pagination
- Management client → Prisma AIRS services: manages configuration (evidence: `README.md`)
- SDK user → Gateway SCM client: configures and calls (evidence: `README.md`)
- Gateway SCM client → Gateway administration: exposes administration (evidence: `README.md`)
- Gateway SCM client → IAM scopes: exposes IAM scopes (evidence: `README.md`)
- Gateway SCM client → OAuth configuration: uses OAuth setup
- Gateway administration → HTTP request pipeline: sends requests
- Gateway SCM client → Prisma AIRS services: manages gateway (evidence: `README.md`)
- SDK user → Runtime inference: sets runtime credentials (evidence: `README.md`)
- Runtime inference → Runtime resources: exposes runtime operations (evidence: `src/ai-gateway/inference-client.ts`)
- Runtime inference → HTTP request pipeline: sends requests (evidence: `src/ai-gateway/inference-client.ts`)
- Runtime inference → Gateway runtime service: runs inference (evidence: `README.md`)
- SDK user → Public model pricing: requests catalog (evidence: `README.md`)
- Public model pricing → Public pricing service: fetches public rates (evidence: `README.md`)
- SDK user → Model security client: configures and calls (evidence: `README.md`)
- Model security client → Model scans: exposes scans
- Model security client → Security groups and rules: exposes rule management
- Model scans → HTTP request pipeline: sends requests (evidence: `src/model-security/scans-client.ts`)
- Model scans → Pagination helpers: uses pagination (evidence: `src/model-security/scans-client.ts`)
- Model security client → OAuth configuration: uses OAuth setup
- Model security client → Prisma AIRS services: secures models (evidence: `README.md`)
- SDK user → Red team client: configures and calls (evidence: `README.md`)
- Red team client → Red team scans: exposes scans (evidence: `src/red-team/client.ts`)
- Red team client → Reports and targets: exposes reports (evidence: `src/red-team/client.ts`)
- Red team client → Custom attacks: exposes custom attacks (evidence: `src/red-team/client.ts`)
- Red team scans → HTTP request pipeline: sends requests (evidence: `src/red-team/scans-client.ts`)
- Red team scans → Pagination helpers: uses pagination (evidence: `src/red-team/scans-client.ts`)
- Red team client → OAuth configuration: uses OAuth setup (evidence: `src/red-team/client.ts`)
- Red team client → Prisma AIRS services: runs red-team workflows (evidence: `README.md`)
- Scanner → Typed models: uses scan models (evidence: `src/scan/scanner.ts`)
- Model scans → Typed models: uses typed models (evidence: `src/model-security/scans-client.ts`)
- Red team scans → Typed models: uses typed models (evidence: `src/red-team/scans-client.ts`)
