Quesen Deterministic Agent Decision Layer

Quesen — 開発者ポータル

Quesen は、エージェントのアクションに対する決定論的な判定・レシートコアです — 型付きのセキュリティコンテキストを入力すると、PASS / REVIEW / BLOCK / SKIP の判定を返し、 機械可読な理由コードと、バイト単位で再実行し、証明できるレシートを提供します。 スコアリング経路ではモデル推論を行わないため、同じ入力には常に同じ判定が返されます。 インジェクション検出の背後、エージェントのアイデンティティの上位に配置し、 判定ごとに課金するよう設計されています（ASP/402）。

監査証跡が運営者の言い分を運営者が記録したものにすぎないログベースのガバナンスレイヤーとは異なり、 Quesen のレシートは呼び出し元が独立して検証可能です — 再計算でき、（エンジンの署名が有効な場合は）Ed25519 署名が付与されます。詳細は docs/architecture-gap-closers.md と、 quesen-sdk ≥ 0.5.0 によるクライアント側の適用とレシート検証をご覧ください。 本番環境のエンジン署名は稼働中です — Senueren を信頼する必要なく実際の署名付きレシートを検証する方法は、 docs/verify-live-receipt.md をご覧ください。

このリポジトリは公開開発者ポータルです。含まれるのは、ドキュメント、統合ガイド、サンプル、 レジストリマニフェスト、参照リンクのみです。エンジンのソースコードは含まれていません。 Quesen のエンジン実装は、 独立して管理される非公開インフラです。

本番環境

サービス	URL
REST API	https://api.senueren.co.za
MCP（ストリーミング可能な HTTP）	https://api.senueren.co.za/mcp
OpenAPI 3.1	https://api.senueren.co.za/openapi.json
Swagger UI	https://api.senueren.co.za/docs
ヘルスチェック	https://api.senueren.co.za/health
バージョン	https://api.senueren.co.za/version

---

クイックスタート（30 秒）

最短の方法 — インストール不要、サインアップ不要、カード不要。 無料のサンドボックスキーをセルフサービスで取得し、本番環境で 実際の決定論的な判定を実行できます。詳しいガイドは docs/QUICKSTART.md をご覧ください。 · ブラウザーで試す場合は senueren.co.za/try をご利用ください。

# 1 · get a free sandbox key
curl -X POST https://api.senueren.co.za/sandbox/keys

# 2 · evaluate an action (use the api_key from step 1)
curl -X POST https://api.senueren.co.za/validate \
  -H "X-API-Key: sk_sandbox_..." \
  -H "Content-Type: application/json" \
  -d '{"domain_age_days": 1, "engagement_ratio": 0.95, "scam_keyword_count": 4}'
# -> {"decision":"SKIP","risk_score":1.0,"conflict_triggers":[...],"input_snapshot_hash":"..."}

SDK

公開済み。 SDK は PyPI と npm で公開中です（quesen-sdk 0.5.0 / npm 0.5.0、 quesen-langchain、quesen-crewai、quesen-autogen 0.3.0）。すべての SDK で base_url と X-API-Key（上記のサンドボックスキーを含む）は共通です。

Python

pip install quesen-sdk   # PyPI: https://pypi.org/project/quesen-sdk/

from quesen_sdk import QuesenClient

q = QuesenClient(base_url="https://api.senueren.co.za",
                 api_key="YOUR_KEY")   # a sandbox key from /sandbox/keys works here

verdict = q.validate(domain_age_days=1, engagement_ratio=0.95, scam_keyword_count=4)
if verdict.decision == "SKIP":
    return  # respect the deterministic answer

JavaScript / TypeScript

npm i quesen-sdk   # npm: https://www.npmjs.com/package/quesen-sdk

import { QuesenClient } from "quesen-sdk";

const q = new QuesenClient({
  baseUrl: "https://api.senueren.co.za",
  apiKey: process.env.QUESEN_API_KEY,
});

const verdict = await q.validate({
  domain_age_days: 1,
  engagement_ratio: 0.95,
  scam_keyword_count: 4,
});

フレームワーク用ラッパー

フレームワーク	パッケージ	リポジトリ
LangChain / LangGraph	quesen-langchain	Shxnque/quesen-langchain
CrewAI	quesen-crewai	Shxnque/quesen-crewai
AutoGen v0.4+	quesen-autogen	Shxnque/quesen-autogen
Python（コア）	quesen-sdk	Shxnque/quesen-sdk-py
JavaScript / TypeScript	quesen-sdk (npm)	Shxnque/quesen-sdk-js

MCP（Claude Desktop、Cursor、Windsurf など）

Quesen は本番エンドポイント経由で 5 つの MCP ツールを提供します。クライアント設定スニペットについては docs/mcp.md をご覧ください。

---

Quesen が選ばれる理由

