docs(fetcher): name real agent package owner psa-systems-private #69

Merged

nrupard merged 1 commit from fix/VS-47-fetcher-owner-examples into main

2026-06-23 21:47:45 +02:00

nrupard commented

2026-06-23 21:43:03 +02:00

Owner

What

The agent binary package is published under the psa-systems-private owner (the live c-01 deployment and the registry URL https://dev.a8n.run/api/packages/psa-systems-private/generic/vervain-agent/stable/vervainagent-6 both use it). Several operator-facing fetcher examples in this repo named the owner psa-systems, so anyone copying them sets VERVAIN_AGENT_FETCHER_OWNER to a namespace with no vervain-agent package: the boot fetch 404s, the binary catalog stays empty, and /vervainagents/:id returns 404 (surfaced in the apps enrollment proxy as "agent download failed: 404 Not Found").

Change

Name the real owner psa-systems-private in the four operator-facing examples: .env.example, README.md, compose.yml, and the config.json doc-comment in crates/vervain-agent-fetch/src/config.rs.

Left unchanged on purpose: the #[cfg(test)] parse fixture in config.rs and the unit-test owners in crates/vervain-agent-fetch/src/source.rs and crates/vervain/src/agent_fetcher_seed.rs (placeholder hosts, assert parsing not deployment), and the container image: owner refs (README.md, compose.yml), which are a separate image-pull concern.

Closes #VS-47.

## What The agent binary package is published under the `psa-systems-private` owner (the live c-01 deployment and the registry URL `https://dev.a8n.run/api/packages/psa-systems-private/generic/vervain-agent/stable/vervainagent-6` both use it). Several operator-facing fetcher examples in this repo named the owner `psa-systems`, so anyone copying them sets `VERVAIN_AGENT_FETCHER_OWNER` to a namespace with no `vervain-agent` package: the boot fetch 404s, the binary catalog stays empty, and `/vervainagents/:id` returns 404 (surfaced in the apps enrollment proxy as "agent download failed: 404 Not Found"). ## Change Name the real owner `psa-systems-private` in the four operator-facing examples: `.env.example`, `README.md`, `compose.yml`, and the `config.json` doc-comment in `crates/vervain-agent-fetch/src/config.rs`. Left unchanged on purpose: the `#[cfg(test)]` parse fixture in `config.rs` and the unit-test owners in `crates/vervain-agent-fetch/src/source.rs` and `crates/vervain/src/agent_fetcher_seed.rs` (placeholder hosts, assert parsing not deployment), and the container `image:` owner refs (`README.md`, `compose.yml`), which are a separate image-pull concern. Closes #VS-47.

nrupard added 1 commit

2026-06-23 21:43:03 +02:00

docs(fetcher): name real agent package owner psa-systems-private

Check / fmt + clippy + build + tests (pull_request) Successful in 3m36s

Details

Create release / Create release from merged PR (pull_request) Has been skipped

Details

1ed794ddcb

The agent binary package lives under the `psa-systems-private` owner (the live c-01 deployment and the publish URL `https://dev.a8n.run/api/packages/psa-systems-private/generic/vervain-agent/stable/vervainagent-6` both use it). The operator-facing fetcher examples named the owner `psa-systems`, so anyone copying them sets `VERVAIN_AGENT_FETCHER_OWNER` to a namespace with no `vervain-agent` package: the boot fetch 404s, the catalog stays empty, and `/vervainagents/:id` returns 404. Correct the four operator-facing examples (`.env.example`, `README.md`, `compose.yml`, and the `config.json` doc-comment in `crates/vervain-agent-fetch/src/config.rs`). Test fixtures (`config.rs` parse test, `source.rs`, `agent_fetcher_seed.rs`) use placeholder hosts and assert parsing, so they stay as-is; the container `image:` owner refs are a separate image-pull concern and are untouched.

#VS-47