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

# Typed Web Commons

> An open protocol for typed, provenance-bearing agent interfaces to web representations.

# Compile the web into trustworthy interfaces for agents

Typed Web Commons is building a language-neutral protocol that turns web representations into typed, inspectable interfaces while preserving the exact path from origin evidence to agent-facing value.

```text theme={null}
origin representation
    ↓
immutable observation
    ↓
source-native statement
    ↓
declared transformation
    ↓
semantic interpretation
    ↓
typed result with field-level provenance
```

The project does not certify that provider content is objectively true. It establishes a reproducible account of **what an origin represented and how the system derived the value it returned**.

<CardGroup cols={2}>
  <Card title="Run Genesis" icon="terminal" href="/start/quickstart">
    Build and execute the complete local evidence-to-result path.
  </Card>

  <Card title="Understand the truth contract" icon="file-check" href="/concepts/source-statement-fidelity">
    Learn exactly what the protocol proves and what it does not claim.
  </Card>

  <Card title="Inspect the architecture" icon="network" href="/architecture/genesis-slice">
    See the current boundaries, data flow, and deliberate exclusions.
  </Card>

  <Card title="Review security" icon="shield" href="/security/threat-model">
    Study the attacker assumptions and public-deployment gate.
  </Card>
</CardGroup>

## Genesis scope

The current implementation provides:

* a policy-constrained HTTP observer;
* a SHA-256 content-addressed evidence store;
* a deterministic CBOR observation envelope;
* independent verification in Go and C;
* a manually admitted JSON adapter;
* native and semantic views of every extracted field;
* complete field-level provenance;
* offline deterministic replay.

It does not yet provide arbitrary website inference, browser automation, models, databases, write actions, payments, or public multi-tenant hosting.

<Note>
  The limitation is intentional. Every later capability must inherit the evidentiary and security guarantees of this first slice.
</Note>