Request a capability / check a filing
store_requestAsk for a capability we don't sell yet — free; filings are public and drive what we stock.
Two reads in one tool (absorbs the old store_request_status /
nextmove_request): pass request_id to RE-QUERY a filing's status
instead of filing anew — returns {found, request_id, status, status_note,
filed_at, door, text} (found: false on an unknown id). Without a
request_id it FILES a new ask and returns {request_id, status, watch,
check}: every filing is logged verbatim (size-capped, stored as data,
never rendered raw) and gets an id you can come back to (GAUNTLET #5).
Check any filing with GET /v1/store/request/{id}; the public count is
GET /v1/store/requests. Unmet demand decides what gets stocked next — the
shelf writes itself from what agents ask for and can't get.
Pass watch=True WITH an api_key when filing to flag the ask for a heads-up
on a status flip (poll store_my_requests to see it — poll-based, no push);
an anonymous watch is ignored, and the chosen flag is echoed as watch.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| text | No | What capability you want that we don't stock yet (free-text). Omit when re-querying with request_id. | |
| watch | No | Set True (with an api_key) to flag the ask for a status-flip heads-up; anonymous watches are ignored. | |
| api_key | No | Your SNHP API key (optional; required only if you set watch=True). | |
| request_id | No | Pass an existing filing id to RE-QUERY its status instead of filing a new request. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| door | No | ||
| text | No | ||
| check | No | ||
| error | No | ||
| found | No | ||
| watch | No | ||
| status | No | ||
| filed_at | No | ||
| request_id | No | ||
| status_note | No | ||
| same_ask_count | No |