本文へ移動
hs-sql-agent

Safe DML

正確な Mutation Evidence を承認し、全件 commit か全件 rollback かを決めます。

execute_dml_sql は Preview、承認、commit 直前の再検証、1 つのサーバー所有 Transaction を通して 1 つ以上の対応 DML を実行します。第一方の既定は MCP Elicitation で、公式 Webhook や独自 Provider も利用できます。

01

1 Tool、1 Transaction

セミコロン区切りの DML は execute_dml_sql のまま扱い、1 回承認して元の順序で原子的に commit します。

02

Evidence に結び付く承認

UPDATE / DELETE は正確な Row Set、INSERT VALUES は不変 Payload と Compile 済み Command に結び付きます。

03

差し替え可能な承認 Provider

MCP Elicitation、公式 Webhook adapter、独自 IDmlApprovalProvider を使えますが、SQL 実行権限は渡しません。

Tool を増やさず atomic multi-statement DML

Built-in MCP Surface は小さいままです。execute_dml_sql 自体がセミコロンで区切った UPDATE、DELETE、INSERT VALUES を 1 つ以上受け取り、Batch を 1 回だけ承認して 1 つの Transaction で commit します。どれかが stale または失敗なら全体を rollback します。

承認は実行権限にならない

承認 Provider が受け取るのは transport-neutral Evidence です。Database Connection、Transaction、検証済み Plan、commit primitive は渡りません。検証、Evidence Binding、再検証、実行は hs-sql-agent が所有します。

Durable な外部 Workflow も再検証する

非同期 Provider は Pending を返せます。後の完了 Decision では現在の認可と DB 設定を再読み込みし、DML を再 Parse / Preview して Evidence を比較し、新しい短命 Execution Challenge を作ります。