Agent Residue Evidence

Agent Residue Evidence (ARE) は、エージェントのテストおよびビルドワークフローにエビデンスチェックポイントを追加します:

observe → Agent reviews evidence → user authorizes cleanup
        → Agent cleans with its own tools → ARE verifies

ARE は、タスクスコープのファイル、ディレクトリ、属性付けされたプロセス、およびそれらのリッスン中のポートを表示します。ファイルを削除したり、プロセスを停止したり、ポートを閉じたり、何かが削除しても安全だと判断したり、マシン全体をスキャンしたり、データをアップロードしたり、ネットワークを使用したり、テレメトリを収集したりすることは決してありません。

プロジェクトサイト にアクセスし、再現可能なタスク残骸デモ を実行するか、最新の検証済みリリース をダウンロードしてください。

標準タスク

最初のテストまたはビルドの前に、エージェントは正確なワークスペースとタスク所有の一時ルートを指定して begin_task_observation を呼び出します。イベントはオプションです。安全な汎用イベントまたは空のハートビートは、append_task_events で送信できます。最終回答の前に、エージェントは end_task_observation を呼び出し、候補を説明して、ユーザーにどうするかを尋ねます。明示的な承認を得た後にのみ、エージェントは通常のツールでクリーンアップします。その後、verify_task_residue を呼び出して、同じ安定した候補を再確認します。

NO_CANDIDATES_OBSERVED は、宣言された観測スコープ内に候補が現れなかったことのみを意味します。ホスト全体のクリーン性を主張するものではありません。

Related MCP server: flameox

ベースラインなしの完了タスク

inspect_completed_task は、明示的なルートと制限付きの時間枠を受け入れます。結果は常に PARTIAL_EVIDENCE です。Event、レシート、推論された、または属性なしのエビデンスを使用できますが、BASELINE_OBSERVED を主張することはありません。保存されたレポートを再度観測せずに読み取るには、get_residue_report を使用します。

すべての観測は、不透明なオーナーケイパビリティによって分離されています。タスク ID、レポート ID、観測 ID、候補 ID は表示用の参照にすぎず、アクセスを許可することはありません。状態は不透明なファイル名で保存時に暗号化されます。正確なパスは、承認された候補解決呼び出しを通じてのみ明らかにされます。短命なエグゼキューターケイパビリティは、明示的に許可されたイベントタイプとルートエイリアスのみを追加でき、タスクの読み取り、終了、検証、または解決はできません。

MCP サーフェスには、正確に 8 つのツールが含まれています:

• begin_task_observation

• append_task_events

• end_task_observation

• inspect_completed_task

• get_residue_report

• verify_task_residue

• delegate_task_executor

• resolve_residue_candidate

クリーンアップ、削除、実行、終了、またはクローズのツールは、意図的に存在しません。

ローカルファーストのパッケージング

1 つのリリースには、ネイティブ CLI/stdio MCP サーバー、軽量な Agent Plugin、MCPB、チェックサム、来歴、SPDX SBOM が含まれています。Quickstart と Install を参照してください。ランタイム操作は完全にローカルかつオフラインです。レポートはデフォルトで 7 日間保持され、合計 100 MB の上限が設定されます。保持されたレポートとアクティブなベースラインは保護されます。アンインストールでレポートが黙って削除されることは決してありません。

MCP レジストリの名前空間は io.github.fantasyce/agent-residue-evidence です。

ネイティブ受入は、必須のネイティブ CI ジョブを通じて、macOS 14+ arm64、Linux amd64、Windows 11 amd64 をカバーしています。クロスコンパイルのみでは、ネイティブ受入として報告されません。

開発

Go 1.26 または 1.27 が必要です。

bash scripts/check.sh
bash scripts/run_native_acceptance.sh

Apache-2.0 ライセンスです。Security、Contributing、ネイティブ受入 を参照してください。