v0.5.0 — Agent Plugins 1.0.0 as the single source of truth

Agent Plugins 1.0.0 becomes the single source of truth

v0.5.0 adopts the open Agent Plugins 1.0.0 spec (Vercel-led; co-maintained with AWS, Cursor, GitHub, Microsoft and OpenAI) as the bundle for every host that speaks it. One package run, or one install --method marketplace, now produces the package that Codex, GitHub Copilot CLI, VS Code / JetBrains Copilot, Kiro and Hermes all install — instead of a per-host copy of the Claude plugin tree.

npx @ken-jo/agent-connector package --connector ./agent-connector.config.mjs
#  → dist-plugin/<id>/plugin.json · mcp.json · skills/ · bin/agent-connector.mjs
#    · com.github.copilot/ · com.openai/  (+ local marketplace catalogs)

# or let the drivers do it (hosts are auto-detected):
acme-db install --method marketplace            # codex + copilot-cli staged from the SAME bundle

Highlights

• package --format agent-plugin is the new default. Root plugin.json (const $schema, slug name, extensions), mcp.json with the closed stdio | streamable-http | sse variants (the only bundle that also carries remote servers), skills/<n>/SKILL.md, README. Non-conformant cwd/env values are dropped with notes, never emitted invalid.
• Portable launcher, no absolute paths. The spec forbids absolute command paths, so the bundle ships bin/agent-connector.mjs and the MCP entry runs node ${PLUGIN_ROOT}/bin/agent-connector.mjs serve …. The launcher resolves the runtime at run time — $AGENT_CONNECTOR_HOME_BIN → the stable home binary → agent-connector on PATH → npx @ken-jo/agent-connector@^0.5.0 — so no global install is required for per-tool telemetry to carry through.
• Client extension namespaces, data-driven. Hooks, commands and subagents are client-specific in v1 of the spec, so the one bundle carries them per namespace: com.github.copilot/ (hooks via the ${PLUGIN_ROOT} launcher, agents/<n>.agent.md, commands/<n>.md; read by Copilot CLI, VS Code, JetBrains) and com.openai/ (hooks, wired through plugin.json extensions["com.openai"].hooks, which Codex parses as its manifest overlay). Clients ignore namespaces they do not own; add a row to CLIENT_NAMESPACES when another client documents one.
• Unified marketplace routing. The codex and copilot-cli drivers stage this bundle; MARKETPLACE_FORMAT_BY_PLATFORM routes codex, copilot-cli, vscode-copilot, jetbrains-copilot, kiro, hermes → agent-plugin. A hostHint stamps --host on the MCP entry for telemetry attribution. Cursor keeps cursor-plugin and OpenClaw claude-plugin, because their own docs say the client-specific format is the one that carries hooks and commands.
• Local catalogs from package output. <out>/.claude-plugin/marketplace.json and <out>/.agents/plugins/marketplace.json are written next to the plugin dir, so copilot plugin marketplace add <out> && copilot plugin install <id>@agent-connector and codex plugin marketplace add <out> && codex plugin add <id>@agent-connector work as-is.

Breaking changes

• The default package format changed from claude-plugin to agent-plugin. Pass --format claude-plugin explicitly for a Claude Code bundle.
• codex-plugin and copilot-plugin are retired. The names still parse everywhere a format is accepted and resolve to agent-plugin with a deprecation line (LEGACY_FORMAT_ALIASES, resolvePackageFormat()), so existing scripts keep working; --format all now emits 9 host formats.

Verified live (macOS, isolated homes)

Host	Result
codex-cli 0.149.0	plugin marketplace add → plugin add → plugin list shows installed, enabled
GitHub Copilot CLI 1.0.80	plugin marketplace add → plugin install → plugin list shows v0.5.0 bundle, tree intact
Hermes	plugins doctor OK
agent-connector CLI	install --method marketplace --targets codex,copilot-cli → both host plugin lists → doctor pass → uninstall with zero residue

Docs

README, llms-full.txt, docs/ARCHITECTURE.md, the site packaging guide and format table, the research notes on codex marketplace mechanics, and docs/host-verification-results.csv describe the new default and the unified routing.

Full changelog: see CHANGELOG.md — 0.5.0.