
AETRE & The Governed Agent
io.github.grayclayton由 GitHub 帳號 grayclayton 發布v0.8.1更新於 Oct 24, 2026
Decision-theoretic triage and fail-closed agent gating: 32 tools over stdio.
概覽
一個在本機執行的決策理論分流與故障關閉式代理閘控伺服器,提供 24 個工具用於提案路由與自主動作審查。
- 可以做什麼
- AETRE & The Governed Agent 透過 stdio 提供 24 個工具,涵蓋兩個層面。宏觀層以貝氏資訊價值分流、Kingman 佇列延遲預測、探索稽核、質押排程與召回上限檢核來路由提案與交易流。微觀層以 Bellman 分流、將候選分類為 AUTO_EXECUTE、REQUIRE_REVIEW 或 REJECT 的三方審查邊界、背包准入控制器,以及故障關閉式拉取請求閘控來治理自主代理動作。此外還提供 4 個資源與 3 個提示。
- 適用情境
- 當你希望助理對大量提案、投稿或交易流進行分流,或把自主程式碼變更及其他代理動作置於故障關閉式驗證邊界之後時,值得加入。它定位為決策支援診斷,而非自主接受、拒絕、資助或投資決策。
- 執行需求
- 以本機程序透過 stdio 執行,可用 cargo(aetre-mcp)安裝或使用已發布的容器映像。選用 HTTP 模式預設綁定 127.0.0.1:8080;非回送位址啟動需要 AETRE_BIND_ADDRESS 與強式 AETRE_HTTP_SERVER_TOKEN,POST 用戶端需在 X-AETRE-Server-Token 標頭中送出,並置於 TLS 反向代理之後。未宣告任何帳號或 API 金鑰。
安裝
在 SourceWeft 中
- 開啟 儀表板中的 AETRE & The Governed Agent,將其新增到工作區。
- 為需要使用其工具的對話啟用該服務。
Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。
其他 MCP 客戶端
參照 儲存庫 中的啟動說明。
README
AETRE & The Governed Agent: Unified Decision-Theoretic Operating System
[Zenodo DOI (AETRE software)] [Zenodo DOI (replication bundle)] [SSRN: 7161458] [License: AGPL v3] [Rust: 1.75+] [Model Context Protocol]
"Governing Autonomous Intelligence in the Age of Abundance."
A high-performance, mathematically unified decision-theoretic operating system uniting macroeconomic proposal/portfolio triage (AETRE) and microeconomic execution governance (The Governed Agent).
Release status: experimental public alpha. The software and mathematical simulations are testable, but the demonstration records are synthetic and do not establish prospective effectiveness in a live conference, grant, or investment workflow. Use outputs as decision-support diagnostics, not as autonomous acceptance, rejection, funding, or investment decisions.
Based on the research series by Clayton Gray (2026):
- The Innovation-Absorption Gap: How Artificial Intelligence Can Accelerate Idea Production Faster Than Complementary Institutions Adapt
Clayton Gray (2026a) — SSRN: 7161458 - The Admission Frontier: An Economically Regulated Decision-Theoretic Runtime and Fail-Closed Verification Gate for Autonomous Agents
Clayton Gray (2026d) — distributed within the replication bundle The Implementation Frontier: Capital Allocation, Deliberative Stopping, and Verified Agent Gatekeeping (Zenodo: 10.5281/zenodo.22814799)
This software is archived under its own DOI, separate from the papers above: AETRE: Adaptive Epistemic Triage & Recall Engine (Zenodo: 10.5281/zenodo.22098366).
The Problem: The Innovation-Absorption Gap
When Artificial Intelligence makes idea and action generation cheap ($c_{\text{gen}} \to 0$), proposal and execution volume ($N$) explodes. However, downstream evaluation, laboratory validation, code review, and human gatekeeper capacity ($K$) remain strictly finite.
This creates three critical pipeline pathologies:
- The Kingman Delay Explosion: When evaluator utilization $\rho = \lambda / \mu$ approaches saturation ($\rho > 0.85$), wait times shoot up non-linearly according to Kingman's Heavy-Traffic equation: $$E[W_q] \approx \frac{\rho}{1-\rho} \cdot \frac{c_a^2 + c_s^2}{2} \cdot \frac{1}{\mu}$$
- The Asymmetric Payoff Trap: In heavy-tailed domains like venture capital, breakthrough discovery, and agentic code patches (Pareto index $\alpha \approx 1.25$), consensus-seeking scoring systems penalize high-variance, transformative outliers in favor of safe, incremental proposals.
- The Finite-Capacity Recall Ceiling (Proposition 1): Without active epistemic triage, true breakthrough recall asymptotically decays towards zero as arrival rates surge: $$R_N \le \min\left(1, \frac{K_N}{H_N}\right) \to 0 \quad \text{as } N \to \infty$$
Two-Layer Decision-Theoretic Architecture
AETRE unifies Macroeconomic Pipeline Triage (managing institutional review bandwidth and portfolio recall) with Microeconomic Execution Governance (safeguarding agentic execution runtimes and pull-request verification).
Repository Structure
Quickstart & CLI Usage
1. Run the Rust Test Suite & Verification
2. Run the Python Reference Governance Suite
3. Run the Standalone Governed Agent Pre-Commit Gate
Fast, fail-closed verification gate for agentic code modifications:
4. Run the Macro Monte Carlo & Dealflow Benchmarks
5. Simulate Institutional Heterogeneous Agent Queues
Simulates density-greedy $c\mu$-rule knapsack vs. FIFO across varying institutional review capacities:
Model Context Protocol (MCP) Integration
AETRE provides a high-performance native JSON-RPC 2.0 Model Context Protocol (MCP) server implementing 24 Tools, 4 Resources, and 3 Pre-Configured Prompts for Claude Desktop, Cursor, and autonomous agent sidecars.
Configuration (Claude Desktop / Cursor)
Install the binary (cargo install aetre-mcp),
then add to your claude_desktop_config.json. The server speaks stdio by default:
Local HTTP / Container Mode
HTTP mode binds to 127.0.0.1:8080 by default and does not enable cross-origin browser access. For container deployment, set AETRE_BIND_ADDRESS=0.0.0.0 and set a strong AETRE_HTTP_SERVER_TOKEN. Non-loopback startup fails closed when that token is absent. POST clients must send it in the X-AETRE-Server-Token header. Also place the service behind a TLS reverse proxy. The bundled Dockerfile supplies the bind address and runs as a non-root user.
Comprehensive 24-Tool Catalog
Macroeconomic Pipeline & Portfolio Tools (AETRE)
aetre_system_catalog: Diagnostic catalog of registered tools, resources, and algorithms.aetre_triage_proposal: Full three-stream triage routing (FAST_DROP,VOI_QUEUE,AUTO_PASS).aetre_calculate_voi: Closed-form Gaussian Value-of-Information ($V^*$) calculation.aetre_check_governor: Kingman heavy-traffic queue delay ($E[W_q]$) forecasting and capacity throttling.aetre_exploration_audit: Horvitz-Thompson unbiased discovery rate estimator ($\hat{H}_D$) for rejected pools.aetre_evaluate_staking: Anti-sybil quadratic staking schedule for incoming proposals.aetre_proposition_1_bound: Asymptotic recall bound ($R_N \le \min(1, K_N / H_N)$) verification.aetre_correlated_posterior_update: Multi-agent reviewer consensus correlation debiasing.aetre_heavy_tailed_voi: Pareto power-law ($\alpha \approx 1.25$) expected value of information for extreme outcomes.aetre_quadratic_staking: Continuous super-linear deposit curves to eliminate volume spam.aetre_heterogeneous_queues: Heterogeneous task duration and multi-server queue delay modeling.aetre_author_preflight_benchmark: Pre-flight variance and review risk diagnostic for manuscript drafts.aetre_simulate_benchmark: End-to-end multi-policy institutional pipeline Monte Carlo simulation.aetre_batch_triage: Bulk dataset triage for high-volume portfolio operations.aetre_recall_scaling_curve: Empirical recall scaling curves across arrival volumes.aetre_congestion_matching: Bipartite reviewer-candidate matching under capacity constraints.aetre_sequential_stopping_rule: Wald sequential likelihood ratio multi-round review termination.aetre_platt_calibrate: Empirical score recalibration via Platt sigmoid transformations.aetre_empirical_bootstrap: Non-parametric bootstrap confidence intervals for triage policies.aetre_frontier_sweep: Multi-dimensional ROC and cost-utility frontier sweep.
Microeconomic Agent Runtime Governance Tools (Governed Agent)
governed_bellman_triage: Evaluates agent action triage via Bellman dynamic programming and computes Expected Value of Verification ($V^*$).governed_review_boundary: Computes the tripartite decision boundary ($\Delta u = u_{\text{auto}} - u_{\text{review}}$) classifying candidates intoAUTO_EXECUTE,REQUIRE_REVIEW, orREJECT.governed_knapsack_admit: Density-greedy $c\mu$-rule knapsack controller packing candidates by value density ($\rho_i = \Delta u_i / c_i$) under budget $K$.governed_gate_pr: Road A fail-closed pull request gatekeeper evaluating verification, costs, blast radius, and test regressions.
Autonomous Agent Pre-Commit & CI Integration
The Governed Agent gatekeeper can be integrated into any autonomous coding agent pipeline (Claude Code, Cursor, GitHub Actions, pre-commit):
Pre-Commit Integration (.pre-commit-config.yaml)
GitHub Actions Pull Request Gate
See .github/workflows/governed-gate-template.yml for a complete workflow that fails closed on any unverified autonomous pull request.
Research publication status
AETRE is an independent open-source research project. No new commercial licenses, paid pilots, managed hosting, consulting, or paid support are currently offered. The project website is paused. Reports and questions can be submitted through this repository's issues; see SECURITY.md for private security reports.
The code remains available under AGPL-3.0-or-later, including for commercial use that complies with that license. This publication status does not revoke rights already granted or alter any existing written agreement.
Citation & Academic Reference
If you use AETRE or the Governed Agent runtime in your research or production systems, please cite:
License & Contact
The code is licensed under AGPL-3.0-or-later, including for commercial use subject to its terms. See LICENSING.md. Third-party components retain their own terms; the locked Rust dependency inventory and bundled notices are in THIRD_PARTY_NOTICES.md.
Bundled demonstration datasets are synthetic fixtures, not empirical validation corpora. This includes the institutional queue examples and the 15-task gatekeeper demonstration. See DATASETS.md for their scope and provenance. Evaluation fingerprints are reproducibility identifiers, not proof of external validation or a guarantee of safe execution.
- Author & Maintainer: Clayton Gray
- Project questions: GitHub issues
- Private security or privacy reports:
[email protected]
來源:README.md,提交 55dd701
工具
0版本歷史
2- v0.8.1最新Sep 20, 2026
- v0.6.0Sep 20, 2026
評分
已滿足適用檢查項的 50%
該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。
- 近 30 天內可連通25 分
請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。
- 已宣告認證方式10 分
請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。
- 已列出工具15 分
請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。
- 描述必需15 分
- 圖示10 分
- 文件15 分
- 授權條款10 分