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が意味するのは、宣言された観測範囲内に候補が現れなかったことだけです。ホスト全体がクリーンであることを示すものではありません。

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

inspect_completed_taskは、明示的に指定されたルートと上限付きの時間枠を受け付けます。結果は常にPARTIAL_EVIDENCEです。Event、receipt、inferred、unattributedの各証拠を使用できますが、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サーバー、薄型のエージェントプラグイン、MCPB、チェックサム、来歴情報、SPDX SBOMが含まれます。クイックスタートとインストールをご覧ください。実行時の操作は完全にローカルで、オフラインで行われます。レポートの既定の保持期間は7日間、合計上限は100 MBです。保持中のレポートとアクティブなベースラインは保護されます。アンインストールによってレポートが黙って削除されることはありません。

現在のリリースは、io.github.fantasyce/agent-residue-evidenceとして公式MCP Registryに公開されています。

ネイティブ環境での受け入れテストは、必須のネイティブCIジョブを通じて、macOS 14以降のarm64、Linux amd64、Windows 11 amd64を対象としています。クロスコンパイルのみを、ネイティブ環境での受け入れテスト済みとして報告することはありません。

エージェント信頼性ツールキット

AREは、小規模なローカル優先の信頼性ツールキットを構成する、独立した要素の1つです。

• Agent Recall Trailは、非公開のエージェントメモリーを、レビュー済みの共有ナレッジから分離します。
• Agent Runtime Proofは、実行中のエージェントまたはMCPランタイムが、承認済みのアーティファクトと一致することを検証します。
• Agent Residue Evidenceは、テストやビルドによって残された、タスクの範囲内にあるファイル、プロセス、リッスン中のポートを記録します。

各プロジェクトは個別にインストールでき、それぞれ独自の信頼境界を維持します。

コミュニティからのフィードバック

実際のエージェントホストでの評価は特に有用です。設計パートナー向け Issueで、ホストと ARE のバージョン、宣言した観測範囲、観測結果を含めた、合成または機密情報を削除したワークフローを共有してください。DSH ユーザーは公式コミュニティディスカッションにも参加できます。認証情報、非公開のパス、生のコマンドライン、環境変数の値、独自のコード、または会話の全文は投稿しないでください。

開発

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

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

Apache-2.0 ライセンスです。セキュリティ、貢献、ネイティブ受け入れテストをご覧ください。