원문 캡처 · github.com
원문 캡처 · github.com

Agent Middleware는 환불·지급·배포처럼 위험한 에이전트 도구 호출을 중개하는 게이트웨이다. 각 호출에 서명된 허가를 요구하고, 같은 요청 키로 재시도하면 다시 실행하지 않도록 하며, 오프라인에서 확인할 수 있는 서명된 영수증을 남긴다.

현재 사전 출시 단계이며 1인 유지보수 프로젝트다. PyPI나 npm에 배포되지 않아 소스에서 설치해야 한다. 제작자는 데모 키와 지갑 ID를 받아 호스팅 데모를 실행하는 방법을 안내한다. 예제는 허가를 만든 뒤 참조용 echo 도구를 호출하고, 같은 키로 재시도한 다음 영수증을 오프라인에서 확인한다.

sh
git clone https://github.com/agentmiddleware/amw-demo.git
cd amw-demo
python3 -m venv .venv
source .venv/bin/activate
pip install -e .
export AMW_API_KEY='<your key>'
export AMW_WALLET_ID='<your wallet id>'
python examples/permit_echo_retry.py

게이트웨이를 로컬에서 실행하려면 저장소의 Makefile을 이용한다. 자세한 절차는 QUICKSTART.md에 있다.

sh
git clone https://github.com/agentmiddleware/agent-middleware
cd agent-middleware/gateway
make quickstart

허가(Permit)는 에이전트가 사용할 수 있는 도구와 예산, 만료 시각을 제한하는 서명된 승인이다. 호출(Call)은 허가에 따라 관리되는 MCP 도구 실행을 뜻한다. 요청 키(Request key)는 재시도 처리를 위한 Idempotency-Key 헤더다. 영수증(Receipt)은 호출 결과와 요청·응답 해시를 담은 서명 기록이며, 해당하는 경우 차감 내역 링크도 포함한다. 크레딧은 돈이 아니라 내부 사용량 측정 단위다.

같은 키로 재시도하면 게이트웨이는 다시 호출하는 대신 원래 영수증을 반환한다. 새 키는 새 요청으로 취급하며, 같은 키를 다른 요청에 재사용하면 도구 호출 전에 충돌로 거부한다. 다만 delivery_uncertain 영수증은 신뢰할 만한 응답을 받지 못했다는 뜻이다. 이 경우 차감은 유지되고 운영자가 하위 도구와 대조해야 하며, 게이트웨이가 자동으로 재전송하지 않는다.

게이트웨이는 키별 호출과 차감을 제한하지만, 원격 작업의 결과는 하위 도구가 전달된 키를 따르는지에 달려 있다. 영수증은 요청과 응답의 해시에 서명할 뿐 원문 내용을 담지 않으며, 원격 작업이 실제로 일어났음을 증명하지 않는다. 따라서 이 방식은 ‘정확히 한 번’ 실행을 보장하지 않는다. 중요한 작업에 게이트웨이를 사용하기 전에는 보안 한계 문서를 확인해야 한다.

저장소에는 게이트웨이 구현과 Makefile, Python·TypeScript 클라이언트 및 검증 코드, 오프라인 검증 안내서, 초안 형식, 프레임워크 연동 도구와 실행 예제가 포함돼 있다. 관련 자료로는 게이트웨이, SDK, 검증기, 형식 명세, 연동 도구, 예제, 호스팅 데모, PayPal 에이전트 데모가 있다. 라이선스는 Apache 2.0이며, 게이트웨이는 Fair Source FSL-1.1을 적용한다.