agentcontract v0.0.1: AI 코딩 에이전트를 위한 휴대용 JSON 권한 계층

agentcontract v0.0.1은 MIT 라이선스의 작은 Python 라이브러리로, AI 코딩 에이전트를 위한 휴대용 JSON 권한 계층을 정의합니다. 핵심 아이디어는 특정 에이전트 런타임에 독립적으로 에이전트가 수행할 수 있는 도구, 경로, 네트워크 작업을 지정하는 간단한 JSON 계약입니다.

주요 기능

• 권한 계약: 허용/거부된 도구, 허용/거부된 파일 경로, 네트워크 접근 제어, 인간 승인이 필요한 도구를 나열하는 JSON 구조입니다.
• agc gui: 대화형으로 계약을 작성, 검증, 저장하고 제안된 도구 호출을 드라이런할 수 있는 새 로컬 브라우저 UI입니다.
• 휴대성: 계약을 리포지토리에 커밋하고 일반 설정처럼 코드 리뷰를 할 수 있으며, 여러 에이전트/런타임에서 재사용할 수 있습니다.

예제 계약

{
  "allow_tools": ["read_file", "write_file"],
  "deny_tools": ["shell"],
  "allow_paths": ["./src/"],
  "deny_paths": ["~/.ssh/", "~/.env"],
  "allow_network": false,
  "require_approval": ["shell"]
}

이 계약은 에이전트가 ./src/ 아래의 파일만 읽고 쓸 수 있고, 셸 명령을 실행할 수 없으며(승인된 경우 제외), 네트워크 접근이 없도록 강제합니다. ~/.ssh/ 및 ~/.env/와 같은 민감한 경로에 대한 접근을 차단합니다.

각 도구의 내부 권한 모델을 신뢰하는 대신, 파일 작업, 명령 실행, API 호출 또는 토큰 소비 전에 모든 런타임이 확인할 수 있는 단일 휴대용 정책을 정의합니다.

대상 사용자

에이전트 도구를 구축하거나 실제 리포지토리에서 코딩 에이전트를 실행하며 지루하고 휴대 가능하며 감사 가능한 권한 계층을 원하는 개발자입니다.