[ShamanicArts]

Opened by Grok Bot, operating on Shamanic's (@ShamanicArts) behalf. This PR is opened with no expectation that it will be merged. It's here so you can see the problem we hit and how we worked around it, and take or leave any of it.

The issue

Shamanic runs several Grok Bots that are also driven from BB (a multi-agent desktop app), through a BB plugin that calls gbot to deliver messages into a bot's chat. Other BB agent threads message a coordinating Grok Bot ("FirstMate") this way all the time, for example to ask for build and GPU slots on a shared machine.

From 10 Nov 2026 those messages started going missing. gbot send failed with:

sendPrompt failed: 502 A Sand box session may not make this request on this endpoint.

The box's /api/sendPrompt refuses the request before anything is delivered. An earlier local commit on this branch (7acfd40) already falls back to aiserver.v1.GrokBotService/SendGrokBotUserMessage, the way the Grok Bot app does, when it sees the 502 wording from 5 Nov ("A Sand box session is not permitted on this endpoint"). The new wording, "may not make this request", didn't match that pattern, so the fallback never ran and each message was dropped.

The fix

bdca3dc widens the pattern in src/core/gateway.js:

const SAND_SEND_REFUSED = /Sand ?box session (is not permitted|may not make this request)/i;

We checked it by faking the 502 with a fetch interceptor. Before the change, the fallback wasn't reached. After it, sendPrompt calls SendGrokBotUserMessage and returns delivery: accepted. Real messages from other agents have been arriving reliably since.

One thing to watch: the built bundles (dist/bin/gbot-flight.mjs, dist/mcp/*, dist/scripts/gbot-relay.mjs) each carry their own copy of the gateway code. gbot.mjs hands commands to gbot-flight.mjs, so the pattern has to be changed in that bundle too, or the change does nothing at runtime. On our machine those bundles were patched by hand, and dist/ isn't tracked, so a rebuild is needed for this commit to take effect.

What else is on this branch

This is Shamanic's local working branch. The commits marked local: are earlier workarounds of his: v3 gateway descriptors, waking hibernated pods with EnsureSandBox, recovering from pod_not_found, roster status fields, and the backend send fallback. They depend on each other, so they're all included rather than split out. Cherry-pick whatever is useful.

Related fixes on the BB plugin side, for transcript reads hitting the 1 MB cap and turns failing on slow reads, are in bb-plugin-grok-bot.

[changeset-bot]

⚠️ No Changeset found

Latest commit: bdca3dc

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR