The agent that grows with you
Python aiai-agentai-agentsanthropicchatgptclaudeclaude-codecodexhermeshermes-agentllmnous-researchopenai
"""Public, content-addressed copies of reviewed binary inputs."""
from __future__ import annotations
import json
import os
from pathlib import Path
import re
from pm.downloader import Source
from pm.index_config import npm_registry_url
_LAYOUT = json.loads(Path(__file__).with_name("artifact-mirror.json").read_text(encoding="utf-8-sig"))
KEY_PREFIX = _LAYOUT["prefix"]
PUBLIC_PREFIX = _LAYOUT["origin"] + "/" + KEY_PREFIX
def object_key(sha256: str) -> str:
if not isinstance(sha256, str) or not re.fullmatch(r"[a-f0-9]{64}", sha256):
raise ValueError("A pinned input requires a full lowercase SHA256")
return KEY_PREFIX + sha256
def mirror_url(sha256: str) -> str:
object_key(sha256)
return PUBLIC_PREFIX + sha256
def pinned_source(url: str, dest: Path, sha256: str) -> Source:
archive = mirror_url(sha256)
# The lock records registry.npmjs.org; a user's npm mirror serves the same pinned bytes (#123132).
url = npm_registry_url(url, os.environ)
return Source(url, dest, sha256, fallbacks=() if url == archive else (archive,))