Rasczak Knowledge Commons

Rasczak エージェントサービス

無料でソースにリンクされた10種類の意思決定手法、任意で利用できる3つの意思決定パック、REST、静的ページ、ステートレスな MCP エンドポイント、オフラインのエージェントスキルを提供します。リクエストではレビュー済みの固定コンテンツを使用し、モデルへの呼び出しは行いません。支払いはデフォルトで無効です。有効にする前に、デプロイ担当者が実際の決済処理を確認する必要があります。

バージョン 0.4.0 では、意思決定ワークフローのプレビュー、無料のクライアントスキル、非公開のバージョン利用権コード、範囲を限定した公開ソースの収集が追加されました。最初のワークフローには5ドルの価格仮説がありますが、購入することはできません。モデルをペアにした評価と独立した試験は、引き続き保留中です。ホスト型リサーチはプレビューであり、利用可能なサービスではありません。

バージョン 0.4.1 では、Workers 内で再現されたコレクターの障害を修正しました。未対応のリダイレクト処理によってリクエストが妨げられていました。現在はリダイレクトを追跡せずに返し、明示的に拒否します。実行時に保持するのは範囲を限定した障害コードのみで、エラーメッセージやレスポンス本文は保存しません。実際の Workers ランタイムテストでは、外部ネットワークを合成レスポンスに置き換えて、収集処理とリダイレクト拒否を検証します。

/workflows/ と workflow_catalog MCP ツールでは、対象範囲と評価状況を確認できます。/books/ では、ロイヤリティの開示とともに2冊の任意の書籍を紹介します。顧客向け意思決定成果物は顧客のもとに保持されます。一般的なフィードバックは、作業内容を公開事例として再利用する許可にはなりません。

KitAccess は非アクティブなバックエンドコンポーネントで、使い捨てウォレット署名とローカルストレージのフィクスチャを使用してテストされています。決済済みのレシートは購入者、SKU、バージョン、アーティファクトのハッシュを紐付けます。ダウンロードごとに、新しい一度限りの署名を使用してアクセスを許可します。本番用の非公開ストレージ、実際の決済処理、返金照合については、引き続き適格性の確認が必要です。環境フラグでは、ワークフローの購入機能やアクセスルートを有効化できません。ソースコードと無料のクライアントは公開されていますが、非公開のワークフロー草案はこのリポジトリと静的アセットから除外されています。

任意のマーケットコレクターは、運営者が承認した GitHub の課題ソースを最大3件読み取り、UTC日ごとに重複を除いたリンクとタイトルを最大20件挿入します。レコード総数の上限は1,000件です。モデルへの呼び出しは行わず、課題のテキストを実行することもありません。承認済みソースは公開リクエスト本文ではなく、D1 を通じて非公開に設定してください。実行がクラッシュした場合は照合が必要です。プロバイダーによるスロットリングが発生した場合は、再試行せずに停止します。有効化フラグと承認済みソースがなければ、コレクターは実行されません。

調査プレビューとプライバシー

GET /api/v2/research では、将来提供予定の上限付き料金サービスについて説明します。GET /api/v2/kits では q、domain、offset、limit を使用できます。GET /api/v2/kits/{id} ではメタデータを取得できます。GET /api/v2/changes ではバージョン変更を確認できます。POST /api/v2/research/feedback では、OpenAPI スキーマに従って一般的な関心やスキルに関するフィードバックを送信できます。注文や請求が発生することはありません。フィードバックを有効にするには、RESEARCH_FEEDBACK_ENABLED=true、D1 バインディング、およびデプロイ用シークレットストアで設定された FEEDBACK_HASH_KEY が必要です。その値をソースやプロンプトに記載しないでください。

フィードバックを有効にする前に migrations/0002_research.sql を適用してください。日次の決定論的なクリーンアップでは、期限切れのフィードバックを集計し、30 日を過ぎた未加工の投稿を削除します。日次の上限は、仮名ごとに 5 件、ネットワークハッシュごとに 20 件、全体で 1,000 件です。ハッシュは、確認済みの顧客 ID ではありません。一般的なコメントには個人情報を含めないでください。顧客の事例や認証情報を投稿しないでください。本サービスから通知や営業連絡が送信されることはありません。

調査用の見積もり／注文／ステータス／結果／返金のエンドポイントは 503 を返します。Cloudflare Workflow のエントリーポイントは用意されていますが、バインドされておらず、常に実行を拒否します。実際のモデル通信機能と返金通信機能は意図的に含めていません。フラグを設定しても、このリリースゲートを回避することはできません。オフラインモジュールでは、整数単位のマイクロ USD 価格設定、30％のマークアップ、見積もりの承認、コストのアトミックな予約、不確定な呼び出しの照合、ライフサイクルの遷移、返金インテントを実装しています。ジョブのリハーサルには、注入されたモックアダプターのみを使用できます。

パイロットを開始する前に、アダプターの最悪ケースのコストを評価し、損失準備金を確保し、支払いと返金の精算を検証し、成果物の範囲をベンチマークし、明示的なローンチ承認を取得してください。表示トークンと推論トークン、ツール、検証、再試行、支払い手数料、返金手数料の予算を確保してください。未使用の資金は返還されます。契約した出力を提供できなかった場合は全額返金が必要です。これらのゲートを通過するまでは、見積もりを利用できません。

既存のソースライセンスに変更はありません。新しい有料キットの草稿は、このリポジトリにも静的アセットにも含まれていません。ランタイムのドキュメントは、モデルをまたいだ品質やトークン削減量を測定したことを示すものではありません。

ローカルで実行する

npm ci --include=dev
npm run check
npm run deploy:dry
npm run dev

