docs: point OASF badge references at the live schema server - #169
Open
ncdingari wants to merge 1 commit into
Open
docs: point OASF badge references at the live schema server#169ncdingari wants to merge 1 commit into
ncdingari wants to merge 1 commit into
Conversation
The OASF links in the AgentBadge documentation are dead twice over. schema.oasf.agntcy.org does not resolve — it has no DNS record, so every one of these links fails to connect. The OASF schema server is served from schema.oasf.outshift.com, which is the host OASF's own README, CONTRIBUTING guide and server code all use. The objects/agent path is also gone. OASF renamed that object to record; schema/objects/agent.json no longer exists upstream and https://schema.oasf.outshift.com/objects/agent returns 404, while .../objects/record returns 200. Updates the proto comment and regenerates the artifacts derived from it, plus the equivalent comment in internal/core/vc/types and the issuer README. Comments only — no behaviour change. The two schema.oasf.agntcy.org strings in samples/agent/oasf/marketing-campaign/v1.0.0.json are left alone: they are OASF feature name identifiers inside a sample record, not URLs, and changing them would alter sample data rather than fix a link. Signed-off-by: Narahara Chari Dingari <chari@sciencephalon.com>
ncdingari
requested review from
beryder,
copasseron,
hmuyal,
jadiaconu,
mayannuz,
mkedjour and
rafaelsilva29
as code owners
August 27, 2026 13:23
mkedjour
approved these changes
Aug 27, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
docs: point OASF badge references at the live schema server
Problem
The OASF links in the AgentBadge documentation are dead twice over.
The host does not resolve.
schema.oasf.agntcy.orghas no DNS record:OASF's own README, CONTRIBUTING guide and server code (
server/lib/schema/json_schema.ex,@schema_base_uri) all useschema.oasf.outshift.com.The path is also gone. OASF renamed the
agentobject torecord—schema/objects/agent.jsonno longer exists upstream, onlyschema/objects/record.json:So a reader following
# OASF Files - https://schema.oasf.agntcy.org/objects/agentincmd/issuer/README.md— the line directly above theidentity badge issue oasfexample — cannot reach the schema it describes by any route.Someone has already hit this and worked around the symptom rather than the cause:
agntcy/agent-identity-demoscarries the comment "schema.oasf.agntcy.orgmay not resolve from your network" in adocker-compose.yaml.Change
Replaces the host and the object path in the five places the reference appears:
api/spec/proto/agntcy/identity/core/v1alpha1/vc.protoapi/server/agntcy/identity/core/v1alpha1/vc.pb.goapi/spec/static/api/proto/v1alpha1/proto_workspace.jsoninternal/core/vc/types/types.gocmd/issuer/README.mdComments and documentation only — no behaviour change, no API change, no proto field or enum value touched.
Deliberately not changed
samples/agent/oasf/marketing-campaign/v1.0.0.jsoncontains twoschema.oasf.agntcy.org/features/runtime/...strings. Those are OASF feature name identifiers inside a sample record, not URLs. Changing them would alter sample data rather than fix a broken link, so they are left as they are. Happy to take them in a follow-up if maintainers want the samples refreshed to current OASF.Same fix needed elsewhere
The identical dead reference appears in
agntcy/identity-specandagntcy/identity-service. I can open matching PRs there if that is useful — I did not want to file three at once unasked.