Update to Redpine

Changed files

.app.json →

.codex-plugin/plugin.json →

.mcp.json →

assets/icon.svg →

skills/redpine-search/LICENSE →

skills/redpine-search/SKILL.md →

skills/redpine-search/references/billing.md →

skills/redpine-search/references/craft.md →

skills/redpine-search/references/search.md →

skills/redpine-search/references/troubleshooting.md →

skills/redpine-search/references/billing.md

--- before
+++ after
@@ -0,0 +1,55 @@
+# Spending credits deliberately
+
+## What is free
+
+`get_balance`, `find-tools`, `inspect-tool`, `preview`, `request_journal`, and
+`list_collections` never deduct. A search whose preview comes back
+`"workflow": "complete"` is free too, and the data is already in the preview
+response.
+
+`preview` only accepts a search (`search` or a `search-<name>`). Every other
+tool is priced per call with nothing to unlock incrementally, so it is called
+by name and bills once. That makes the price quoted in `find-tools` the number
+to get consent against, before the call rather than after it.
+
+## What bills
+
+`confirm`, `call-tool`, and any direct `search-<name>` call. The first is
+deliberate; the other two are immediate. Prefer the deliberate path unless the
+user has already said yes to the spend.
+
+## Buy only what is relevant
+
+For search previews, the teaser carries every result's metadata (title,
+publisher, year, source) and a short snippet per chunk. Read them, pick the
+results that actually answer the question, and pass only those ids:
+
+```
+confirm { "queryId": "...", "result_ids": ["r1", "r4"] }
+```
+
+The id is the one the search returned. The response spells it `query_id`,
+confirm's schema spells it `queryId`, and both are accepted. `preview_id`
+addressed a retired scheme and buys nothing.
+
+Omitting `result_ids` unlocks everything and bills for everything. That is
+rarely what the user wants from a ten-result preview.
+
+## Balance
+
+`confirm` returns `cost_charged` and `balance_remaining`. Report both; a second
+`get_balance` call is unnecessary. When the server's instructions carry a
+low-balance warning, quote the remaining balance next to every cost so the user
+can decide with the number in front of them.
+
+## Trial
+
+A trial account has a fixed number of queries rather than a balance. Previews
+do not consume them; confirmed or direct calls do. The server's instructions
+say how many remain. Be explicit that a direct `search-<name>` call spends one.
+
+## How long a preview lasts
+
+Seven days, addressed by its `queryId`. A confirm that failed on a balance
+shortfall or a transient error is retried with the same `queryId` rather than
+re-previewed.