nika:fetch

A missing required arg is a nika check finding before anything runs; the vocabulary below comes from the binary itself (nika catalog --tools --json), not from prose.

url

stringthe URL

method

stringGET (default) | POST | PUT | DELETE | PATCH | HEAD

headers

objectstring map · auth rides here: { x-api-key: "${{ secrets.KEY }}" }

body

request body (objects auto-JSON) · at most one of body/form/multipart

form

objectapplication/x-www-form-urlencoded scalar fields · POST/PUT/PATCH only

multipart

arraymultipart/form-data parts · {name, value} text or {name, path, filename?, content_type?} file (path is permits.fs.read-gated · ≤32 MiB total) · POST/PUT/PATCH only

traverse

objectbounded same-origin crawl · { max_pages: 1..=25 (required), respect_robots?: bool (default true) } · GET only · excludes mode/selector/jq/body/form/multipart · emits { url, page_count, pages[], assets } page digests

mode

stringmarkdown (default) | article | text | selector | jq | metadata | links | feed | sitemap | raw

selector

stringCSS selector (mode: selector only)

jq

stringa jq expression (mode: jq only · the one data language)

27  check:28    ◆invoke:29      tool: "nika:fetch"30      args:31        url: "${{ const.source_url }}"32        mode: jq33        jq: "."34    output:35      value: ".value"               # SLOT: the jq path to the watched field36    on_error:37      # Offline rehearsal · a sample UNDER the threshold — the gate stays38      # closed, the skeleton runs green before you wire the real source.39      recover: { value: 42 }

a verbatim excerpt, real line numbers from gate-and-act.nika.yaml, conformance-gated upstream on every spec push. open the full skeleton →

network egress (permits.net-gated).

• nika:fetch
• nika:notify