自律型エージェントは、人間による監視では監査しきれないほど多くの判断を毎秒下します。その判断に資本が関わる場合――トークンの発行、ポジションの開始、取引の実行、スマートコントラクトのデプロイ承認など――誤った判断の限界コストは致命的です。

Quesen が答えるのは、ただ一つの問いです。

呼び出し元のエージェントは、このアクションを実行すべきでしょうか？

入力は型付けされています。出力は PROCEED、REVIEW、SKIP のいずれかで、常に [0.0, 1.0] の risk_score、[0.0, 1.0] の confidence、および発動した競合ルールの正確な内容を含みます。同じ入力なら、毎回同じ出力になります。 すべての応答には engine_version、weights、thresholds が含まれます。完全に再現可能で、完全に監査可能です。

Quesen が該当しないもの

• LLM ラッパーではありません。 プロンプトも確率もありません。
• チャットボットではありません。 A2A インフラストラクチャです。
• KYC／本人確認システムではありません。 本人確認ではなく、リスクをスコアリングします。
• 特定のチェーン、フレームワーク、LLM に限定されません。 エコシステムに依存しない設計です。

---

ドキュメント

• クイックスタート — 10 分以内に最初の判断を実行できます（無料のサンドボックスキー）。
• アーキテクチャの概要
• 統合ガイド
• API リファレンス
• MCP のセットアップ
• 料金プラン
• FAQ
• レジストリのステータス
• エビデンスと事例研究 — 検証済みの上流マージと、ライブ環境でバイト単位の再生が可能なレシート。エンジニアリング／標準規格に関するエビデンスのみであり、顧客獲得実績は主張していません。

独立した検証

公開済みのレシートは、ホスト型サービスや非公開エンジンを必要とせず、このリポジトリだけで独立して再現できます。

python3 verify/verify_receipts.py          # offline, stdlib-only
python3 verify/verify_receipts.py --live   # also cross-check the live engine

6 件すべての UCP #724 ベクトルで、公開済みフィクスチャ、公開リファレンス、ライブエンジンの 3 者間にバイト単位の一致が確認できます （verify/README.md、verify/three_way_match.json）。 このドキュメントでは、現時点で独立検証が及ばない範囲についても率直に記載しています（本番ルールセットの commit_sha は公開情報から解決できず、レシートにはまだ暗号学的な発行者署名がありません）。

セキュリティ統合でゲート判定に用いる送信先／権限に関する判断のサブセットも、ネットワーク接続なしで、オフラインで独立した 判定 の再生が可能になりました。

python3 evaluation/conformance/verify_conformance.py   # offline; recomputes decision+reasons+hash

6 件のケース（OWASP-agentic と LoopX の prepared-Effect における PASS／REVIEW／BLOCK）は、公開リファレンス評価器からバイト単位で再計算されます。さらに prod-1→prod-2 の整合性反転チェックも含まれており、登録、キー、ホスト型サービスへの呼び出しは不要です （evaluation/conformance/README.md）。

チュートリアル

• Moltbook 投稿ガード — 自律型ソーシャルエージェント向けの、投稿前に実行する決定論的な安全ゲート。
• OpenClaw MCP プラグイン — Quesen を MCP ネイティブのガードレールとして OpenClaw スタイルのエージェントに組み込む方法。

Live status

• Production: https://api.senueren.co.za
• Health check: GET /health returns {"status":"ok","engine_version":"1.10.0"}
• Version snapshot: GET /version returns full engine + billing + on-chain flags (ASP/1.0)
• Uptime and version widget on senueren.co.za/quesen

---

Registry presence

Quesen is discoverable via Model Context Protocol registries and the standard agent-directory ecosystem. See docs/registries.md for the current state of each submission. Manifests:

• smithery.yaml — Smithery.ai (canonical)
• mcp.json — MCP.so / generic MCP client (canonical)
• .well-known/ai-plugin.json — OpenAI plugin manifest / .well-known/ai-plugin.json autodiscovery
• llms.txt — machine-readable summary for LLM crawlers

---

Contributing

This is a documentation-only repository. Engine PRs cannot be accepted here. If you have integration-specific feedback, please open an issue or read CONTRIBUTING.md.

SDK contributions belong in the corresponding public SDK repository:

• Python: Shxnque/quesen-sdk-py
• JavaScript: Shxnque/quesen-sdk-js
• LangChain: Shxnque/quesen-langchain
• CrewAI: Shxnque/quesen-crewai
• AutoGen: Shxnque/quesen-autogen

Security issues: please read SECURITY.md before filing publicly.

---

Community

Follow build updates, agent-governance notes, and Quesen releases on X: @SenuerenGroup · web: senueren.co.za · senueren.co.za/quesen.

If a Quesen integration or a merged contribution helped your project, a follow or a note at @SenuerenGroup is always appreciated.

---

License

MIT. See LICENSE.