Node 22 または固定されたローカル Node 依存関係を使用してください。SQLite テストでは Node の実験的な組み込みドライバーを使用し、ホストされたレシートでは Cloudflare D1 を使用します。

インターフェイス

• /api/v1/catalog では、サポートされているメソッドとパックの一覧を取得できます。
• /api/v1/methods/{id} では、無料のメソッドを取得できます。不明な ID の場合は 404 を返します。
• /api/v1/sample では、ベンダー評価用の完全な無料パックを取得できます。
• /api/v1/packs/{id} では、組み立て済みのパックを任意で購入できます。支払いが無効な場合は 503 を返します。有効な場合は、検証済みで記録された決済が必要です。
• /mcp では、Streamable HTTP を通じて catalog、method、sample_pack、pack_offer を公開します。これらのツールはいずれも、支払いや支出の承認を行いません。
• /full は 410 を返します。
• skill/rasczak-knowledge-commons には、オフラインスキルと 10 件のリファレンスが含まれています。

クライアントは、デプロイ担当者が設定したオリジンに接続してください。サービス URL とリポジトリリンクは設定値であり、アカウント識別子が埋め込まれているわけではありません。

MCP Registry の HTTP 所有権検証では、必要に応じてビルド時に MCP_REGISTRY_PUBLIC_KEY に base64 Ed25519 公開鍵を設定してください。公開検証レコードは /.well-known/mcp-registry-auth に生成されます。一致する秘密鍵はシークレットストア内だけに保管してください。サーバーが秘密鍵を必要とすることはありません。

ビルドと公開

scripts/build.mjs は、厳選されたカタログから静的リリースを生成します。scripts/package-release.mjs は、明示的な許可リストを使用して、独立したソースパッケージを作成します。どちらのスクリプトも、出力を書き込む前にプライバシーバリデーターを実行します。不明なリリースファイルがある場合、パッケージングは停止します。

ローカルの名前、アカウント識別子、元のファイル名、内部プロジェクト名を含む forbiddenStrings を設定した、非公開の JSON ポリシーファイルを RELEASE_PRIVACY_POLICY に指定します。このポリシーはリリースの外に保管してください。allowedPublicUrls を使うと、識別子の照合対象から、承認済みの正確な公開エンドポイントを除外できます。パターンチェックだけでは、すべての非公開識別子を検出できるとは限りません。プッシュする前に、Git の履歴と作成者のメタデータも別途確認してください。

生成したパッケージだけを、クリーンな別のチェックアウトから公開してください。中立的な作成者メタデータを使用してください。ソースアーカイブ、セッション記録、ブラウザープロファイル、認証情報、デバッグログ、ソースマップ、元の作業フォルダーをコピーしないでください。data/input.json のような汎用パスは、配布物の構成のみを示します。手法に関する主張を検証可能にするため、公開されている一次資料の引用は保持されます。

デプロイ

1. ホスティングの CLI を、使用するアカウントで認証します。設定はプロセス環境とホスティングのシークレットストアを通じて指定してください。ソース、ログ、コマンド、ドキュメントに認証情報の値を含めないでください。
2. ビルド時とデプロイ設定の両方で、検証済みの HTTPS オリジンを PUBLIC_ORIGIN に設定します。必要に応じて、承認済みの公開リポジトリを PUBLIC_REPOSITORY に設定します。再ビルドして npm run deploy:check を実行してください。
3. PAYMENTS_ENABLED=false と MAINNET_SETTLEMENT_APPROVED=false を維持します。許可リストに含まれるアセットと Worker のみをデプロイしてください。ホームページ、ヘルスチェック、カタログ、サンプル、不明な ID、Origin の拒否、無効化された決済、実際の MCP クライアント接続を検証してください。
4. レシートが必要な場合は、D1 データベースを作成し、RECEIPTS としてバインドして、migrations/0001_receipts.sql を適用します。独自のデータベース識別子を使用してください。スキーマを変更する前にレシートをバックアップしてください。
5. 決済試行には、Base Sepolia とその正確な USDC アセットを使用します。管理下にある受取アドレスから X402_PAY_TO を設定してください。このサーバーで受取ウォレットの秘密鍵が必要になることはありません。
6. ホスティングのシークレットとしてファシリテーターの認証情報を保存します。実際の決済、同一の再試行、リプレイの拒否、決済状態が不明な場合の照合、結果の復旧を検証してください。本番環境で決済を有効にする前に、明示的に承認された、範囲を限定したメインネット試行に合格する必要があります。
7. レジストリへの掲載には、検証済みの名前空間と URL を使用してください。掲載状況と、実際に独立した利用があるかどうかは別々に確認してください。これらのソースファイルから、掲載や顧客数が示唆されることはありません。

決済の動作と制限

このサービスは、Base または Base Sepolia 上で、120 秒の認可有効期間を持つ x402 v2 exact EIP-3009 を使用します。65 バイトの EOA 署名をサポートしています。ローカルの署名テストは暗号学的なもので、決済テストではフィクスチャーを使用します。

レシートはネットワーク、アセット、支払者、ノンス、証明ハッシュ、リソース、トランザクションを紐付けます。決済前に結果が保存されます。同じ記録済みの証明を使うと、追加料金なしで同じ結果を取得できます。リソースが変更されている場合は拒否されます。決済状態が不確かな場合は隔離され、自動的に再試行されることはありません。

決済が成功してもレシートのコミットに失敗した場合は、保存済みの結果を復旧する前に、ファシリテーターとチェーンの証拠を使ってレシートを照合してください。別の決済を強制するために予約をクリアしないでください。公開されたレシート編集エンドポイントや、自動返金アクションは存在しません。

測定プロトコルについては EVALUATION.md を参照してください。テスト、訪問数、所有者による支払いによって、顧客需要が証明されるわけではありません。