Skip to content

[codex] add canonical connector plugin metadata#126

Open
soheil-oai wants to merge 1 commit intomainfrom
codex/add-canonical-connector-metadata
Open

[codex] add canonical connector plugin metadata#126
soheil-oai wants to merge 1 commit intomainfrom
codex/add-canonical-connector-metadata

Conversation

@soheil-oai
Copy link
Copy Markdown
Collaborator

@soheil-oai soheil-oai commented Mar 30, 2026

This adds explicit metadata for canonical connector-backed plugins so downstream consumers can resolve a definitive connector_id -> plugin mapping.

Today, the repo stores connector identity in each plugin's .app.json, but it does not distinguish between a plugin that merely references a connector and the official base plugin for that connector. Because the plugin model allows multiple plugins to reference the same connector, a consumer that starts from connector IDs does not currently have a repo-native way to identify the canonical curated plugin.

This change adds canonical: true alongside the connector ID in the app manifests for the connector-backed curated plugins, and documents that convention in the README. Keeping the metadata in .app.json places the canonical marker next to the connector identity itself and avoids introducing a second source of truth elsewhere in the repo.

The immediate effect is that systems which only have connector IDs can now perform a deterministic lookup of the canonical plugin without relying on naming conventions or ad hoc allowlists. The change is intentionally narrow and does not alter plugin loading behavior, marketplace policy, or connector wiring.

Validation was limited to parsing the edited .app.json files and checking that the repo contains a single canonical entry per marked connector ID.

@soheil-oai soheil-oai marked this pull request as ready for review March 30, 2026 21:16
@soheil-oai soheil-oai requested a review from a team March 30, 2026 21:16
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.

1 participant