hoophq/hoop

エージェントのランタイム制御

データとコンテキストがエージェントを有用にします。ランタイムコントロールがエージェントを安全にします。 オープンソースのサイドカーだ。バイナリ1つ、設定ファイル1つ、MITだ。

あなたのエージェントが見るもの

クエリは実行されます。機密フィールドは隠されたままです。

マスキングはメモリ上で応答を書き換えます。リクエスト自体は決して触られません。

その声明はデータベースに届かない。

設定に書いたメッセージを載せる本物のpgwireエラーです。エージェントは切断された理由を読み取り、切断を推測するのではありません。

エージェントはサイドカーの存在を決して知りません。SDKもプロンプト変更もエージェント側の設定もありません。

インストール

設定

1つのファイルです。これはメールを編集し、破壊的なSQLを拒否します。

走れ

設定が全くないのに、サイドカーは起動します:ループバックURLが1つ スタートガイドへ転送します。検査 交通はなく、最初の回線がうまくいくために存在します。端末はどういう意味か教えてくれます 本物の設定に置き換えるためです。

エージェントをデータベースではなく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