AgentBox 이전                    AgentBox 이후
─────────────────                  ──────────────
에이전트 → 전체 디스크 ❌               에이전트 → 허용된 경로만 ✅
에이전트 → 전체 네트워크 ❌             에이전트 → 허용된 호스트만 ✅
에이전트 → 원시 비밀값 ❌             에이전트 → 범위 제한 토큰 ✅
감사 추적 없음 ❌                  모든 작업 기록 ✅
킬 스위치 없음 ❌                  <100ms 내 종료 ✅
스킬이 root로 실행됨 ❌              커널 격리 샌드박스 ✅

# 설치
go install github.com/siyad01/agentbox/cmd/agentbox@latest

# 실행 전 매니페스트 검증
agentbox validate manifests/email-sorter.yaml

# 샌드박스에서 에이전트 실행
agentbox run --manifest manifests/email-sorter.yaml python agent.py

# 에이전트가 수행한 작업 확인
agentbox audit --log logs/email-sorter-audit.log

# 로그가 변조되지 않았는지 검증
agentbox verify logs/email-sorter-audit.log

# 비밀값 관리
agentbox vault add ANTHROPIC_API_KEY
agentbox vault list

name: "email-sorter"
version: "1.0.0"
description: "받은 편지함을 읽고, 이메일을 분류하고, 정리된 폴더에 씁니다"
runtime: docker        # 또는: gvisor (커널 수준), firecracker (MicroVM)

permissions:
  filesystem:
    read:
      - "~/Documents/inbox"
    write:
      - "~/Documents/sorted"
    deny:                      # 항상 차단 — 읽기 목록에 있어도
      - "~/.ssh"
      - "~/.aws"
      - "~/.config"
      - "/etc"

  network:
    allow:
      - "api.anthropic.com"
      - "gmail.googleapis.com"
    deny:
      - "*"                    # 그 외 모든 것 차단

  tools:
    allow:
      - "read_file"
      - "write_file"
      - "list_*"
    deny:
      - "execute_shell"        # 셸 접근 금지, 절대
      - "*_delete"             # 삭제 도구 금지

  credentials:
    - ANTHROPIC_API_KEY        # 런타임에 금고에서 주입
    - GMAIL_TOKEN              # 에이전트는 원시 값을 절대 볼 수 없음

limits:
  max_tokens:    50000         # LLM 토큰 예산
  max_duration:  "30m"         # 30분 후 종료
  max_memory_mb: 256           # RAM 상한
  max_requests:  500           # 최대 도구 호출 수

audit:
  log_level: full
  alert_on:
    - filesystem_deny
    - network_deny
    - token_budget_80pct
  log_path: "logs/email-sorter-audit.log"

agentbox run --manifest agent.yaml python agent.py
         │
         ▼
┌─────────────────────────────────────────────────────┐
│                 정책 엔진                             │
│  매니페스트 파싱 → 허용/거부 목록 생성                │
│  서명 검증 → 서명되지 않은 스킬 거부                  │
│  금고에서 자격 증명 주입                             │
└──────────────────────┬──────────────────────────────┘
                       │
                       ▼
┌─────────────────────────────────────────────────────┐
│              격리 계층                               │
│                                                     │
│  Docker  → 컨테이너 + seccomp + cap-drop            │
│  gVisor  → 사용자 공간 커널, 시스템 콜 가로채기      │
│  Firecracker → 에이전트별 전용 MicroVM 커널          │
│                                                     │
│  파일시스템: 선언된 경로만 마운트                    │
│  네트워크:    선언된 호스트만 연결 가능              │
│  Capabilities: 모두 제거, 추가 없음                  │
└──────────────────────┬──────────────────────────────┘
                       │
          ┌────────────┼────────────┐
          ▼            ▼            ▼
   감사 로거      자격 증명     리소스
   (해시 체인)     금고        모니터
   모든 작업      AES-256-GCM  한도 초과 시
   기록          범위 제한 토큰 자동 종료

에이전트 시도: write("/home/user/.ssh/id_rsa")
                    │
                    ▼
         gVisor 사용자 공간 커널
                    │
         거부 목록에 있는 경로? → 예
                    │
                    ▼
         EPERM 즉시 반환
         호스트 커널은 이 시스템 콜을 볼 수 없음
         프롬프트 인젝션은 이 계층을 넘을 수 없음

agentbox <command> [options]

명령어:
  run       샌드박스에서 에이전트 실행
  validate  매니페스트 파일 검증
  kill      실행 중인 에이전트 종료
  audit     에이전트 감사 로그 보기
  verify    감사 로그 무결성 검증
  vault     암호화된 자격 증명 관리
  serve     REST API 서버 시작
  version   버전 표시

