Reproducible 実行環境／Dependency Lock for Agent

Agent runtimeの再現性では、source revisionとdependency lockだけでなく、runtime/container digest、OS/architecture、toolchain、build instructions、再現性に影響するenvironment、model/API/tool/prompt設定のversion/digestを固定します。

lockfileによるclean installを、bit-for-bit reproducible buildやAgentのbehavioral determinismと同一視しません。

「再現可能」の対象を先に固定します。 - dependency resolution - installed filesystem/runtime - build artifact bytes - container/image - deployment configuration - Agent behavioral output これらは別の保証です。強い意味のreproducible buildは、同じsource、build environment、build instructionsから指定artifactがbit-for-bit一致することを要求します。

同じlockfileでもOS、architecture、Python/Node等のruntime、native library、wheel/binary selectionが異なれば同じruntime bytesになるとは限りません。 OS/architecture、runtime/toolchain version、native dependency、GPU/CUDA stackを必要範囲で固定します。 container/base imageはmutable tagではなくdigestを保存します。

build path、timestamp、locale、timezone、toolchain等、artifact bytesへ影響するenvironmentを特定します。 対応toolchainではSOURCE_DATE_EPOCH等の標準的な正規化手段を利用できますが、設定しただけで全toolの再現性を保証しません。 relevant environmentを減らし、manifest化します。

Agentではpackage dependency以外もruntime dependencyとして扱います。 - model ID / snapshot / API revision - tool/MCP server schema and version - prompt/system instruction digest - agent graph/state-machine definition - retrieval/index revision - browser/runtime image - policy/guardrail configuration provider-managed hidden backendなど固定不能な要素はUNKNOWNまたはvolatile dependencyとして明示します。

release候補では少なくともsource revision、lockfile hash、package manager/runtime version、OS/architecture、container/base image digest、build instructions/config、relevant environment normalization、external Agent dependency versions/digests、output artifact hashをreadbackします。 可能な範囲でclean rebuild/reinstallを複数回行い、specified artifact hashとresolved runtime manifestを比較します。

artifact bytesが一致しても、hosted LLM、external API、tool、time-dependent data、nondeterministic samplingによりAgent出力は一致しない場合があります。 artifact reproducibilityとbehavioral reproducibilityを別のacceptance gateにします。

mutable image tag、unpinned transitive dependency、lock/package mismatch、install flag mismatch、native/platform drift、runtime/toolchain drift、build path/timestamp/locale差、postinstall network fetch、external binary差替え、model alias/API/tool drift、prompt/config未manifest化、hidden provider update、cache contamination、shared compromised builderを想定します。

本項は2026-10-06時点のReproducible Builds、npm、uv、SLSA公開資料に基づきます。organization Agent runtime/container registry/build farmへのlive rebuild/mutationは未実施です。

Agent runtimeの再現性では、source revisionとdependency lockだけでなく、runtime/container digest、OS/architecture、toolchain、build instructions、再現性に影響するenvironment、model/API/tool/prompt設定のversion/digestを固定します。lockfileによるclean installをbit-for-bit reproducible buildやAgentのbehavioral determinismと同一視せず、clean rebuild後のartifact hashとresolved runtime manifestをreadbackします。

organization package managers、runtime/container strategy、native/GPU dependencies、browser/tool images、model/API snapshot guarantees、MCP/tool pinning、prompt/config packaging、secrets/config revisioning、offline mirror、independent builder、accepted reproducibility scope、rebuild cadence/cost、tenant realized stateは未確認です。