Skip to content

feat: build with pluginpack 0.12, which emits Agent Plugins packages for Codex - #35

Draft
steve-calvert-glean wants to merge 2 commits into
mainfrom
feat/pluginpack-0.12
Draft

steve-calvert-glean wants to merge 2 commits into
mainfrom
feat/pluginpack-0.12

Conversation

@steve-calvert-glean

Copy link
Copy Markdown
Contributor

Problem

@gleanwork/pluginpack 0.12.0 changes the codex target's default output from .codex-plugin/plugin.json + .mcp.json to an Agent Plugins 1.0 package (gleanwork/pluginpack#38). With our current sources, the new version fails in two places:

  • The build fails on "cwd": "." in overrides/codex/glean/mcp/config.json. Agent Plugins accepts only a ./ path or a path under ${PLUGIN_ROOT}/${PLUGIN_DATA}.
  • validate fails on the glean_run skill. Agent Skills names allow only lowercase letters, digits and hyphens, and conforming clients skip the skill.

Change

  • Bump @gleanwork/pluginpack to ^0.12.0.
  • Drop cwd from the Codex MCP override. In Agent Plugins, an omitted cwd means the plugin root, which is what "." meant before, so ./mcp/start.mjs still resolves.
  • Rename glean_run to glean-run in shared/glean/mcp/. This applies to every target, because the skill ships from the MCP server's file list. User-visible: the Claude and Cursor slash name changes from glean_run to glean-run.
  • Update the README's description of the Codex layout.

Output

I built this against a packed pluginpack (main plus gleanwork/pluginpack#41, the 0.12.0 contents) and compared it with main built on 0.11.0:

  • Claude, Cursor: the only difference is the glean_run → glean-run rename.
  • Codex: plugins/<name>/plugin.json (with $schema and extensions["com.openai"].interface) and mcp.json replace .codex-plugin/plugin.json and .mcp.json. The marketplace file stays the same. Codex needs v0.146 or later to read the new layout.
  • npm test (build + validate for all 3 targets) passes, and so does npm run test:bundle (434 tests).

Before merging

  • Publish @gleanwork/pluginpack 0.12.0, then run npm install here to update package-lock.json. CI fails until then, because the lockfile still pins 0.11.x.
  • Decide whether this is breaking. Codex installs older than v0.146 lose the plugin, and the slash name changes. If yes, retitle it to feat!:.

…for Codex

pluginpack 0.12 changes the codex target's default output from
.codex-plugin/plugin.json + .mcp.json to an Agent Plugins 1.0 package:
a root plugin.json with Codex settings under extensions["com.openai"],
and mcp.json. Claude and Cursor output is unchanged apart from the
rename below.

- Drop "cwd": "." from the Codex MCP override. Agent Plugins rejects it,
  and an omitted cwd already means the plugin root, so ./mcp/start.mjs
  still resolves.
- Rename the glean_run skill to glean-run. Agent Skills names allow only
  lowercase letters, digits and hyphens, and conforming clients skip
  glean_run. The rename applies to every target, so the Claude and
  Cursor slash name changes too.
Refresh the lockfile now that @gleanwork/pluginpack 0.12.0 is on npm.
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