io.github.thuupx/lunge

Return the Lunge collection format reference: top-level fields, step schema, request specs per protocol (http/graphql/ws/sse), full assertion vocabulary (status/header/jsonpath/timeMs/schema/not + matchers), WS/SSE-specific assertions, variable chaining (extract + {{var}}), and JSONPath syntax. Call this BEFORE writing explicit steps for save_collection or reviewing saved output.

Introspect GraphQL endpoint, return summarized schema with field signatures (args + return types) and input types.

GraphQL query/mutation over HTTP. Supports {{var}} extraction. Note: `ok` reflects HTTP status only (200 = ok). GraphQL-level errors are returned in `graphqlErrors` — always check both. Use extract with $.data.* for success data and $.errors.* for error details.

REST/HTTP request with auth, assertions, {{var}} extraction. Returns token-efficient summary.

Parse curl into structured request. Optionally execute it.

Parse HAR file → Lunge collection. Splits query/headers/body. Optional 2xx filter. Params: path (required, .json HAR file), out (optional, write to .json/.yaml/.yml), only2xx (optional, only keep 2xx responses), maxSteps (optional, cap step count, default 200). Returns {ok, imported, name, steps, writtenTo}.

Parse OpenAPI/Swagger (JSON/YAML) → Lunge collection. One step per operation with 2xx assertion. Params: path (required, file path), out (optional, write collection to .json/.yaml/.yml), includeTags (optional, only ops with these tags), maxSteps (optional, cap step count, default 200). Returns {ok, imported, name, steps, writtenTo}.

Drill into a stored response by handle without re-running the request. Use jsonpath to pull only the slice you need. Supports RFC 9535 filters ($.items[[email protected]==1]) and slices ($.items[0:5]). Use double quotes in filters. Omit jsonpath to return the full stored body — for graphql_introspect this is the enriched `schema` (so $.queries, $.mutations, $.inputTypes work directly); for ws_session it's the `frames` array; for sse_session it's the `events` array; otherwise it's the parsed bodyJson/bodyText.

Find collection files (.yaml/.yml/.json) under a directory.

List env names and (masked) variables of the active or specified one.

List all requests recorded in this session with full specs (method, url, query, headers, body, auth, assert, extract) and extracted values. Use this to review what happened before saving a multi-step collection. Each entry has an id (req_1, req_2, ...) for use with save_collection. Returns {count, entries:[{id, type, request, assert, extract, extractedValues, responseHandle}]}.

Run declarative collection file. Threads extracted vars between steps. Optional JUnit XML export.

Save multiple requests as a multi-step collection file. Params: path (required, .json/.yaml/.yml), fromHistory (optional, array of history ids from list_history — saves in specified order; omit to save ALL history), steps (optional, explicit step specs — overrides fromHistory; call collection_format first for the schema), name (optional, collection name), description (optional), vars (optional), defaults (optional). Steps preserve extraction chaining ({{var}} from earlier steps' extract). Returns {saved, path, stepCount, stepIds}.

Persist last ad-hoc request (or explicit spec) as a new step in a collection file. Params: path (required, .json/.yaml/.yml), id (optional, step id), type (optional, http|graphql|ws|sse), request (optional, explicit spec; defaults to last call's request), assert, extract, tags, name (optional, set collection name). Returns {saved, path, stepId, stepCount} or isError if no prior request and no explicit request.

Create/update named env. Values may be {value, secret:true}. Use via {{name}}.

Configure host allow/deny lists + dry-run mode. Glob patterns: *, *.example.com. Pass an empty array to allow/deny to clear that list. Returns {policy:{allow,deny,dryRun}}.

Subscribe to SSE, collect events until stop condition. Returns summarized batch with assertions. Event shape: {event:string, data:string, id:string|null, json:object|null}. Assertions: anyEvent {jsonpath,equals} matches any event; eventCount {gte/lte/eq}. Example: assert=[{anyEvent:{jsonpath:'$.event',equals:'notification'}},{eventCount:{gte:1}}].

Close a persistent WebSocket connection and release its handle.

Open long-lived WS, return handle. Use ws_send/ws_recv/ws_close to interact.

Drain buffered frames from persistent WS. Blocks up to maxDurationMs for first frame.

Send a single message on a persistent WebSocket connection opened with ws_open.

Connect WS, send messages, collect frames until stop condition. Returns summarized batch. Frame shape: {type:'text'|'binary', text:string, json:object|null}. Assertions: anyFrame {jsonpath,equals} matches any frame; frameCount {gte/lte/eq}. Example: assert=[{anyFrame:{jsonpath:'$.type',equals:'text'}},{frameCount:{gte:1}}].