Happy Thoughts

Happy Thoughts — это сервис ответов, построенный на простом разделении:

• Консенсус помогает пользователям думать

• Проверка фактов помогает пользователям доверять

Публичная идея заключается не в том, чтобы «выбрать правильную модель». А в том, чтобы: сначала получить полезный ответ, а затем заплатить за более надежную проверку, когда ставки высоки.

С чего начать

Если вы только что попали в репозиторий, используйте этот путь:

1. Понять продукт → этот README

2. Увидеть публичный API → public/llm.txt или public/openapi.json

3. Интегрироваться как провайдер → docs/PROVIDER_QUICKSTART.md

4. Позаимствовать практический шаблон → docs/PROVIDER_EXAMPLES.md

5. Изучить контракт провайдера на практике → docs/HOSTED_PROVIDER_DELIVERY.md

Related MCP server: hyperd-mcp

Для кого этот репозиторий

• разработчики, интегрирующие потоки покупателей

• хостинг-провайдеры, интегрирующие сторону предложения

• операторы, проверяющие планы, права доступа и поведение публичного продукта

• соавторы, которым нужен контракт, а не секретные внутренние механизмы

Архитектура вкратце

Представьте Happy Thoughts как простой 3-уровневый стек:

1. Уровень покупателя

   • люди или агенты запрашивают ответ

   • бесплатный доступ начинается с Консенсуса

   • платный открывает Проверку фактов

2. Уровень продукта

   • обеспечивает соблюдение планов, квот и ограничений

   • направляет запросы через публичный контракт

   • возвращает чистую структуру ответа с уровнем уверенности + примечаниями

3. Уровень провайдера

   • хостинг-провайдеры и вебхук-провайдеры предоставляют ответы

   • провайдеры остаются важными, но пользователям не нужно сначала вникать в механику бэкенда

Это разделение — главная цель: продукт кажется простым сверху, в то время как сторона предложения остается гибкой снизу.

Концепция продукта

Консенсус

Бесплатный или ограниченный входной путь.

Консенсус сравнивает ответы нескольких моделей, синтезирует их в единый ответ и возвращает уровень уверенности вместе с примечаниями. Он предназначен для:

• повседневных вопросов

• исследовательского мышления

• поддержки принятия решений с низкими ставками

• широкой доступности

Проверка фактов

Платный уровень доверия.

Проверка фактов — это ветка с более высокой гарантией для запросов, где фактическая достоверность важнее скорости или стоимости. Внутренне режим запроса по-прежнему verified для совместимости, но в публичном продукте используется термин «проверка фактов». Он предназначен для возврата краткого окончательного ответа при сохранении более глубокой структуры проверки. Он предназначен для:

• проверки фактов в стиле рецензирования

• запросов с более высокими ставками

• усиления сигналов доверия

• премиального UX и путей оплаты

Что содержит этот репозиторий

• код приложения Cloudflare Worker

• логику маршрутизации и синтеза ответов

• каркас планов / прав доступа

• регистрацию провайдеров + инфраструктуру хостинг-провайдеров

• потоки биллинга и активации

• юридические/публичные документы продукта

• отобранный публичный образец кода интерфейса Worker

Границы публичного репозитория

Этот репозиторий призван показать поверхность продукта и контракт интеграции, а не каждое внутреннее решение по ранжированию или оркестрации.

Публичная документация должна объяснять:

• что могут вызывать покупатели

• с чем могут интегрироваться провайдеры

• какие планы/ограничения существуют

• какие формы ответов и элементы управления являются стабильными

Публичная документация не должна раскрывать:

• внутреннюю логику взвешивания

• частные эвристики маршрутизации

• скрытые настройки ранжирования

• секретные алгоритмы оценки

Что делает проект интересным

• продуктная оркестрация нескольких моделей

• лестница ответов от бесплатного к платному

• направление маркетплейса хостинг-провайдеров

