gantry: Skill for Claude Code

Proxy Request Pipeline — Gantry

Every agent tool call (v1 flat tool or v2 spacemolt(action=...)) flows through the same shared pipeline, implemented once in pipeline.ts / passthrough-handler.ts / injection-registry.ts and called from both server.ts (v1 factory) and gantry-v2.ts (v2 factory). Modify the shared functions, not the per-version factories, unless the behavior genuinely differs between v1 and v2.

Request flow

MCP tools/call (v1 or v2 endpoint)
  1. getAgentForSession()        pipeline.ts — session→agent lookup, restart recovery
  2. tool-name sanitization       gantry-v2.ts — strips XML artifact suffixes from action strings
  3. checkGuardrailsV1/V2()       pipeline.ts — see Guardrails below
  4. combat auto-trigger check    combat-auto-trigger.ts — substitutes flee/scan_and_attack on pirate_combat events
  5a. compound-tool dispatch      tool-registry.ts buildCompoundActions() dispatch table
  5b. OR passthrough              passthrough-handler.ts handlePassthrough()
        -> per-tool structural guards (fuel-floor, cargo-full-dock, refuel-target, pre-dock, ...)
        -> executeForClient()     dispatch-v1-to-v2.ts — routes v1 names to v2 {tool,action} when isV2()
        -> tick wait / event-buffer poll for STATE_CHANGING_TOOLS
        -> error hints            error-hints.ts addErrorHint()
  6. withInjections()             injection-registry.ts — merges all enabled injections
  7. decontaminateLog()           pipeline.ts + proxy-constants.ts CONTAMINATION_WORDS
  8. logToolCallStart/Complete()  tool-call-logger.ts — SQLite + ring buffer + SSE push
Agent receives result

docs/architecture.md's pipeline diagram lists 9 numbered stages in roughly this order — it does call out combat auto-trigger explicitly (its stage 4, "Pre-flight checks"), but it never mentions the structural per-tool guards (fuel-floor, cargo-full-dock, refuel-target, pre-dock) at all, in any stage — use the file list above as the authoritative map when you need to find where a specific behavior lives.