Spec: Update mediaType to type for catalogEntry and add known types by mindpower · Pull Request #37 · Agent-Card/ai-catalog

mindpower · 2026-05-15T23:02:53Z

Update AI-catalog spec based on meeting agreement on date: 04/30/2026, 05/14/2026

Move from `mediaType` to `type` in `CatalogEntry`

Decision: Renamed the mediaType field to type in catalog entries to avoid confusion with generic IANA media types.
Open Format with Known Types: Clarified that the type field is an open text format accepting any string value. However, a set of recognized "known types" is recommended for interoperability (e.g., application/a2a-agent-card+json, application/mcp-server+json, application/ai-catalog+json, application/agent-registry, and format-specific skills like +gzip, +zip, +json). Clients are responsible for handling new or unknown types.
ADR Created/Updated: Added and updated ADR 0014 to document this decision.

github-actions · 2026-05-15T23:03:17Z

Preview unavailable.

The pull request preview was removed because this pull request is closed.

…est (which is different from the type for catalog entry) and fix the type to application/mcp-server+json in examples

…d syntax standards

… and specification

jdamick · 2026-05-21T18:56:53Z

The attestation object already has a "type" and "mediaType" and now type in the entry is actually a media type. It seems confusing and inconsistent to me when i read this again.

Simplifies the attestation metadata schema by removing the `mediaType` field from the `Attestation` object, following the May 28, 2026 workgroup decision. - Removes `mediaType` from the Attestation schema definition in `ai-catalog.md`. - Updates all trustManifest examples across the specification. - Updates ADR 0014 to document the context, decision, and rationale for this removal.

jdamick · 2026-06-04T14:23:06Z

lgtm

Co-authored-by: Jonathan Hefner <jonathan@hefner.pro>

Co-authored-by: Tadas Antanavicius <tadas@tadasant.com>

Co-authored-by: Jonathan Hefner <jonathan@hefner.pro>

…n/mcp-server-card+json, and standardize Markdown profile URNs

…d correct mcp-server-card nomenclature in ADR 0014

Wolfe-Jam · 2026-06-20T13:47:31Z

hey guys, love the cards. not wishing to put yet another decision burden on your track — but I author a fair few Agent Skills (~40) and I'd love to see tags carry discovery. one word and you have everything, no matter how deep the catalog becomes — skills, context, security, images, whatever — a single tag finds them all, and it doesn't care how the entry's encoded.

I just tried the format out for myself (published a catalog with five entries) and that's where it landed for me. thanks again for the work on this.

— Assisted by Claude (Opus 4.8) · Approved by James Wolfe (@Wolfe-Jam)

…skills+md in catalog and ADR, also added agent-skills+json for skills metadata json file

…sion history

mindpower added 6 commits May 15, 2026 16:00

Apply mediaType to type changes and add ADR 001

a8366f3

Apply mediaType to type changes to ai-catalog.md and rename ADR

e565ac3

fix: update typo and also entry type string for agents

0076165

Update type field to open format in specifications

05ae8dc

fix: known catalog types for ADR 0014

48ee15f

spec: refine catalog artifact type definitions based on 05/14 meeting

ba8d11f

mindpower changed the title ~~Spec: Update mediaType to type based on last two meetings (adr/0014)~~ Spec: Update mediaType to type based on last meetings (adr/0014) May 15, 2026

github-actions Bot added a commit that referenced this pull request May 15, 2026

Publish specification preview for PR #37

4b9d63b

Fix: change type field to mediaType for attestations under TrustManif…

5617096

…est (which is different from the type for catalog entry) and fix the type to application/mcp-server+json in examples

github-actions Bot added a commit that referenced this pull request May 15, 2026

Publish specification preview for PR #37

425ec2f

mindpower changed the title ~~Spec: Update mediaType to type based on last meetings (adr/0014)~~ Spec: Update mediaType to type for catalogEntry and add known types May 15, 2026

mindpower mentioned this pull request May 15, 2026

spec: adopt urn:air: naming standard for AI artifacts (ADR 0015) #36

Merged

mindpower requested review from Tehsmash, darrelmiller and muscariello May 15, 2026 23:38

darrelmiller reviewed May 20, 2026

View reviewed changes

Comment thread adr/0014-media-type-to-type.md Outdated

darrelmiller reviewed May 20, 2026

View reviewed changes

Comment thread adr/0014-media-type-to-type.md Outdated

Tehsmash reviewed May 20, 2026

View reviewed changes

Comment thread specification/ai-catalog.md Outdated

mindpower added 2 commits May 20, 2026 14:14

refactor: update recommended media types to align with IANA structure…

21bab9e

…d syntax standards

docs: categorize and refine known artifact types by governance in ADR…

758088e

… and specification

github-actions Bot added a commit that referenced this pull request May 20, 2026

Publish specification preview for PR #37

ddaaddc

github-actions Bot added a commit that referenced this pull request May 30, 2026

Publish specification preview for PR #37

b060dc4

