openapi: 3.1.0
info:
  title: Loop XXI Agent Lightning Spend Guardrails Kit
  summary: Digital kit of Bitcoin Lightning spend-policy templates for agents that pay L402. Not a hosted wallet. Loop XXI does not take custody.
  description: >
    Machine-readable pointer to the Guardrails kit. Operators wrap lnget and
    (optionally) Wavelength MCP with budgets, pay-only credentials,
    preview-before-pay, and weekly receipts. This document describes static
    kit files. There is no payment API and no custody endpoint.
  version: 0.1.0
  contact:
    name: Loop XXI LLC
    email: business@loopxxi.com
    url: https://loopxxi.com/tools/agent-spend-guardrails
  license:
    name: Kit text as published on loopxxi.com
externalDocs:
  description: Kit index
  url: https://loopxxi.com/docs/agent-lightning-spend-guardrails/README.md
servers:
  - url: https://loopxxi.com
    description: Public site (kit landing is noindex until a paid edition is approved)
tags:
  - name: kit
    description: Static documentation. No Lightning node. No custody.
paths:
  /tools/agent-spend-guardrails:
    get:
      tags: [kit]
      summary: Public landing (human + agent)
      description: Agent-first framing. Soft email CTA. Checkout is not open.
      operationId: getGuardrailsLanding
      responses:
        '200':
          description: HTML landing
          content:
            text/html:
              schema:
                type: string
  /tools/agent-spend-guardrails.openapi.yaml:
    get:
      tags: [kit]
      summary: This OpenAPI pointer
      operationId: getGuardrailsOpenApi
      responses:
        '200':
          description: OpenAPI document
          content:
            application/yaml:
              schema:
                type: string
  /docs/agent-lightning-spend-guardrails/llms.txt:
    get:
      tags: [kit]
      summary: Short agent-readable kit blurb
      operationId: getGuardrailsLlmsTxt
      responses:
        '200':
          description: Plain-text capability blurb
          content:
            text/plain:
              schema:
                type: string
  /docs/agent-lightning-spend-guardrails/README.md:
    get:
      tags: [kit]
      summary: Kit index
      operationId: getGuardrailsIndex
      responses:
        '200':
          description: Markdown kit index
          content:
            text/markdown:
              schema:
                type: string
  /docs/agent-lightning-spend-guardrails/policy-templates.md:
    get:
      tags: [kit]
      summary: Dev / production / multi-agent policy templates
      operationId: getPolicyTemplates
      responses:
        '200':
          description: Markdown
          content:
            text/markdown:
              schema:
                type: string
  /docs/agent-lightning-spend-guardrails/lnget-runbook.md:
    get:
      tags: [kit]
      summary: lnget config keys, cited flags, exit codes 0–4
      operationId: getLngetRunbook
      responses:
        '200':
          description: Markdown
          content:
            text/markdown:
              schema:
                type: string
  /docs/agent-lightning-spend-guardrails/macaroon-roles.md:
    get:
      tags: [kit]
      summary: Pay-only / invoice-only / read-only recipes (official docs)
      operationId: getMacaroonRoles
      responses:
        '200':
          description: Markdown
          content:
            text/markdown:
              schema:
                type: string
  /docs/agent-lightning-spend-guardrails/reconciliation.md:
    get:
      tags: [kit]
      summary: Weekly domain / sats / failure sheet
      operationId: getReconciliation
      responses:
        '200':
          description: Markdown
          content:
            text/markdown:
              schema:
                type: string
  /docs/agent-lightning-spend-guardrails/reconciliation.example.csv:
    get:
      tags: [kit]
      summary: Example weekly reconciliation CSV
      operationId: getReconciliationCsv
      responses:
        '200':
          description: CSV
          content:
            text/csv:
              schema:
                type: string
  /docs/agent-lightning-spend-guardrails/never-unrestricted-treasury.md:
    get:
      tags: [kit]
      summary: Never unrestricted treasury checklist
      operationId: getTreasuryChecklist
      responses:
        '200':
          description: Markdown
          content:
            text/markdown:
              schema:
                type: string
  /docs/agent-lightning-spend-guardrails/wavelength-wrap.md:
    get:
      tags: [kit]
      summary: Wavelength MCP wrap guidance (do not fork)
      operationId: getWavelengthWrap
      responses:
        '200':
          description: Markdown
          content:
            text/markdown:
              schema:
                type: string
components:
  schemas:
    KitNotice:
      type: object
      additionalProperties: false
      properties:
        product:
          type: string
          enum: [agent-lightning-spend-guardrails-kit]
        custody:
          type: string
          enum: [none]
        wallet:
          type: string
          enum: [not-hosted]
        checkout:
          type: string
          enum: [not-open]
        price_hypothesis_usd:
          type: string
          description: Working range only. Not a live SKU.
          enum: ['29-49']