• обеспечение квот и прав доступа

• изящная деградация при сбоях провайдеров

• модель развертывания, нативная для worker

Текущее направление реализации

• публичные запросы по умолчанию направляются к Консенсусу

• бесплатная квота консенсуса принудительно ограничивается

• Проверка фактов существует как платный путь с ограничениями

• предложение провайдеров по-прежнему существует под поверхностью продукта

• поток захвата PayPal усилен для активации только после завершения захвата

Модель надежности

Консенсус разработан для изящной деградации.

Если один провайдер выходит из строя, запрос должен быть выполнен, когда это возможно. Метаданные об ошибках отображаются вместо того, чтобы молча делать вид, что все идеально.

Важные концепции на уровне ответа включают:

• confidence

• confidence_reason

• models_used

• models_failed

• meta.degraded

• meta.failure_count

Пути оплаты

Happy Thoughts в настоящее время поддерживает два стиля активации:

• x402 / агент-нативные потоки

• PayPal для обычной оплаты

Активация через PayPal основана на захвате средств, а не только на одобрении. Это позволяет привязать активацию прав доступа к фактически завершенному платежу.

Примеры вызовов API

Эти примеры намеренно являются продуктовыми и очищенными. Они показывают, как использовать Happy Thoughts, не раскрывая внутреннюю логику оценки или оркестрации.

Запрос ответа Консенсуса

curl -X POST https://happythoughts.proteeninjector.workers.dev/think \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Give me the strongest argument against this idea.",
    "buyer_wallet": "0xabc123...",
    "mode": "consensus"
  }'

Хотите вертикальные примеры вместо общих? Смотрите docs/PROVIDER_EXAMPLES.md.

Запрос Проверки фактов

curl -X POST https://happythoughts.proteeninjector.workers.dev/think \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Fact-check this product claim and call out weak evidence.",
    "buyer_wallet": "0xabc123...",
    "mode": "verified"
  }'

Цикл опроса хостинг-провайдера

curl https://happythoughts.proteeninjector.workers.dev/provider/jobs/next \
  -H "Authorization: Bearer htp_your_provider_token"

curl -X POST https://happythoughts.proteeninjector.workers.dev/provider/jobs/JOB_ID/respond \
  -H "Authorization: Bearer htp_your_provider_token" \
  -H "Content-Type: application/json" \
  -d '{
    "thought": "Short, direct answer here.",
    "confidence": 0.91,
    "meta": {"style": "direct"}
  }'

Структура репозитория

• src/ — логика Worker

• public/ — публичные активы сайта

• docs/ — публичная документация по интеграции и провайдерам

• legal/ — условия, конфиденциальность, соглашение с провайдером, AUP

Полезные точки входа

• Сводка публичного API: public/llm.txt

• Машиночитаемая спецификация: public/llms-full.txt

• OpenAPI: public/openapi.json

• Быстрый старт для провайдера: docs/PROVIDER_QUICKSTART.md

• Пакет примеров провайдера: docs/PROVIDER_EXAMPLES.md

• Список специальностей: docs/SPECIALTIES.md

• Быстрый старт регистрации: docs/REGISTRATION_QUICKSTART.md

Примечания о публичной чистоте

Этот репозиторий наиболее силен, когда представлен как:

• репозиторий продуктовой разработки

• репозиторий биллинга + прав доступа

• система ответов на основе нескольких моделей

• развертывание API/приложения, нативное для worker

А не как «еще одна обертка над LLM».

Рекомендуемая документация для начала

• docs/PROVIDER_QUICKSTART.md

• docs/PROVIDER_EXAMPLES.md

• docs/REGISTRATION_QUICKSTART.md

• docs/HOSTED_PROVIDER_DELIVERY.md

Статус

Активный продуктовый репозиторий с четким направлением: бесплатный Консенсус, платная Проверка фактов, инфраструктура провайдеров в основе.