codex-artifacts

Runtime and process-management helpers for Codex artifact generation.

This crate has two main responsibilities:

• locating, validating, and optionally downloading the pinned artifact runtime
• spawning the artifact build or render command against that runtime

Module layout

• src/client.rs Runs build and render commands once a runtime has been resolved.
• src/runtime/manager.rs Defines the release locator and the package-manager-backed runtime installer.
• src/runtime/installed.rs Loads an extracted runtime from disk and validates its manifest and entrypoints.
• src/runtime/js_runtime.rs Chooses the JavaScript executable to use for artifact execution.
• src/runtime/manifest.rs Manifest types for release metadata and extracted runtimes.
• src/runtime/error.rs Public runtime-loading and installation errors.
• src/tests.rs Crate-level tests that exercise the public API and integration seams.

Public API

• ArtifactRuntimeManager Resolves or installs a runtime package into ~/.codex/packages/artifacts/....
• load_cached_runtime Reads a previously installed runtime from a caller-provided cache root without attempting a download.
• is_js_runtime_available Checks whether artifact execution is possible with either a cached runtime or a host JS runtime.
• ArtifactsClient Executes artifact build or render requests using either a managed or preinstalled runtime.