Happy Thoughts

Happy Thoughts는 다음과 같은 단순한 구분으로 구축된 답변 제품입니다:

• **합의(Consensus)**는 사용자의 사고를 돕습니다.

• **사실 확인(Fact-checking)**은 사용자의 신뢰를 돕습니다.

대외적인 아이디어는 "올바른 모델을 선택하는 것"이 아닙니다. 핵심은 먼저 유용한 답변을 얻고, 더 높은 위험이 따를 때 더 강력한 검증을 위해 비용을 지불하는 것입니다.

시작하기

저장소에 처음 오셨다면 다음 경로를 따라가세요:

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. 구매자 계층

   • 인간이나 에이전트가 답변을 요청

   • 합의(Consensus)에서 무료 시작

   • 유료 결제 시 사실 확인(Fact-checking) 잠금 해제

2. 제품 계층

   • 계획, 할당량 및 게이팅 강제

   • 공개 계약을 통해 요청 라우팅

   • 신뢰도 + 주의사항이 포함된 깔끔한 답변 형태 반환

3. 제공업체 계층

   • 호스팅 제공업체 및 웹훅 제공업체가 답변을 공급

   • 제공업체는 여전히 중요하지만, 사용자가 백엔드 메커니즘을 먼저 이해할 필요는 없음

이러한 분리가 핵심입니다. 제품은 상단에서 단순하게 느껴지면서도 공급 측면은 하단에서 유연하게 유지됩니다.

제품 구성

합의(Consensus)

무료 또는 제한된 진입 경로입니다.

합의는 여러 모델의 응답을 비교하고 이를 단일 답변으로 종합하여 신뢰도와 주의사항을 반환합니다. 다음과 같은 용도로 설계되었습니다:

• 일상적인 질문

• 탐색적 사고

• 낮은 위험의 의사결정 지원

• 폭넓은 접근성

사실 확인(Fact-checking)

유료 신뢰 계층입니다.

사실 확인은 속도나 비용보다 사실적 신뢰도가 더 중요한 프롬프트를 위한 고보증 브랜치입니다. 내부적으로 요청 모드는 호환성을 위해 여전히 verified이지만, 공개 제품 언어는 사실 확인입니다. 이는 더 깊은 검증 구조를 하단에 유지하면서 간결한 최종 답변을 반환하도록 설계되었습니다. 다음과 같은 용도로 설계되었습니다:

• 사실 확인 스타일의 검토

• 더 높은 위험의 프롬프트

• 더 강력한 신뢰 신호

• 프리미엄 UX 및 결제 경로

이 저장소의 포함 내용

• Cloudflare Worker 애플리케이션 코드

• 답변 라우팅 및 종합 로직

• 계획 / 권한 스캐폴딩

• 제공업체 등록 + 호스팅 제공업체 배관

• 결제 및 활성화 흐름

• 법률/공개 제품 문서

• Worker 표면의 선별된 공개 코드 샘플

공개 저장소 범위

이 저장소는 모든 내부 순위 지정이나 오케스트레이션 결정을 보여주는 것이 아니라 제품 표면과 통합 계약을 보여주기 위한 것입니다.

공개 문서는 다음을 설명해야 합니다:

• 구매자가 호출할 수 있는 것

• 제공업체가 통합할 수 있는 것

• 존재하는 계획/게이트

• 안정적인 응답 형태 및 제어

공개 문서는 다음을 제공해서는 안 됩니다:

• 내부 가중치 로직

• 비공개 라우팅 휴리스틱

• 숨겨진 순위 지정 노브

• 비밀 평가 소스

프로젝트의 흥미로운 점

• 제품화된 다중 모델 오케스트레이션

• 무료에서 유료로 이어지는 답변 사다리

• 호스팅 제공업체 마켓플레이스 방향성

• 할당량 및 권한 강제

• 제공업체 실패 시 우아한 성능 저하(Graceful degradation)

• Worker 네이티브 배포 모델

현재 구현 방향

• 공개 요청은 기본적으로 **합의(Consensus)**를 지향함

• 무료 합의 할당량 강제

• **사실 확인(Fact-checking)**은 게이트가 있는 유료 경로로 존재

• 제품 표면 하단에 제공업체 공급이 여전히 존재

• 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

공개 청결도에 대한 참고 사항

이 저장소는 다음과 같이 제시될 때 가장 강력합니다:

• 제품 엔지니어링 저장소

• 결제 + 권한 저장소

• 다중 모델 답변 시스템

• Worker 네이티브 API/앱 배포

"LLM을 감싸는 또 다른 래퍼"가 아닙니다.

권장 시작 문서

• docs/PROVIDER_QUICKSTART.md

• docs/PROVIDER_EXAMPLES.md

• docs/REGISTRATION_QUICKSTART.md

• docs/HOSTED_PROVIDER_DELIVERY.md

상태

명확한 방향성을 가진 활성 제품 저장소: 무료 합의, 유료 사실 확인, 하단의 제공업체 인프라.