mkdocs.yml

site_name: Agent Manifest
site_description: Cryptographic identity and provenance standard for AI agents
site_url: https://manifest.agentrust-io.com
repo_url: https://github.com/agentrust-io/agent-manifest
repo_name: agentrust-io/agent-manifest
edit_uri: edit/main/docs/
docs_dir: docs

theme:
  name: material
  custom_dir: overrides
  font: false
  logo: assets/icon.svg
  favicon: assets/icon.svg
  palette:
    - scheme: slate
      primary: custom
      accent: custom
      toggle:
        icon: material/brightness-7
        name: Switch to light mode
    - scheme: default
      primary: custom
      accent: custom
      toggle:
        icon: material/brightness-4
        name: Switch to dark mode
  features:
    - navigation.instant
    - navigation.tracking
    - navigation.tabs
    - navigation.tabs.sticky
    - navigation.sections
    - navigation.top
    - navigation.path
    - search.suggest
    - search.highlight
    - content.code.copy
    - content.tabs.link
    - content.code.annotate
    - content.tooltips
    - navigation.instant.progress
    - navigation.footer
    - navigation.expand
    - search.share
    - toc.follow
    - announce.dismiss
  icon:
    repo: fontawesome/brands/github

plugins:
  - search
  - llmstxt:
      full_output: llms-full.txt
      markdown_description: >-
        Agent Manifest is an open standard for the cryptographic identity and
        provenance of AI agents. It anchors the 10 artifacts that define an
        agent at deployment (system prompt, policy bundle, tool manifest, model
        identity, RAG corpus, memory baseline, decision-log baseline, A2A delegation,
        supply chain, and HITL approvals) so a verifier who does not trust the
        operator can prove the agent running in production is the one that was
        approved. Level 0 is software-only Ed25519 signing; Levels 1 to 3 add
        TEE attestation (TPM, AMD SEV-SNP, Intel TDX, OPAQUE) and post-quantum
        profiles.
      sections:
        Getting started:
          - index.md
          - getting-started.md
        Specification:
          - spec-overview.md
        Guides:
          - tutorials/index.md
        Reference:
          - api-reference/index.md
          - compliance/index.md
  - minify:
      minify_html: true
  - mkdocstrings:
      default_handler: python
      handlers:
        python:
          paths: [python/src]
          options:
            docstring_style: google
            show_source: false
            show_root_heading: true
            show_root_full_path: false
            show_symbol_type_heading: true
            show_symbol_type_toc: true
            members_order: source
            separate_signature: true
            show_signature_annotations: true
            unwrap_annotated: true

markdown_extensions:
  - admonition
  - pymdownx.details
  - pymdownx.superfences:
      custom_fences:
        - name: mermaid
          class: mermaid
          format: !!python/name:pymdownx.superfences.fence_code_format
  - pymdownx.tabbed:
      alternate_style: true
  - pymdownx.highlight:
      anchor_linenums: true
  - pymdownx.inlinehilite
  - pymdownx.snippets
  - pymdownx.emoji:
      emoji_index: !!python/name:material.extensions.emoji.twemoji
      emoji_generator: !!python/name:material.extensions.emoji.to_svg
  - attr_list
  - md_in_html
  - tables
  - toc:
      permalink: true

extra:
  social:
    - icon: fontawesome/brands/github
      link: https://github.com/agentrust-io/agent-manifest
      name: agent-manifest on GitHub
    - icon: fontawesome/brands/python
      link: https://pypi.org/project/agent-manifest/
      name: agent-manifest on PyPI
  generator: false
  analytics:
    feedback:
      title: Was this page helpful?
      ratings:
        - icon: material/emoticon-happy-outline
          name: This page was helpful
          data: 1
          note: Thanks for your feedback!
        - icon: material/emoticon-sad-outline
          name: This page could be improved
          data: 0
          note: Thanks for your feedback — open an issue to let us know.

extra_css:
  - stylesheets/extra.css

