Extensions are labelled platform, integration or agent extensions #2084

Closed
opened 2026-11-21 03:56:07 +00:00 by sam · 1 comment
Owner

Extensions are listed by contract (connector, guard, secret engine, MCP server), which tells an operator how an extension is wired but not what it is for.

Decided (maintainer, 2026-11-21): three groups, derived from the contract in one table in core, with no package manifest change.

  • Platform extensions: run or govern the platform. Guards and secret engines today; identity providers and runners later.
  • Integration extensions: connect outside systems. Connectors: events in, deliveries and actions out.
  • Agent extensions: change what an agent knows or can call. MCP servers today; agent profiles and tools when they become extension contracts.

Workflows and playbooks are package content, not extensions, and get no group.

Done when: the group is a function of the contract in one place in core, the API returns it with each accepted extension and marketplace entry, and the dashboard's extension pages show and group by it using the names above. Adding a contract without a group fails to compile or fails the gate.

Extensions are listed by contract (connector, guard, secret engine, MCP server), which tells an operator how an extension is wired but not what it is for. Decided (maintainer, 2026-11-21): three groups, derived from the contract in one table in core, with no package manifest change. - **Platform extensions**: run or govern the platform. Guards and secret engines today; identity providers and runners later. - **Integration extensions**: connect outside systems. Connectors: events in, deliveries and actions out. - **Agent extensions**: change what an agent knows or can call. MCP servers today; agent profiles and tools when they become extension contracts. Workflows and playbooks are package content, not extensions, and get no group. Done when: the group is a function of the contract in one place in core, the API returns it with each accepted extension and marketplace entry, and the dashboard's extension pages show and group by it using the names above. Adding a contract without a group fails to compile or fails the gate.
sam added the featuremedium labels 2026-11-21 03:56:07 +00:00
Author
Owner

Done in 64ef2c9af, 23f23a6ca and d6f3a1a01.

  • store.Contracts() in modules/connectors/internal/store maps each contract to its group: connector to integration, guard and secret engine to platform, MCP server to agent. Store.Upsert, the only way a package is stored, refuses a contract that isn't in the table, so a stored extension always has a group.
  • The API returns group on each accepted extension. GET /api/extension-kinds lists each kind with its label and group.
  • The dashboard's extensions page builds its tabs from that endpoint, under Platform extensions, Integration extensions and Agent extensions.

Not done: marketplace entries. The marketplace is still the legacy catalogue in internal/webui, keyed by old surfaces rather than contracts. It gets groups when it moves into the one binary. task check passed on the merged tree.

Done in 64ef2c9af, 23f23a6ca and d6f3a1a01. - `store.Contracts()` in `modules/connectors/internal/store` maps each contract to its group: connector to integration, guard and secret engine to platform, MCP server to agent. `Store.Upsert`, the only way a package is stored, refuses a contract that isn't in the table, so a stored extension always has a group. - The API returns `group` on each accepted extension. `GET /api/extension-kinds` lists each kind with its label and group. - The dashboard's extensions page builds its tabs from that endpoint, under Platform extensions, Integration extensions and Agent extensions. Not done: marketplace entries. The marketplace is still the legacy catalogue in `internal/webui`, keyed by old surfaces rather than contracts. It gets groups when it moves into the one binary. `task check` passed on the merged tree.
sam closed this issue 2026-11-21 04:02:18 +00:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: sam/archie#2084