{
  "name": "assay",
  "title": "Assay user guide",
  "version": "0.48.0",
  "updated": "2026-08-31",
  "audience": [
    "agents",
    "humans"
  ],
  "purpose": "How to use Assay after it is installed. Not a codebase map.",
  "load_first": [
    "llms.txt",
    "index.mdx"
  ],
  "base": "docs-site",
  "agent_door": "https://docs.assay.solutions/llms.txt",
  "pages": [
    {
      "id": "index",
      "title": "Start here",
      "path": "index.mdx",
      "summary": "What Assay is, the three records it joins, two applications.",
      "topics": [
        "overview"
      ],
      "html": "https://docs.assay.solutions/",
      "md": "https://docs.assay.solutions/index.md"
    },
    {
      "id": "install",
      "title": "Install",
      "path": "install.mdx",
      "summary": "Invite installer, assay init, content key backup.",
      "topics": [
        "setup"
      ],
      "html": "https://docs.assay.solutions/install",
      "md": "https://docs.assay.solutions/install.md"
    },
    {
      "id": "first-run",
      "title": "After install",
      "path": "first-run.mdx",
      "summary": "Capture, dashboard, sweep, labelling.",
      "topics": [
        "setup"
      ],
      "html": "https://docs.assay.solutions/first-run",
      "md": "https://docs.assay.solutions/first-run.md"
    },
    {
      "id": "applications",
      "title": "Applications",
      "path": "applications.mdx",
      "summary": "Corpus vs observability in an agent loop.",
      "topics": [
        "overview"
      ],
      "html": "https://docs.assay.solutions/applications",
      "md": "https://docs.assay.solutions/applications.md"
    },
    {
      "id": "how-it-works",
      "title": "How it works",
      "path": "how-it-works.mdx",
      "summary": "Capture, price, seal, overlay, read.",
      "topics": [
        "concepts"
      ],
      "html": "https://docs.assay.solutions/how-it-works",
      "md": "https://docs.assay.solutions/how-it-works.md"
    },
    {
      "id": "data",
      "title": "What is recorded",
      "path": "data.mdx",
      "summary": "Spans, turns, sittings, overlays, joins.",
      "topics": [
        "concepts"
      ],
      "html": "https://docs.assay.solutions/data",
      "md": "https://docs.assay.solutions/data.md"
    },
    {
      "id": "framing",
      "title": "Framing",
      "path": "framing.mdx",
      "summary": "Product, objective, goal, episode, touch, type, scope, money.",
      "topics": [
        "concepts"
      ],
      "html": "https://docs.assay.solutions/framing",
      "md": "https://docs.assay.solutions/framing.md"
    },
    {
      "id": "honesty",
      "title": "Honesty",
      "path": "honesty.mdx",
      "summary": "Unknown is not zero. Corrections. Two readings.",
      "topics": [
        "concepts"
      ],
      "html": "https://docs.assay.solutions/honesty",
      "md": "https://docs.assay.solutions/honesty.md"
    },
    {
      "id": "privacy",
      "title": "Privacy and keys",
      "path": "privacy.mdx",
      "summary": "Sealed text, shred, loopback, what may leave.",
      "topics": [
        "privacy"
      ],
      "html": "https://docs.assay.solutions/privacy",
      "md": "https://docs.assay.solutions/privacy.md"
    },
    {
      "id": "capture",
      "title": "Capture",
      "path": "capture.mdx",
      "summary": "Harness log sweep and the timer.",
      "topics": [
        "capture"
      ],
      "html": "https://docs.assay.solutions/capture",
      "md": "https://docs.assay.solutions/capture.md"
    },
    {
      "id": "labelling",
      "title": "Labelling",
      "path": "labelling.mdx",
      "summary": "Place sittings using their AI. Two switches.",
      "topics": [
        "labels"
      ],
      "html": "https://docs.assay.solutions/labelling",
      "md": "https://docs.assay.solutions/labelling.md"
    },
    {
      "id": "agent-loop",
      "title": "Agent loop",
      "path": "agent-loop.mdx",
      "summary": "record, recordTurn, declareSession, Postgres.",
      "topics": [
        "embed"
      ],
      "html": "https://docs.assay.solutions/agent-loop",
      "md": "https://docs.assay.solutions/agent-loop.md"
    },
    {
      "id": "debug",
      "title": "Debug console",
      "path": "debug.mdx",
      "summary": "assay turns \u2014 decrypted timeline with cost.",
      "topics": [
        "debug"
      ],
      "html": "https://docs.assay.solutions/debug",
      "md": "https://docs.assay.solutions/debug.md"
    },
    {
      "id": "ingest",
      "title": "Ingest",
      "path": "ingest.mdx",
      "summary": "OTLP/HTTP door for gen_ai traces.",
      "topics": [
        "ingest"
      ],
      "html": "https://docs.assay.solutions/ingest",
      "md": "https://docs.assay.solutions/ingest.md"
    },
    {
      "id": "dashboard",
      "title": "Dashboard",
      "path": "dashboard.mdx",
      "summary": "Read-only local console, loopback, snapshot.",
      "topics": [
        "console"
      ],
      "html": "https://docs.assay.solutions/dashboard",
      "md": "https://docs.assay.solutions/dashboard.md"
    },
    {
      "id": "sessions",
      "title": "Sessions",
      "path": "sessions.mdx",
      "summary": "Sitting list, timeline, type writer, folds.",
      "topics": [
        "console"
      ],
      "html": "https://docs.assay.solutions/sessions",
      "md": "https://docs.assay.solutions/sessions.md"
    },
    {
      "id": "products",
      "title": "Products",
      "path": "products.mdx",
      "summary": "Tree product vs path product. Inclusive and weighted.",
      "topics": [
        "console"
      ],
      "html": "https://docs.assay.solutions/products",
      "md": "https://docs.assay.solutions/products.md"
    },
    {
      "id": "objectives",
      "title": "Objectives",
      "path": "objectives.mdx",
      "summary": "Tree, episodes, touches, unplaced, proposed.",
      "topics": [
        "console"
      ],
      "html": "https://docs.assay.solutions/objectives",
      "md": "https://docs.assay.solutions/objectives.md"
    },
    {
      "id": "type",
      "title": "Type",
      "path": "type.mdx",
      "summary": "Kind of work. Closed vocabulary.",
      "topics": [
        "labels"
      ],
      "html": "https://docs.assay.solutions/type",
      "md": "https://docs.assay.solutions/type.md"
    },
    {
      "id": "spend",
      "title": "Spend, waste, and ROI",
      "path": "spend.mdx",
      "summary": "Phases, waste detectors, ROI exclusions.",
      "topics": [
        "console"
      ],
      "html": "https://docs.assay.solutions/spend",
      "md": "https://docs.assay.solutions/spend.md"
    },
    {
      "id": "search",
      "title": "Search",
      "path": "search.mdx",
      "summary": "On-machine search. exact outranks related.",
      "topics": [
        "console"
      ],
      "html": "https://docs.assay.solutions/search",
      "md": "https://docs.assay.solutions/search.md"
    },
    {
      "id": "share",
      "title": "Share",
      "path": "share.mdx",
      "summary": "Mint a flat page. Unpublish, delete, agent bundle.",
      "topics": [
        "share"
      ],
      "html": "https://docs.assay.solutions/share",
      "md": "https://docs.assay.solutions/share.md"
    },
    {
      "id": "embed",
      "title": "Embed",
      "path": "embed.mdx",
      "summary": "Web component behind the host login.",
      "topics": [
        "embed"
      ],
      "html": "https://docs.assay.solutions/embed",
      "md": "https://docs.assay.solutions/embed.md"
    },
    {
      "id": "cli",
      "title": "CLI reference",
      "path": "cli.mdx",
      "summary": "Every verb grouped by task.",
      "topics": [
        "reference"
      ],
      "html": "https://docs.assay.solutions/cli",
      "md": "https://docs.assay.solutions/cli.md"
    },
    {
      "id": "config",
      "title": "Config",
      "path": "config.mdx",
      "summary": "File resolution, products, labelling, mode.",
      "topics": [
        "reference"
      ],
      "html": "https://docs.assay.solutions/config",
      "md": "https://docs.assay.solutions/config.md"
    },
    {
      "id": "pricing",
      "title": "Pricing",
      "path": "pricing.mdx",
      "summary": "Check, watch, reprice, local overlay.",
      "topics": [
        "reference"
      ],
      "html": "https://docs.assay.solutions/pricing",
      "md": "https://docs.assay.solutions/pricing.md"
    },
    {
      "id": "agents",
      "title": "For agents",
      "path": "agents.mdx",
      "summary": "Operating procedure. Point agents at llms.txt.",
      "topics": [
        "agents"
      ],
      "html": "https://docs.assay.solutions/agents",
      "md": "https://docs.assay.solutions/agents.md"
    },
    {
      "id": "troubleshooting",
      "title": "Troubleshooting",
      "path": "troubleshooting.mdx",
      "summary": "Empty store, keys, labelling, binds, shares.",
      "topics": [
        "help"
      ],
      "html": "https://docs.assay.solutions/troubleshooting",
      "md": "https://docs.assay.solutions/troubleshooting.md"
    }
  ],
  "how_to_traverse": "Load llms.txt first. Open only the .md pages the current task needs. Do not read the whole set.",
  "md_pattern": "https://docs.assay.solutions/{id}.md"
}