hoophq/hoop

에이전트를 위한 런타임 제어

데이터와 맥락이 에이전트를 유용하게 만듭니다. 런타임 컨트롤이 에이전트를 안전하게 만듭니다.
오픈소스 사이드카. 바이너리 하나, 설정 파일 하나, MIT야.

당신의 에이전트가 보는 것

쿼리가 실행됩니다. 민감한 필드는 숨겨져 있습니다.

마스킹은 응답을 메모리에서 다시 작성합니다. 요청 자체는 절대 건드리지 않습니다.

그 성명서는 데이터베이스에 도달하지 않습니다.

설정에 적은 메시지를 전달하는 진짜 pgwire 오류입니다. 에이전트가 연결이 끊겼다고 추측하는 대신 왜 거부되었는지 확인합니다.

에이전트는 사이드카가 존재한다는 사실을 전혀 모릅니다. SDK도 없고, 프롬프트 변경도 없으며, 에이전트 측 설정도 없습니다.

설치

구성

파일 하나. 이 파일은 이메일을 삭제하고 파괴적인 SQL을 거부합니다.

도망쳐

설정 자체가 없어도 사이드카는 어쨌든 시작됩니다: 루프백 URL 하나가 시작 가이드로 넘어갑니다. 검사합니다 트래픽이 없어요 — 첫 주행이 제대로 작동하기 때문에 존재하니까요 — 그리고 터미널이 어떻게 작동하는지 알려줍니다 실제 구성으로 교체하는 것.

에이전트를 데이터베이스 대신 127.0.0.1:15432로 돌리세요. 에이전트는 한 가지를 바꿉니다: 연결 문자열의 포트입니다. 사이드카는 데이터베이스 옆에 위치하며, 대신 움직이지 않습니다.

네 가지 조종

**데이터 마스킹.

Runtime control for agents

Data and context make agents useful. Runtime controls make them safe. An open-source sidecar. One binary, one config file, MIT.

What Your Agent Sees

The query runs. The sensitive fields stay hidden.

> pull the customer list for the churn report

● postgres(SELECT name, email FROM customers)
  ⎿  name           email
     Ada Lovelace   [REDACTED:EMAIL_ADDRESS]
     Grace Hopper   [REDACTED:EMAIL_ADDRESS]
     hoop.dev · emails redacted at the wire

Masking rewrites the response in memory. The request itself is never touched.

The statement never reaches the database.

> clean up the old test rows in customers

● postgres(DELETE FROM customers WHERE id = 1)
  ⎿  FATAL:  destructive statements are not permitted
     hoop.dev · guardrail: no-destructive-sql

A real pgwire error carrying the message you wrote in the config. The agent reads why it was refused instead of guessing at a dropped connection.

The agent never knows the sidecar exists. No SDK, no prompt changes, no agent-side config.

Install

brew tap hoophq/brew https://github.com/hoophq/brew.git
brew install hoop

Configure

One file. This one redacts emails and refuses destructive SQL.

log_level: info

admin:
  listen: 127.0.0.1:19000        # /healthz /stats /config /events

mask:                            # Data Masking
  enabled: true
  rules:
    - {name: emails, entity: EMAIL_ADDRESS, strategy: redact}

policy:                          # Guardrails
  enforce: true
  rules:
    - name: no-destructive-sql
      type: operation
      operations: [drop, delete, truncate]
guardails:
  rules:
    - name: no-destructive-sql
      type: operation
      operations: [drop, delete, truncate]
      message: destructive statements are not permitted

listeners:
  - name: localdb
    protocol: postgres           # postgres | mssql | http
    listen: 127.0.0.1:15432      # where clients connect
    upstream: 127.0.0.1:5432     # your real resource
    connection: localdb

Run

hoop start sidecar                                # no config: a built-in default
hoop start sidecar --config config.yaml           # start
hoop start sidecar --config config.yaml --validate # check the config, then exit