> ## Documentation Index
> Fetch the complete documentation index at: https://docs.meshai.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Compliance

> Readiness score, FRIA, transparency cards, and incident reporting

## get\_readiness\_score()

Get the EU AI Act readiness score for your tenant.

```python theme={null}
score = client.get_readiness_score()
```

**Returns**: Score object with total, per-component breakdown, and recommendations. See [Readiness Score](/governance/readiness-score) for component details.

```json theme={null}
{
  "total_score": 85,
  "max_score": 120,
  "rating": "good",
  "components": [
    {"name": "agent_registry", "score": 20, "max_score": 20, "status": "complete"},
    {"name": "risk_classification", "score": 15, "max_score": 20, "status": "partial"},
    {"name": "governance_policies", "score": 15, "max_score": 15, "status": "complete"},
    {"name": "human_oversight", "score": 15, "max_score": 20, "status": "partial"},
    {"name": "audit_trail", "score": 15, "max_score": 15, "status": "complete"},
    {"name": "fria_completion", "score": 5, "max_score": 20, "status": "partial"},
    {"name": "incident_readiness", "score": 0, "max_score": 10, "status": "missing"}
  ],
  "recommendations": [
    "Classify the remaining 2 agents with a risk level",
    "Complete FRIA for agents: hr-screener, loan-evaluator"
  ]
}
```

## get\_fria()

Get the Fundamental Rights Impact Assessment for an agent.

```python theme={null}
fria = client.get_fria("agt_abc123")
```

<ParamField path="agent_id" type="string" required>
  Agent ID
</ParamField>

**Returns**: FRIA object with all six assessment fields, version, and status. See [FRIA](/governance/fria) for details.

```json theme={null}
{
  "id": "fria_abc123",
  "agent_id": "agt_abc123",
  "version": 1,
  "status": "submitted",
  "processes": "...",
  "frequency_and_scope": "...",
  "categories_of_persons": "...",
  "specific_risks": "...",
  "human_oversight_measures": "...",
  "risk_mitigation_measures": "..."
}
```

## get\_transparency\_card()

Get the auto-generated transparency card for an agent. Transparency cards document the agent's purpose, capabilities, limitations, and risk classification, required by EU AI Act Articles 13 and 50.

```python theme={null}
card = client.get_transparency_card("agt_abc123")
```

<ParamField path="agent_id" type="string" required>
  Agent ID
</ParamField>

**Returns**:

```json theme={null}
{
  "agent_id": "agt_abc123",
  "agent_name": "production-summarizer",
  "purpose": "Summarizes customer support tickets for the support team",
  "framework": "crewai",
  "model_provider": "openai",
  "model_name": "gpt-4o",
  "risk_level": "limited",
  "capabilities": [
    "Text summarization",
    "Ticket categorization"
  ],
  "limitations": [
    "May miss context in multi-language tickets",
    "Does not handle image attachments"
  ],
  "human_oversight": "Output reviewed by support team leads before customer communication",
  "data_sources": "Customer support ticket text (no PII stored)",
  "generated_at": "2026-03-17T10:00:00Z"
}
```

## create\_incident()

Report a serious incident per EU AI Act Article 73.

```python theme={null}
incident = client.create_incident(
    agent_id="agt_abc123",
    title="Discriminatory output in hiring agent",
    severity="high",
    description="The HR screening agent systematically ranked female candidates lower...",
    impact="Approximately 120 job applicants may have been affected.",
    immediate_actions="Agent suspended immediately.",
    root_cause="Training data contained historical hiring bias.",
    affected_persons_count=120,
    involves_health_or_death=False,
)
```

<ParamField path="agent_id" type="string" required>
  Agent ID
</ParamField>

<ParamField path="title" type="string" required>
  Short title describing the incident
</ParamField>

<ParamField path="severity" type="string" required>
  `serious` or `critical` (critical if death or serious health damage)
</ParamField>

<ParamField path="description" type="string" required>
  Detailed description of what happened
</ParamField>

<ParamField path="impact" type="string" required>
  Description of the impact
</ParamField>

<ParamField path="immediate_actions" type="string" required>
  Actions taken immediately after discovery
</ParamField>

<ParamField path="root_cause" type="string">
  Root cause analysis (can be updated later)
</ParamField>

<ParamField path="affected_persons_count" type="integer">
  Estimated number of affected persons
</ParamField>

<ParamField path="involves_health_or_death" type="boolean" default="false">
  If `true`, the reporting deadline is 2 days instead of 15
</ParamField>

See [Incident Reporting](/governance/incidents) for the full workflow including authority notification.

## list\_incidents()

List incident reports, optionally filtered by status.

```python theme={null}
incidents = client.list_incidents(status="open", limit=20)
```

## update\_incident()

Update an incident's status, root cause, corrective actions, or authority-notified flag.

```python theme={null}
client.update_incident(42, status="resolved", root_cause="Training data bias corrected")
```