예시:
  agentbox validate manifests/email-sorter.yaml
  agentbox run --manifest manifests/email-sorter.yaml python agent.py
  agentbox kill agent-abc123
  agentbox audit --log logs/email-sorter.log --deny
  agentbox audit --log logs/email-sorter.log --last 1h
  agentbox verify logs/email-sorter.log
  agentbox vault add ANTHROPIC_API_KEY
  agentbox vault list
  agentbox vault delete OLD_KEY
  agentbox serve :8081

# 실행 중인 에이전트 목록
curl http://localhost:8081/api/agents

# 에이전트 시작
curl -X POST http://localhost:8081/api/agents \
  -H "Content-Type: application/json" \
  -d '{"manifest":"manifests/email-sorter.yaml","command":["python","agent.py"]}'

# 에이전트 종료
curl -X DELETE http://localhost:8081/api/agents/abc123

# 감사 로그 조회
curl "http://localhost:8081/api/audit?deny=true&agent=email-sorter"

{"id":1,"hash":"a3f2...","prev_hash":"genesis","timestamp":"2026-05-05T09:00:00Z","agent_id":"abc123","agent_name":"email-sorter","event_type":"agent_start","allowed":true,"resource":"manifests/email-sorter.yaml"}
{"id":2,"hash":"b7c1...","prev_hash":"a3f2...","timestamp":"2026-05-05T09:00:01Z","agent_id":"abc123","agent_name":"email-sorter","event_type":"filesystem_allow","allowed":true,"resource":"read:/home/user/Documents/inbox/mail.txt","rule":"filesystem.read: ~/Documents/inbox"}
{"id":3,"hash":"d9e4...","prev_hash":"b7c1...","timestamp":"2026-05-05T09:00:01Z","agent_id":"abc123","agent_name":"email-sorter","event_type":"filesystem_deny","allowed":false,"resource":"read:/home/user/.ssh/id_rsa","rule":"filesystem.deny: ~/.ssh","reason":"path is explicitly denied"}

agentbox verify logs/email-sorter-audit.log

✅ 감사 로그가 온전합니다
   항목: 47 (ID 1–47)
   해시 체인: 끊김 없음

# 비밀값 저장 (절대 기록되지 않으며, 환경 변수에 평문으로 존재하지 않음)
agentbox vault add ANTHROPIC_API_KEY

# 저장된 자격 증명 이름 목록 (값은 절대 표시되지 않음)
agentbox vault list

# 자격 증명이 복호화 가능한지 확인
agentbox vault test ANTHROPIC_API_KEY

# 자격 증명 교체
agentbox vault add ANTHROPIC_API_KEY   # add는 기존 항목을 업데이트

# 이 에이전트는 max_duration: 5s로 구성됨
agentbox run --manifest manifests/timeout-test.yaml python long_running_agent.py

Agent started
tick 1
tick 2
tick 3
tick 4
tick 5
🛑 Killing agent timeout-test: duration limit exceeded: 5s
⚠️  Agent timeout-test exited code 137 in 5.2s

# 클론
git clone https://github.com/siyad01/agentbox
cd agentbox

# 빌드
go build -o agentbox ./cmd/agentbox/

# 테스트 실행 (27개 테스트, 모두 통과)
go test ./...

# 전역 설치
go install ./cmd/agentbox/

agentbox/
├── cmd/agentbox/main.go          ← CLI 진입점
├── internal/
│   ├── policy/
│   │   ├── manifest.go           ← YAML 매니페스트 스키마
│   │   ├── parser.go             ← 검증 + 기본값
│   │   └── engine.go             ← 거부 우선 결정 엔진 (20개 테스트)
│   ├── audit/
│   │   ├── logger.go             ← 추가 전용 SHA-256 해시 체인 로그
│   │   ├── verifier.go           ← 변조 감지
│   │   └── reader.go             ← 조회 + 필터
│   ├── vault/
│   │   ├── store.go              ← AES-256-GCM 암호화 자격 증명 저장소
│   │   └── injector.go           ← 런타임 주입 (7개 테스트)
│   ├── sandbox/
│   │   ├── sandbox.go            ← Sandbox 인터페이스
│   │   ├── docker.go             ← Docker 백엔드
│   │   ├── gvisor.go             ← gVisor 백엔드 (커널 수준)
│   │   ├── manager.go            ← 에이전트 수명 주기 관리
│   │   └── util.go               ← WSL2 감지, 경로 헬퍼
│   ├── monitor/
│   │   └── enforcer.go           ← 리소스 한도 + 자동 종료
│   └── api/
│       └── server.go             ← :8081의 REST API
└── manifests/
    ├── email-sorter.yaml         ← 프로덕션 예시
    └── timeout-test.yaml         ← 한도 강제 예시