---
title: "Concepts"
description: The twenty-three pages that explain what CodeSpar does, grouped by the part of the money path they belong to.
---

Twenty-three pages, grouped by the part of the money path they belong to. Start at the runtime if you are new: what every call needs before anything moves.

{/* GERADO por scripts/concepts/gerar-indice.mjs — não editar à mão */}

<ShapeGrid formas={[
  {
    nome: "The runtime",
    familia: "sai",
    icone: "◆",
    quando: "What every call needs before anything moves: who is acting, in which project, over which session, and the tool surface it reaches.",
    receitas: [
      { titulo: "Authentication", href: "/docs/concepts/authentication" },
      { titulo: "Sessions", href: "/docs/concepts/sessions" },
      { titulo: "Why meta-tools", href: "/docs/concepts/tools" },
      { titulo: "Projects", href: "/docs/concepts/projects" },
      { titulo: "Connect Links", href: "/docs/concepts/connect-links" },
    ],
  },
  {
    nome: "Get paid",
    familia: "entra",
    icone: "↙",
    quando: "Price what your endpoints and agents do, and settle to a wallet you control.",
    receitas: [
      { titulo: "Gate", href: "/docs/concepts/gate" },
      { titulo: "Meter", href: "/docs/concepts/meter" },
    ],
  },
  {
    nome: "Spend",
    familia: "sai",
    icone: "↗",
    quando: "Give an agent an allowance instead of a key, and decide what it may buy.",
    receitas: [
      { titulo: "Wallets", href: "/docs/concepts/wallets" },
      { titulo: "Directed-pay", href: "/docs/concepts/directed-pay" },
      { titulo: "Pay to Agent", href: "/docs/concepts/pay-to-agent" },
      { titulo: "Shopper Identity", href: "/docs/concepts/shopper-identity" },
    ],
  },
  {
    nome: "Trust and control",
    familia: "autoridade",
    icone: "⧉",
    quando: "What the person signed, what the policy refuses, and what the chain can show afterwards.",
    receitas: [
      { titulo: "Mandates, receipts and approvals", href: "/docs/concepts/mandates" },
      { titulo: "Guardrails", href: "/docs/concepts/guardrails" },
      { titulo: "Audit chain", href: "/docs/concepts/audit-chain" },
      { titulo: "Agent identity and trust (KYA)", href: "/docs/concepts/agent-trust" },
      { titulo: "Tool Router", href: "/docs/concepts/tool-router" },
      { titulo: "Facilitator", href: "/docs/concepts/facilitator" },
    ],
  },
  {
    nome: "Events",
    familia: "entra",
    icone: "⇥",
    quando: "How the runtime tells your software that money landed.",
    receitas: [
      { titulo: "Triggers", href: "/docs/concepts/triggers" },
      { titulo: "Webhooks", href: "/docs/concepts/webhooks" },
    ],
  },
  {
    nome: "Operate",
    familia: "registro",
    icone: "⚙",
    quando: "Testing without money, what it costs, and how money goes back.",
    receitas: [
      { titulo: "Test Mode", href: "/docs/concepts/test-mode" },
      { titulo: "Billing", href: "/docs/concepts/billing" },
      { titulo: "Refunds", href: "/docs/concepts/refunds" },
    ],
  },
]} />

{/* fim do bloco gerado */}

Each page states what the runtime does, what it refuses, and what it writes to the audit chain. Where a recipe exists that runs the concept end to end, the page links to it at the bottom.

<NextStepsGrid items={[
  { label: "COOKBOOK", title: "Cookbooks", description: "Nineteen runnable recipes, grouped by the shape of the problem.", href: "/docs/cookbooks" },
  { label: "QUICKSTART", title: "5-minute quickstart", description: "Install the SDK and get a session running before reading further.", href: "/docs/quickstart" },
  { label: "REFERENCE", title: "API reference", description: "Every operation the published spec describes.", href: "/docs/api/reference" },
]} />