darrelmiller reviewed Jun 6, 2026

View reviewed changes

Comment thread specification/ai-catalog.md Outdated

muscariello requested review from a team and removed request for muscariello June 10, 2026 18:03

muscariello added this to AI Catalog Jun 11, 2026

tadasant mentioned this pull request Jun 18, 2026

docs(discovery): rename Catalog Entry mediaType field to type (ADR 0014) modelcontextprotocol/experimental-ext-server-card#32

Open

7 tasks

Update adr/0014-media-type-to-type.md

d3c5837

Co-authored-by: Jonathan Hefner <jonathan@hefner.pro>

github-actions Bot added a commit that referenced this pull request Jun 19, 2026

Publish specification preview for PR #37

877d520

Update adr/0014-media-type-to-type.md

edd336e

Co-authored-by: Tadas Antanavicius <tadas@tadasant.com>

github-actions Bot added a commit that referenced this pull request Jun 19, 2026

Publish specification preview for PR #37

57d6eda

Update specification/ai-catalog.md

20d7b8b

Co-authored-by: Jonathan Hefner <jonathan@hefner.pro>

github-actions Bot added a commit that referenced this pull request Jun 19, 2026

Publish specification preview for PR #37

ea108fe

mindpower and others added 2 commits June 19, 2026 15:53

Update adr/0014-media-type-to-type.md

8c25b5b

Co-authored-by: Jonathan Hefner <jonathan@hefner.pro>

Update specification/ai-catalog.md

b803fa2

Co-authored-by: Jonathan Hefner <jonathan@hefner.pro>

github-actions Bot added a commit that referenced this pull request Jun 19, 2026

Publish specification preview for PR #37

6f40c8f

mindpower and others added 2 commits June 19, 2026 15:53

Update adr/0014-media-type-to-type.md

ef91306

Co-authored-by: Jonathan Hefner <jonathan@hefner.pro>

Update specification/ai-catalog.md

e97ea9c

Co-authored-by: Jonathan Hefner <jonathan@hefner.pro>

github-actions Bot added a commit that referenced this pull request Jun 19, 2026

Publish specification preview for PR #37

b294444

chore: update media types to application/agent-skills+zip, applicatio…

321aa89

…n/mcp-server-card+json, and standardize Markdown profile URNs

github-actions Bot added a commit that referenced this pull request Jun 19, 2026

Publish specification preview for PR #37

ac1b9c9

docs: update agent skill media type profile to urn:air:agent-skill an…

79c67f5

…d correct mcp-server-card nomenclature in ADR 0014

github-actions Bot added a commit that referenced this pull request Jun 19, 2026

Publish specification preview for PR #37

cb5a55b

docs: replace profile-based markdown media types with explicit agent-…

0558979

…skills+md in catalog and ADR, also added agent-skills+json for skills metadata json file

github-actions Bot added a commit that referenced this pull request Jun 22, 2026

Publish specification preview for PR #37

2651001

tadasant approved these changes Jun 24, 2026

View reviewed changes

jonathanhefner approved these changes Jun 25, 2026

View reviewed changes

darrelmiller approved these changes Jun 25, 2026

View reviewed changes

dsp-ant self-requested a review June 25, 2026 15:28

dsp-ant approved these changes Jun 25, 2026

View reviewed changes

docs: clarify +md suffix registration requirement and update ADR revi…

c3148fe

…sion history

github-actions Bot added a commit that referenced this pull request Jun 25, 2026

Publish specification preview for PR #37

1bc7797

mindpower merged commit 5faaa27 into main Jun 25, 2026
4 checks passed

github-project-automation Bot moved this from In Progress to Done in AI Catalog Jun 25, 2026

github-actions Bot added a commit that referenced this pull request Jun 25, 2026

Remove specification preview for PR #37

f8668d1

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Spec: Update mediaType to type for catalogEntry and add known types#37

Spec: Update mediaType to type for catalogEntry and add known types#37
mindpower merged 21 commits into
mainfrom
jbu/adr-0014-mediatype-to-type

mindpower commented May 15, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented May 15, 2026 •

edited

Loading

Uh oh!

Uh oh!

Uh oh!

Uh oh!

jdamick commented May 21, 2026

Uh oh!

jdamick commented Jun 4, 2026

Uh oh!

Uh oh!

Wolfe-Jam commented Jun 20, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

9 participants

Uh oh!

Conversation

mindpower commented May 15, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Update AI-catalog spec based on meeting agreement on date: 04/30/2026, 05/14/2026

Move from mediaType to type in CatalogEntry

Uh oh!

github-actions Bot commented May 15, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

jdamick commented May 21, 2026

Uh oh!

jdamick commented Jun 4, 2026

Uh oh!

Uh oh!

Wolfe-Jam commented Jun 20, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

9 participants

mindpower commented May 15, 2026 •

edited

Loading

Move from `mediaType` to `type` in `CatalogEntry`

github-actions Bot commented May 15, 2026 •

edited

Loading