Name: gateway
Author: willhama

Imported from willhama/md-file-study (corpus/openclaw__openclaw/files/src/gateway/AGENTS.md). Install upstream with npx skills add willhama/md-file-study --skill gateway. Copyright stays with the author.

Gateway Hot Paths

Gateway server tests and startup paths should not materialize bundled plugin runtime when they only need plugin-owned static descriptors.

Guardrails

For plugin-owned Gateway behavior such as auth-bypass paths, prefer a lightweight public artifact resolver before falling back to the full channel plugin.
Keep the full plugin contract and the lightweight artifact backed by the same plugin-owned helper so behavior does not diverge.
Do not load broad bundled channel registries from Gateway HTTP/server code just to answer static questions.
If adding a new plugin-owned Gateway descriptor, add the core resolver, plugin artifact, and mirrored full-plugin export in the same change.
In Gateway server tests, reuse suite-level servers, authenticated contexts, and clients when the behavior under test does not require a fresh connect/auth handshake. Reset runtime state explicitly instead of restarting the whole server per case.
Keep schedulers, pollers, and background loops disabled in manual-RPC tests unless the test is specifically proving automatic scheduling or lifecycle behavior.

Verification

Benchmark the affected Gateway test file before/after with pnpm test <file>.
Run pnpm build when changing Gateway lazy-loading or bundled plugin artifacts.

# after Install: the listing is in your workspace's routing pool - a plan picks it for its slot curl -s -X POST https://api.opensmartroute.ai/api/v1/route -H 'Authorization: Bearer $OSR_API_KEY' -H 'Content-Type: application/json' -d '{"text": "...", "plan": true}'

Install gateway and it becomes one more candidate the router can pick - when it fits.

A listing is a routing target with a manifest: what it does, which domains it covers, what it costs and who publishes it. Once installed it sits beside your own models and tools, is scored like any other candidate for each request, and shows up in the trace when it wins. Ratings come from workspaces that installed it, one per account.

{ "ocm": "1", "id": "willhama-md-file-study-gateway", "kind": "skill", "name": "gateway", "description": "Gateway server tests and startup paths should not materialize bundled plugin runtime when they only need plugin-owned static descriptors.", "publisher": "willhama", "version": "1.0.0", "capabilities": { "domains": [ "coding" ], "tags": [ "skill-md", "github-agents" ], "languages": [ "en" ] }, "quality_prior": 0.6, "examples": [ "Gateway server tests and startup paths should not materialize bundled plugin runtime when they only need plugin-owned static descriptors." ], "primary": false, "metadata": { "source": { "provider": "github-agents", "repository": "https://github.com/willhama/md-file-study", "path": "corpus/openclaw__openclaw/files/src/gateway/AGENTS.md", "ref": "c19de1e5213e9860055ac2385c28916a272efb46", "url": "https://github.com/willhama/md-file-study/blob/c19de1e5213e9860055ac2385c28916a272efb46/corpus/openclaw__openclaw/files/src/gateway/AGENTS.md", "key": "willhama/md-file-study/corpus/openclaw__openclaw/files/src/gateway/AGENTS.md" } }, "instructions": "# Gateway Hot Paths\n\nGateway server tests and startup paths should not materialize bundled plugin\nruntime when they only need plugin-owned static descriptors.\n\n## Guardrails\n\n- For plugin-owned Gateway behavior such as auth-bypass paths, prefer a\n lightweight public artifact resolver before falling back to the full channel\n plugin.\n- Keep the full plugin contract and the lightweight artifact backed by the same\n plugin-owned helper so behavior does not diverge.\n- Do not load broad bundled channel registries from Gateway HTTP/server code\n just to answer static questions.\n- If adding a new pl", "cost": { "context_tokens": 332 } }

gateway

About

Gateway Hot Paths

Guardrails

Verification

Use it

Install gateway and it becomes one more candidate the router can pick - when it fits.

Manifest

Reviews