main branch first. Every push to main publishes a development
snapshot to the Maven Central snapshot repository. This page shows how to consume those snapshots, and how to
tell exactly which build you got.
Pages on this site mark such content On main, not yet released, with the snapshot version and the main commit.
1. Add the snapshot repository
Snapshots are not on Maven Central’s release repository. Declare the snapshot repository in yourpom.xml:
<repositories>, so every consumer needs this block.
2. Import the development BOM
The AgentWorks BOM on main is1.22.0-SNAPSHOT. It manages the members’ development lines.
-U so Maven checks for a newer snapshot instead of reusing a cached one:
Later builds replace these as main moves.
You can also use a single library’s snapshot without the BOM: declare its
-SNAPSHOT version directly, for example
agent-client-core 0.32.1-SNAPSHOT.
3. Read the exact build you resolved
A-SNAPSHOT version names a moving line, not fixed content. Each published build gets a timestamped version,
recorded in the snapshot repository’s maven-metadata.xml:
-SNAPSHOT replaced by <timestamp>-<buildNumber>: here
1.22.0-20261107.204414-2. The <lastUpdated> element records when the metadata file was last written. It is
not a version.
After a build, the same timestamped file names appear in your local Maven repository (by default .m2/repository in your home directory), for example
io/github/markpollack/agentworks-bom/1.22.0-SNAPSHOT/agentworks-bom-1.22.0-20261107.204414-2.pom.
To pin one build, use its timestamped version in place of -SNAPSHOT. For example,
<version>1.22.0-20261107.204414-2</version> imports exactly that BOM. Pinning the BOM does not pin its members:
the BOM manages -SNAPSHOT lines, so each member still resolves to its latest build. Pin a member’s timestamped
version too if you need it fixed. Snapshot builds are not permanent, so use a release for anything you must
reproduce long-term.
4. Provenance is the main commit
A snapshot has no release tag. What identifies it is themain commit that produced it. Each library publishes from
a workflow that runs on every push to main. That run’s commit is the snapshot’s provenance, and its log names the
exact timestamped file it uploaded.
For the AgentWorks BOM, the Publish development BOM snapshot
run for commit 1a4f0d4 uploaded agentworks-bom-1.22.0-20261107.204414-2.pom. You can check that the published
POM is that commit’s pom.xml: