Fulcrum Trust

支点信托

支点治理内核的信任引擎。多智能体AI系统的基于信任的断路。

   

这是什么？

fulcrum-trust 实现了代理到代理关系的Beta分发信任模型。当代理对的信任分数降至可配置的阈值以下时，电路就会中断——在失控循环发生之前终止交互。

数学：每次交互都会更新一个 Beta(α, β) 分布。信任评分= α / (α + β).开始于 (1.0, 1.0) 给出0.5的无信息先验。随着时间的推移，分数呈指数衰减至0.5（陈旧的关系会恢复为不确定性）。

快速开始

from fulcrum_trust import TrustManager, TrustOutcome

# Default: in-memory store, threshold=0.3, 24-hour decay half-life
tm = TrustManager()

# Record interaction outcomes
tm.evaluate("orchestrator", "code-agent", TrustOutcome.SUCCESS)
tm.evaluate("orchestrator", "code-agent", TrustOutcome.SUCCESS)
tm.evaluate("orchestrator", "code-agent", TrustOutcome.FAILURE)

# Check trust
print(tm.get_trust_score("orchestrator", "code-agent"))  # 0.6

# Circuit break check — use this in your agent loop
if tm.should_terminate("orchestrator", "code-agent"):
    raise RuntimeError("Circuit open — trust degraded below threshold")

使用FileStore在会话间保持不变：

from fulcrum_trust import TrustManager, TrustOutcome, TrustConfig
from fulcrum_trust.stores import FileStore

tm = TrustManager(
    store=FileStore("trust_state.json"),
    config=TrustConfig(threshold=0.3, half_life_seconds=3600),  # 1-hour decay
)

将信任事件发送到Fulcrum后端 FulcrumStore:

from fulcrum_trust import FulcrumStore, TrustManager, TrustOutcome

tm = TrustManager(
    store=FulcrumStore(
        api_key="your-fulcrum-api-key",
        base_url="https://api.fulcrumlayer.io",  # best-effort REST event target
    )
)

tm.evaluate("orchestrator", "code-agent", TrustOutcome.SUCCESS)

注： 这 /api/trust/events REST端点当前为 延期 — 支点io尚未公开。 FulcrumStore 先在本地写入，然后 best effort在事件失败时会附上警告日志，因此代理会保留 运行和本地信任状态仍然正确。用于生产交叉流程 今天集成，使用 RedisIPCBridge (fulcrum_trust.ipc.redis_bridge), 它将电路状态写入Redis，以便Go Execution读取O（1） 信封。

安装

pip install fulcrum-trust

# Optional numpy fast path for decay math:
pip install "fulcrum-trust[numpy]"

文档

• API 参考 --所有公共类和方法
• 博客文章 --为什么代理商需要断路器
• RLM Python原型 --第5阶段原型基准测试和架构（公开，不稳定）

支持

• 电子邮件： agent@fulcrumlayer.io
• GitHub讨论： 支点治理/支点信任/讨论

发展

git clone https://github.com/Fulcrum-Governance/fulcrum-trust
cd fulcrum-trust
pip install -e ".[dev]"
pytest              # Run tests (requires >=95% coverage)
mypy fulcrum_trust/ # Type check (strict mode)
ruff check .        # Lint
ruff format .       # Format

支点建筑的一部分

fulcrum-trust 是构成Fulcrum治理内核的四个存储库之一——一个位于意图和动作之间的可移植、类型化、预执行控制平面：

项目文档： 贡献 · 安全 · 更新日志 · 行为准则 · 引用

FulcrumStore 通过本地优先持久性和尽力REST事件传递将此包连接到主Fulcrum后端。对于当今的生产跨流程集成，请使用 RedisIPCBridge，其发布Go执行信封读取的O（1）的电路状态。Go后端具有奇偶校验测试，确保其信任实现与此Python包的行为完全匹配。

看 ADR-003 对于原始回购架构的基本原理；这 governance-interception-layer repo是在2026年4月添加的，当时GIL作为进程外执行边界发布。

建筑

fulcrum_trust/
├── types.py        — TrustOutcome enum, TrustState, TrustConfig, TrustCircuitOpen
├── evaluator.py    — TrustEvaluator: Beta(α,β) scoring, pair_id generation
├── decay.py        — Exponential decay toward uninformative prior
├── manager.py      — TrustManager: orchestrates evaluator + store + decay
├── context.py      — ContextVar isolation for concurrent evaluations
├── flusher.py      — Background telemetry batching (non-blocking store writes)
├── rlm/
│   ├── context.py  — 128k-bounded long-context externalization into symbolic handles
│   ├── runtime.py  — Restricted `peek` + `llm_batch` navigation runtime
│   ├── prototype.py — Gratitude-loop analysis + lost-in-the-middle benchmark
│   └── fixtures.py — Deterministic 100K+ token synthetic session generator
└── stores/
    ├── base.py     — TrustStore Protocol (structural subtyping)
    ├── memory.py   — MemoryStore (default, in-process)
    ├── file.py     — FileStore (JSON-backed, cross-session)
    └── fulcrum.py  — FulcrumStore (local-first + backend event shipping)

许可证

Apache 2.0。看 许可证.