# Bippsi Unified Manifest — biptest.com

> Agent-readable index of priced routes on biptest.com. This file is served
> at `/bippsi-unified.md` and is the canonical source of pricing. Machine
> parsers should prefer the structured blocks below over the prose.

## Site

- **site**: biptest.com
- **url**: https://biptest.com
- **operator**: Bippsi (bigappstudio.com / bippsi.com)
- **version**: 1.2
- **last_updated**: 2026-04-19
- **sections**: health, tech, news (free category indexes; articles priced individually)

## Agent Discovery (v1.2)

Agents handling vague user prompts should use these **free** endpoints
BEFORE trying to guess a URL. All three return JSON and are cached at the
edge for fast repeat queries.

- **search_endpoint**: `/search?q=<keywords>` — keyword + tag match,
  relevance-ranked; returns `{url, title, tags, price_bips, relevance,
  snippet}` per result.
- **topics_endpoint**: `/topics` — category + tag tree with article
  counts. Use when the user prompt is abstract ("what topics do you
  cover?").
- **headlines_endpoint**: `/headlines?limit=N&category=<slug>` — most
  recent articles across all categories by default, or filtered by
  category. Use for "what's new" / "recent articles" prompts.
- **preview_policy**: `first_paragraph_free` — the first paragraph
  (`lead`) of every priced article is included free in the 402 body and
  on the category index page. Agents can pre-read it to decide whether
  to pay for the full article.

```yaml
free_endpoints:
  - /search
  - /topics
  - /headlines
search_endpoint: /search
preview_policy: first_paragraph_free
```

## Access Credits

- **unit**: bippsi-credits (Bips) — platform access credits, not currency
- **nature**: Bips are non-redeemable platform credits, not legal tender, not a stored-value product, and have no cash value. Bips are purchased from Bippsi and spent to initiate Unlocks at Bippsi-connected sites.
- **price_header**: `Bippsi-Credits-Price`
- **payment_header**: `Payment: bips N`
- **auth_header**: `Authorization: Bearer <your_key>`

## How paywall works

1. GET any priced route → receive `HTTP 402 Payment Required`
2. Response includes `Bippsi-Credits-Price: N` header
3. Retry the same request with:
   - `Authorization: Bearer <demo_or_bas_key>`
   - `Payment: bips N` (must be ≥ price)
4. Server returns the full content

Get a sandbox key at https://bippsi.com/biptest (free, 50 Bips).
Get a production key at https://bippsi.com/ai-key.

## Routes

```yaml
routes:
  - path: /
    methods: [GET]
    price_bips: 0
    description: Homepage — free directory of priced routes

  - path: /pricing
    methods: [GET]
    price_bips: 1
    mission_key: pricing_page
    description: Pricing explainer page (cheapest paid route)

  - path: /contact
    methods: [GET]
    price_bips: 0
    description: Contact form (viewing is free)

  - path: /contact
    methods: [POST]
    price_bips: 2
    mission_key: contact_form
    description: Submit the contact form

  - path: /buy
    methods: [GET]
    price_bips: 0
    description: Buy page preview

  - path: /buy
    methods: [POST]
    price_bips: 3
    mission_key: buy_button
    description: Complete the buy action

  - path: /health
    methods: [GET]
    price_bips: 0
    description: Health category index (free to browse)
  - path: /health/morning-routine
    methods: [GET]
    price_bips: 0
    description: "Free article: what your morning routine actually does"
  - path: /health/coffee-benefits
    methods: [GET]
    price_bips: 2
    mission_key: article_read
    description: Coffee cardiovascular research + timing
  - path: /health/sleep-tracker
    methods: [GET]
    price_bips: 3
    mission_key: article_read
    description: Sleep-tracker paradox, orthosomnia, practical fixes

  - path: /tech
    methods: [GET]
    price_bips: 0
    description: Tech category index (free to browse)
  - path: /tech/open-source-economics
    methods: [GET]
    price_bips: 0
    description: "Free article: the quiet open-source license shift"
  - path: /tech/ai-pricing-trends
    methods: [GET]
    price_bips: 4
    mission_key: article_read
    description: Five pricing models for AI and the one winning quietly
  - path: /tech/quantum-primer
    methods: [GET]
    price_bips: 4
    mission_key: article_read
    description: Plain-language quantum primer — what breaks, when, what to do in 2026

  - path: /news
    methods: [GET]
    price_bips: 0
    description: News category index (free to browse)
  - path: /news/policy-watch
    methods: [GET]
    price_bips: 0
    description: "Free brief: three agent-economy bills moving this quarter"
  - path: /news/ai-economy-week
    methods: [GET]
    price_bips: 2
    mission_key: article_read
    description: Weekly AI-economy roundup
  - path: /news/startup-roundup
    methods: [GET]
    price_bips: 3
    mission_key: article_read
    description: Agent-infra startup movements — raised, folded, pivoted

  - path: /articles/whitepaper
    methods: [GET]
    price_bips: 5
    mission_key: article_read
    description: Full whitepaper article (long-form content)

  - path: /downloads/whitepaper
    methods: [GET]
    price_bips: 10
    mission_key: whitepaper_download
    description: Whitepaper PDF download (application/pdf)

  - path: /premium-report
    methods: [GET]
    price_bips: 2000
    mission_key: insufficient_balance_demo
    description: Premium-tier report. Exceeds sandbox balance on purpose — demonstrates the "out of Bips, go buy more" flow. Production keys handle it.
```

## Topics (v1.2)

Machine-readable tag map. Agents resolving a user prompt to a priced
route should first match against this list, then use `/search` to rank
specific articles within a topic.

```yaml
topics:
  - slug: health
    label: Health
    tags: [coffee, caffeine, sleep, wearables, polysomnography, nutrition,
           cardiovascular, longevity, habits, morning, productivity,
           cortisol, sunlight, routine, health-data]
  - slug: tech
    label: Tech
    tags: [quantum, computing, qubits, cryptography, physics, explainer,
           ai, llm, inference, pricing, gpu, openai, anthropic, google,
           open-source, maintainers, funding, software, github, licensing]
  - slug: news
    label: News
    tags: [ai, economy, agents, commerce, news, week-in-review, policy,
           regulation, liability, eu, uk, legislation, startups, funding,
           venture, series-a]
  - slug: articles
    label: Longform
    tags: [whitepaper, http-402, agents, commerce, bippsi, protocol, longform]
  - slug: downloads
    label: Downloads
    tags: [whitepaper, pdf, download, longform]
```

## Policy

- **sandbox**: biptest.com-only hosts allowed. Bippsi's agent proxy blocks
  all other destinations. This restriction is enforced server-side and is
  intentional.
- **spend_cap_per_interaction**: 125 Bips in production (subject to Bippsi's
  discretion per Partner Agreement §7). The demo is lower — see /biptest
  for session quota.
- **attribution**: earnings on biptest.com accrue to a synthetic system
  account that is permanently flagged payout-ineligible. No real money
  moves for biptest traffic.

## Related

- Operator policy: https://biptest.com/AGENTS.md
- Crawler rules: https://biptest.com/robots.txt
- Live showcase: https://bippsi.com/biptest
- Buy Bips: https://bippsi.com/buy-bips