# triviantechnologies/tria-sdk architecture

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

- Interactive diagram: https://gitdiagram.com/triviantechnologies/tria-sdk
- Repository: https://github.com/triviantechnologies/tria-sdk

## Overview

TRIA is a model-agnostic governance SDK. A host creates relationships and records attributable claims and authority; it evaluates consent, permissions, policy, and context before execution; events preserve auditable state for inspection and replay. The graph emphasizes this host-to-governed-action path and documented truth-integrity, provider, and replay capabilities. Source excerpts and the index support the central runtime links; unsampled feature links are included only where the README documents them.

Main entry points: [`src/tria/store.py`](https://github.com/triviantechnologies/tria-sdk/blob/main/src/tria/store.py) (Event stores), [`src/tria/core.py`](https://github.com/triviantechnologies/tria-sdk/blob/main/src/tria/core.py) (Relationship API), [`src/tria/runtime.py`](https://github.com/triviantechnologies/tria-sdk/blob/main/src/tria/runtime.py) (Invocation runtime), [`src/tria/execution.py`](https://github.com/triviantechnologies/tria-sdk/blob/main/src/tria/execution.py) (Execution bridge)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_relationship["Relationship records"]
  node_tria["TRIA factory<br/>[core.py]"]
  node_relationship_api["Relationship API<br/>[core.py]"]
  node_claims["Claims and lineage<br/>[core.py]"]
  node_state["State projection<br/>[state.py]"]
  node_types["Domain records<br/>[types.py]"]
end

subgraph group_governance["Governance and assessment"]
  node_governance["Governance engine<br/>[governance.py]"]
  node_diagnostic["Action diagnostics<br/>[diagnostic.py]"]
  node_integrity["Truth integrity<br/>[integrity.py]"]
  node_release["Claim release assessment<br/>[release.py]"]
  node_boundary["Disclosure boundary<br/>[boundary.py]"]
end

subgraph group_execution["Governed execution"]
  node_runtime["Invocation runtime<br/>[runtime.py]"]
  node_bridge["Execution bridge<br/>[execution.py]"]
  node_provider_adapter["Provider adapters<br/>[base.py]"]
end

subgraph group_audit["Persistence and replay"]
  node_events["Event history<br/>[events.py]"]
  node_store[("Event stores<br/>[store.py]")]
  node_portable["Replay bundles<br/>[portable.py]"]
  node_compat["Schema compatibility<br/>[compat.py]"]
end

node_host(("Host application"))
node_providers(("Provider services"))
node_playground["Local playground<br/>[adapter.py]"]
node_agent(("Requesting agent"))

node_host -->|"creates relationship"| node_tria
node_tria -->|"selects store"| node_store
node_relationship_api -->|"commits events"| node_store
node_relationship_api -->|"checks authority"| node_governance
node_relationship_api -->|"registers claims"| node_claims
node_store -->|"persists"| node_events
node_state -->|"replays history"| node_events
node_governance -->|"evaluates state"| node_state
node_host -->|"requests inspection"| node_diagnostic
node_diagnostic -->|"assesses evidence"| node_integrity
node_host -->|"assesses claims"| node_release
node_host -.->|"mediates disclosure"| node_boundary
node_agent -->|"proposes invocation"| node_bridge
node_bridge -->|"evaluates request"| node_runtime
node_runtime -->|"checks requirements"| node_governance
node_bridge -->|"translates allowed plan"| node_provider_adapter
node_provider_adapter -.->|"sends provider request"| node_providers
node_host -->|"exports or imports replay"| node_portable
node_portable -->|"reads and restores"| node_store
node_portable -->|"checks versions"| node_compat
node_playground -->|"uses local SDK"| node_tria
node_claims -->|"uses domain records"| node_types
node_runtime -->|"uses request records"| node_types

click node_tria "https://github.com/triviantechnologies/tria-sdk/blob/main/src/tria/core.py"
click node_relationship_api "https://github.com/triviantechnologies/tria-sdk/blob/main/src/tria/core.py"
click node_claims "https://github.com/triviantechnologies/tria-sdk/blob/main/src/tria/core.py"
click node_state "https://github.com/triviantechnologies/tria-sdk/blob/main/src/tria/state.py"
click node_events "https://github.com/triviantechnologies/tria-sdk/blob/main/src/tria/events.py"
click node_store "https://github.com/triviantechnologies/tria-sdk/blob/main/src/tria/store.py"
click node_governance "https://github.com/triviantechnologies/tria-sdk/blob/main/src/tria/governance.py"
click node_diagnostic "https://github.com/triviantechnologies/tria-sdk/blob/main/src/tria/diagnostic.py"
click node_integrity "https://github.com/triviantechnologies/tria-sdk/blob/main/src/tria/integrity.py"
click node_release "https://github.com/triviantechnologies/tria-sdk/blob/main/src/tria/release.py"
click node_boundary "https://github.com/triviantechnologies/tria-sdk/blob/main/src/tria/boundary.py"
click node_runtime "https://github.com/triviantechnologies/tria-sdk/blob/main/src/tria/runtime.py"
click node_bridge "https://github.com/triviantechnologies/tria-sdk/blob/main/src/tria/execution.py"
click node_provider_adapter "https://github.com/triviantechnologies/tria-sdk/blob/main/src/tria/providers/base.py"
click node_portable "https://github.com/triviantechnologies/tria-sdk/blob/main/src/tria/portable.py"
click node_compat "https://github.com/triviantechnologies/tria-sdk/blob/main/src/tria/compat.py"
click node_playground "https://github.com/triviantechnologies/tria-sdk/blob/main/playground/adapter.py"
click node_types "https://github.com/triviantechnologies/tria-sdk/blob/main/src/tria/types.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_tria,node_relationship_api,node_claims,node_state,node_types toneBlue
class node_governance,node_diagnostic,node_integrity,node_release,node_boundary toneAmber
class node_runtime,node_bridge,node_provider_adapter,node_agent toneMint
class node_events,node_store,node_portable,node_compat toneRose
class node_host,node_providers toneIndigo
class node_playground toneTeal
```

## Components

### Relationship records

- [TRIA factory](https://github.com/triviantechnologies/tria-sdk/blob/main/src/tria/core.py): `src/tria/core.py`
- [Relationship API](https://github.com/triviantechnologies/tria-sdk/blob/main/src/tria/core.py): `src/tria/core.py`
- [Claims and lineage](https://github.com/triviantechnologies/tria-sdk/blob/main/src/tria/core.py): `src/tria/core.py`
- [State projection](https://github.com/triviantechnologies/tria-sdk/blob/main/src/tria/state.py): `src/tria/state.py`
- [Domain records](https://github.com/triviantechnologies/tria-sdk/blob/main/src/tria/types.py): `src/tria/types.py`

### Governance and assessment

- [Governance engine](https://github.com/triviantechnologies/tria-sdk/blob/main/src/tria/governance.py): `src/tria/governance.py`
- [Action diagnostics](https://github.com/triviantechnologies/tria-sdk/blob/main/src/tria/diagnostic.py): `src/tria/diagnostic.py`
- [Truth integrity](https://github.com/triviantechnologies/tria-sdk/blob/main/src/tria/integrity.py): `src/tria/integrity.py`
- [Claim release assessment](https://github.com/triviantechnologies/tria-sdk/blob/main/src/tria/release.py): `src/tria/release.py`
- [Disclosure boundary](https://github.com/triviantechnologies/tria-sdk/blob/main/src/tria/boundary.py): `src/tria/boundary.py`

### Governed execution

- [Invocation runtime](https://github.com/triviantechnologies/tria-sdk/blob/main/src/tria/runtime.py): `src/tria/runtime.py`
- [Execution bridge](https://github.com/triviantechnologies/tria-sdk/blob/main/src/tria/execution.py): `src/tria/execution.py`
- [Provider adapters](https://github.com/triviantechnologies/tria-sdk/blob/main/src/tria/providers/base.py): `src/tria/providers/base.py`

### Persistence and replay

- [Event history](https://github.com/triviantechnologies/tria-sdk/blob/main/src/tria/events.py): `src/tria/events.py`
- [Event stores](https://github.com/triviantechnologies/tria-sdk/blob/main/src/tria/store.py): `src/tria/store.py`
- [Replay bundles](https://github.com/triviantechnologies/tria-sdk/blob/main/src/tria/portable.py): `src/tria/portable.py`
- [Schema compatibility](https://github.com/triviantechnologies/tria-sdk/blob/main/src/tria/compat.py): `src/tria/compat.py`

### Other components

- **Host application**
- **Provider services**
- [Local playground](https://github.com/triviantechnologies/tria-sdk/blob/main/playground/adapter.py): `playground/adapter.py`
- **Requesting agent**

## Connections

- Host application → TRIA factory: creates relationship (evidence: `README.md`)
- TRIA factory → Event stores: selects store (evidence: `src/tria/core.py`)
- Relationship API → Event stores: commits events (evidence: `src/tria/core.py`)
- Relationship API → Governance engine: checks authority (evidence: `src/tria/core.py`)
- Relationship API → Claims and lineage: registers claims (evidence: `src/tria/core.py`)
- Event stores → Event history: persists (evidence: `src/tria/store.py`)
- State projection → Event history: replays history (evidence: `src/tria/state.py`)
- Governance engine → State projection: evaluates state (evidence: `src/tria/governance.py`)
- Host application → Action diagnostics: requests inspection (evidence: `README.md`)
- Action diagnostics → Truth integrity: assesses evidence (evidence: `src/tria/diagnostic.py`)
- Host application → Claim release assessment: assesses claims (evidence: `README.md`)
- Host application → Disclosure boundary: mediates disclosure
- Requesting agent → Execution bridge: proposes invocation (evidence: `README.md`)
- Execution bridge → Invocation runtime: evaluates request (evidence: `src/tria/execution.py`)
- Invocation runtime → Governance engine: checks requirements (evidence: `src/tria/runtime.py`)
- Execution bridge → Provider adapters: translates allowed plan (evidence: `src/tria/execution.py`)
- Provider adapters → Provider services: sends provider request
- Host application → Replay bundles: exports or imports replay (evidence: `README.md`)
- Replay bundles → Event stores: reads and restores (evidence: `src/tria/portable.py`)
- Replay bundles → Schema compatibility: checks versions (evidence: `src/tria/portable.py`)
- Local playground → TRIA factory: uses local SDK (evidence: `playground/adapter.py`)
- Claims and lineage → Domain records: uses domain records (evidence: `src/tria/core.py`)
- Invocation runtime → Domain records: uses request records (evidence: `src/tria/runtime.py`)
