Skip to content

The gateway's -41002 example was stale, and understated what the client does - #42

Merged
arpanghoshal merged 1 commit into
mainfrom
fix/gateway-approval-message
Sep 15, 2026
Merged

arpanghoshal merged 1 commit into
mainfrom
fix/gateway-approval-message

Conversation

@arpanghoshal

Copy link
Copy Markdown
Member

Pairs with ctrlrun#211.

The documented error read "mcp.ops.delete_namespace: a human must approve". What the gateway actually emitted was the decorator's wording, telling an MCP client to retry inside ctrlrun.with_approval(...), a Python context manager it has no access to. The kernel PR fixes the message; this fixes the example, and adds the data fields the gateway really sends (action_hash, expires_at).

The prose already said the right thing, that the agent's next identical call runs. It now says explicitly that there is nothing for the client to do differently on the retry, and that the decorator's second step does not apply here. That missing sentence is what let the wrong error text look plausible.

Found by running a real MCP server with the gateway in front of it, not by reading.

all checks passed             (ruff, ruff format, 1727 passed)
links 0 broken · lint 0 findings · snippets 98 blocks 0 failed

🤖 Generated with Claude Code

…t does

The documented error said `mcp.ops.delete_namespace: a human must approve`.
The gateway actually emitted the decorator's wording, telling an MCP client to
retry inside `ctrlrun.with_approval(...)`, a Python context manager it has no
access to. The kernel PR fixes the message; this fixes the example, and adds
the `data` fields the gateway really sends.

The prose already said the right thing, that the agent's next identical call
runs. It now says explicitly that there is nothing for the client to do
differently, because that is the sentence whose absence let the wrong error text
look plausible for four milestones.

Signed-off-by: arpan <contact@arpanghoshal.com>
@mintlify

mintlify Bot commented Sep 14, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
ctrlrun 🟢 Ready View Preview Sep 14, 2026, 11:59 PM

💡 Tip: Enable Automations to automatically generate PRs for you.

@coderabbitai

coderabbitai Bot commented Sep 14, 2026

Copy link
Copy Markdown

Warning

Review limit reached

Next included review available in 12 minutes.

Check out review usage here.

View limit details

Limit details: You’ve used the included review currently available.

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

Learn how review limits work.

Review configuration:

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Advanced

Run ID: ced94f38-1119-47e3-ac16-8b7d10e46122

📥 Commits

Reviewing files that changed from the base of the PR and between f832162 and 305c764.

📒 Files selected for processing (1)
  • docs/mcp/gateway-in-5-minutes.mdx

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@arpanghoshal
arpanghoshal merged commit ac771d7 into main Sep 15, 2026
3 checks passed
@arpanghoshal
arpanghoshal deleted the fix/gateway-approval-message branch September 15, 2026 19:15
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