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. プロバイダー層

   • ホスティングプロバイダーおよびWebhookプロバイダーが回答を提供

   • プロバイダーは重要ですが、ユーザーはバックエンドの仕組みを先に理解する必要はありません

この分離こそが重要です。プロダクトの表面はシンプルに保ちつつ、サプライサイドは柔軟性を維持します。

プロダクトの構成

コンセンサス

無料または上限付きのエントリーパス。

コンセンサスは複数のモデルの回答を比較し、それらを単一の回答に統合して、信頼度と注意書きを返します。以下を目的として設計されています：

• 日常的な質問

• 探索的な思考

• 低リスクな意思決定のサポート

• 幅広いアクセシビリティ

ファクトチェック

有料の信頼レイヤー。

ファクトチェックは、速度やコストよりも事実の正確性が重要となるプロンプトのための、より高い保証を提供するブランチです。内部的なリクエストモードは互換性のために verified ですが、公開プロダクトの言語としてはファクトチェックと呼称します。簡潔な最終回答を返しつつ、より深い検証構造を裏側で利用できるように設計されています。以下を目的として設計されています：

• ファクトチェック形式のレビュー

• リスクの高いプロンプト

• より強力な信頼性のシグナル

• プレミアムなUXと課金パス

このリポジトリの内容

• Cloudflare Workerアプリケーションコード

• 回答ルーティングおよび統合ロジック

• プラン / 権限管理の基盤

• プロバイダー登録 + ホスティングプロバイダーの連携機能

• 課金およびアクティベーションフロー

• 法的/公開プロダクトドキュメント

• Workerインターフェースの厳選された公開コードサンプル

公開リポジトリの境界線

このリポジトリは、すべての内部ランキングやオーケストレーションの決定事項ではなく、プロダクトの表面と統合契約を示すことを目的としています。

公開ドキュメントで説明すべきこと：

• バイヤーが呼び出せるもの

• プロバイダーが統合できるもの

• 存在するプラン/ゲート

• 安定しているレスポンス形式と制御

公開ドキュメントで公開すべきではないこと：

• 内部の重み付けロジック

• 非公開のルーティングヒューリスティック

• 隠されたランキング調整ノブ

• 秘密の評価アルゴリズム

このプロジェクトの興味深い点

• プロダクト化されたマルチモデルオーケストレーション

• 無料から有料への回答ラダー

• ホスティングプロバイダーマーケットプレイスの方向性

• クォータと権限の強制

• プロバイダー障害時の正常な縮退（グレースフル・デグラデーション）

• Workerネイティブなデプロイモデル

現在の実装方針

• 公開リクエストはデフォルトで コンセンサス に向かう

• 無料のコンセンサスクォータを強制

• ファクトチェック はゲート付きの有料パスとして存在

• プロダクトの表面下にはプロバイダーの供給が存在

• PayPalのキャプチャフローは、完了後にのみアクティベートされるよう強化

信頼性モデル

コンセンサスは、正常に縮退するように設計されています。

1つのプロバイダーが失敗しても、可能な限りリクエストは完了します。 すべてが完璧であるかのように装うのではなく、失敗のメタデータが表面化されます。

レスポンスレベルの重要な概念：

• confidence

• confidence_reason

• models_used

• models_failed

• meta.degraded

• meta.failure_count

課金パス

Happy Thoughtsは現在、2つのアクティベーションスタイルをサポートしています：

• 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

ステータス

明確な方向性を持つアクティブなプロダクトリポジトリ： 無料のコンセンサス、有料のファクトチェック、その下層にプロバイダーインフラストラクチャ。