Skip to content

Add direct catalog entry lookup by identifier - #74

Open
hstaudacher wants to merge 2 commits into
ards-project:mainfrom
hstaudacher:hstaudacher-add-entry-lookup-endpoint
Open

Add direct catalog entry lookup by identifier#74
hstaudacher wants to merge 2 commits into
ards-project:mainfrom
hstaudacher:hstaudacher-add-entry-lookup-endpoint

Conversation

@hstaudacher

@hstaudacher hstaudacher commented Aug 7, 2026

Copy link
Copy Markdown
Collaborator

ARD identifiers are stable logical identities, but registries currently require clients to repeat semantic discovery or use the optional listing API to resolve a known identifier. This adds a deterministic retrieval operation for clients that already hold an ARD URN.

Summary

  • Define mandatory GET /agents/{identifier} lookup with exact, case-sensitive, registry-local semantics.
  • Specify percent-encoding, canonical CatalogEntry responses, authentication, caching, and standard 400/404 errors.
  • Add typed OpenAPI and CDDL definitions plus an ADR documenting the federation boundary.
  • Extend the conformance CLI and mock registry to cover encoded success, malformed identifiers, unknown identifiers, and conditional caching.

The lookup intentionally does not federate or return search-only fields such as score and source; clients resolve federated results against the originating registry reported by Search.

Validation

  • ./conformance/bin/run-conformance-demo
  • OpenAPI YAML, JSON Schema, Python, and shell syntax checks
  • HTTP checks for percent-encoding, double-encoding rejection, ETag, and 304 Not Modified

…mentation

- Introduced ADR-0010 for direct catalog entry lookup by identifier.
- Enhanced conformance testing to validate exact lookup functionality.
- Updated README and demo scripts to include new lookup identifier option.
- Modified registry server to handle GET /agents/{identifier} requests.
- Revised ARD specification and OpenAPI definitions to reflect new endpoint.

@thomas-sickert thomas-sickert left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Love the addition! Just had one philosophical question on federation.

Comment thread adr/0010-direct-catalog-entry-lookup.md
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants