コンテンツにスキップ

モジュール I — インベントリと発見

モジュール I はエステートのカタログである。存在するあらゆるもの(エージェント、 セッション、Claude Code インスタンス、MCP サーバー、スキル、ツール、リソース、モデル、 プロバイダー、非人間 ID)の、受動的でバス駆動のインベントリである。プローブによってではなく リッスンすることで発見し、ペイロードは決して記録せず、関係性、識別子、生存性のみを 記録する。本ページは、カタログが保持するもの、そして意図的に保持しないものについての リファレンスである。

コネクターはエンティティではなく観測を発行する。コネクターは正規化された edge.observedcost.sampled のファクトを イベントバスへ publish するが、それらが含意するエンティティそのものが送信されることは 決してない。モジュール I は、各観測が指し示すコアエンティティを、その自然な参照から 具現化する。すなわち、起点となる session/agent/identity、MCP サーバー、ツール、 リソース、スキル、そしてコストサンプルからプロバイダーとモデル(価格情報なしで発見される。 価格情報は FinOps が所有する)である。具現化は at-least-once 配信下で冪等である。 自然キーに対する find-or-create を行うため、同じ観測を 2 回見ても決してエンティティが 重複することはない。

本モジュールは自身のエンティティを 1 つ登録する。inventory.catalog_entry は、 具現化された各コアエンティティに付随する発見オーバーレイである。それが記録するのは どのように見つかったかであり、何をしたかではない。すなわち、シグナルソースの一覧、 それが観測されたホスト、初回観測・最終観測のタイムスタンプ、発生回数、そして active または stale という生存性 status である。定期的な陳腐化スイープは、設定されたウィンドウ内で 観測されなかったエントリを stale とマークし、再出現した瞬間に active へ戻す。スイープは モジュールが実際に観測したテナントに対してのみ実行される(テナントを列挙することはできず、 また列挙しない)。読み取りサーフェスは小さく読み取り専用である。すなわち、種別とソース別の 件数を示す summary、種別とステータスでフィルタ可能なページネーション付きの entities 一覧、 そして単一エンティティの詳細ビューである。すべての読み取りはテナントスコープの名前空間付き 読み取りパーミッションを必要とする(最下位の閲覧者ティアで十分)。取り込みは高頻度であり、 書き込みごとに監査されることはない。完全な形状は イベントバスリファレンス および本製品の型付きインターフェイスに存在する。

モジュール I は純粋なコンシューマーである。edge.observedcost.sampledfinding.reported をサブスクライブし、自身のカタログオーバーレイと、そこから導出する コアエンティティのみを書き込む。自身のイベントは一切発行せず、アクチュエーション サーフェスも公開しない。発見は本質的に observe-and-catalog である。本モジュールが 永続化する参照は、コネクターから既にレダクトされた状態で到着する。モジュールは それらをそのまま保存し、自身の生の詳細を一切付加しない。したがって minimal-data 特性は ワイヤーの特性であり、エンドツーエンドで保たれる。