Repository navigation
Ship the Paper plugin in the Codex layout - #25
Open
StephenHaney wants to merge 1 commit into
Open
StephenHaney wants to merge 1 commit into
StephenHaney wants to merge 1 commit into
Conversation
Every plugin in OpenAI's curated catalog uses .codex-plugin/plugin.json + .mcp.json, and Codex applies no tool budget to servers declared that way. The portable Agent Plugins layout is budgeted (8 KB/tool, 64 KB shared) and hides tools alphabetically past the limit, which for Paper drops write_html and the other write tools (openai/codex#44308). The validator now reads both layouts and only applies submission rules to plugins with a review block; the pack script stages the Codex files. Co-authored-by: Cursor <cursoragent@cursor.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Switches
plugins/paperfrom the portable Agent Plugins layout (plugin.json+mcp.json) to the Codex layout (.codex-plugin/plugin.jsonwith rootinterface,.mcp.jsonwithtype: "http"+oauth_resource, matching Linear/Notion inopenai/plugins).Why: Codex budgets MCP tools from portable-layout plugins at 8 KB per tool / 64 KB shared across all installed plugins, hiding anything past the limit alphabetically (
core/src/mcp_tool_exposure.rs, openai/codex#44308). For Paper that drops everything afterlist_resources, includingwrite_html,update_styles,set_text_content. The Codex layout is exempt from that budget, is accepted by the submission portal, and is what all 65 plugins in OpenAI's own catalog use. A third party confirmed the before/after this week (craftsamo/agent-tool-starter#12).Scope note: the published directory plugin is delivered through the registered-app path regardless of layout (verified: a ChatGPT-created plugin for our server exposes all 41 tools). This change covers every other way the server is reached: API-key Codex users, local marketplace installs, and the dual-delivery edge where Codex keeps the bundled server alongside the app.
scripts/validate-agent-plugins.mjs: reads either layout, runs submission checks only for plugins with a review block (sopaper-desktopis unaffected), strict schema validation stays for portable packages.scripts/pack-chatgpt.ts: stages.codex-plugin/plugin.json,.mcp.json, icons.plugins/paper/README.md: documents the layout choice.bun run buildpasses; ZIP is 3 files.Made with Cursor
Note
Low Risk
Packaging and validation changes for the Paper plugin listing; no runtime auth or server logic changes.
Reviewed by Cursor Bugbot for commit 2260a99. Bugbot is set up for automated code reviews on this repo. Configure here.