nav:
  - Home: index.md
  - Getting Started: getting-started.md
  - Tutorials:
      - Overview: tutorials/index.md
      - Server-side verification: tutorials/server-side-verification.md
      - A2A delegation chains: tutorials/delegation-chains.md
      - HITL approval workflows: tutorials/hitl-approval-workflows.md
      - Revocation and key rotation: tutorials/revocation-and-key-rotation.md
      - Hardware attestation: tutorials/hardware-attestation.md
      - Deploying the verification endpoint: tutorials/deploying-the-verification-endpoint.md
      - Your first manifest: tutorials/your-first-manifest.md
      - CI/CD signing: tutorials/ci-cd-signing.md
      - cMCP session binding: tutorials/cmcp-session-binding.md
  - Integrations:
      - Overview: integrations/index.md
      - LangChain: integrations/langchain.md
      - OpenAI Agents SDK: integrations/openai-agents.md
      - AutoGen and CrewAI: integrations/autogen-crewai.md
      - AGT: integrations/agt.md
      - NVIDIA OpenShell: integrations/openshell.md
      - Agent Credentials: integrations/agent-credentials.md
  - Architecture:
      - Decision Records: adr/index.md
      - ADR-0001 - RFC 8785 Canonical JSON: adr/0001-rfc8785-canonical-json.md
      - ADR-0002 - Ed25519 Standard Profile: adr/0002-ed25519-standard-profile.md
      - ADR-0003 - RFC 9162 Merkle Trees: adr/0003-rfc9162-merkle-domain-separation.md
      - ADR-0004 - Pydantic v2 Schema Modeling: adr/0004-pydantic-v2-schema-modeling.md
      - ADR-0005 - ML-DSA-65 Hybrid Signatures: adr/0005-ml-dsa-hybrid-signature.md
      - ADR-0006 - HITL Approval Mechanism: adr/0006-hitl-approval-mechanism.md
      - ADR-0007 - JSON-Lines Revocation CRL: adr/0007-revocation-json-lines-crl.md
      - ADR-0008 - Conformance Level Design: adr/0008-conformance-level-design.md
      - ADR-0009 - SPIFFE URI for Agent Identity: adr/0009-spiffe-uri-agent-identity.md
      - ADR-0010 - Runtime Attestation Freshness Proofs: adr/0010-runtime-attestation-freshness-proofs.md
      - ADR-0011 - Signed Document, Not a JWT Profile: adr/0011-signature-envelope.md
      - ADR-0012 - Context URI on a Controlled Domain: adr/0012-context-uri-moved-to-controlled-domain.md
      - ADR-0013 - CBOR Library, Not a COSE Library: adr/0013-cbor-library-for-cose.md
      - ADR-0014 - Fully-Specified Ed25519 Code Point: adr/0014-fully-specified-ed25519-code-point.md
      - ADR-0015 - Agent Plugins Manifest Reference: adr/0015-agent-plugins-manifest-reference.md
  - Compliance:
      - Overview: compliance/index.md
      - EU AI Act: compliance/eu-ai-act.md
      - DORA: compliance/dora.md
      - GDPR: compliance/gdpr.md
      - HIPAA: compliance/hipaa.md
  - API Reference:
      - Overview: api-reference/index.md
      - Core models: api-reference/models.md
      - Signing: api-reference/signing.md
      - COSE envelope (v0.2): api-reference/cose.md
      - Verification: api-reference/verification.md
      - Revocation: api-reference/revocation.md
      - Delegation: api-reference/delegation.md
      - Attestation: api-reference/attestation.md
      - CLI: api-reference/cli.md
  - Operations:
      - Overview: operations/index.md
      - Key rotation: operations/key-rotation.md
      - Audit log management: operations/audit-log.md
      - Monitoring: operations/monitoring.md
  - Specification:
      - Overview: spec-overview.md
  - Project:
      - Roadmap: roadmap.md
      - Limitations: limitations.md
      - Changelog: changelog.md
      - Contributing: contributing.md
      - Governance: governance.md

extra_javascript:
  - https://agentrust-io.com/supernav.js