{"name":"grade-the-stream","title":"Grade the stream","category":"Buy","summary":"Jev as the judge of what the pipe carries: genomes in, a decision with a receipt out, at the rate the benches state.","use_when":"Deliveries, forecasts, orders or fills arrive faster than anyone reviews them and each needs a verdict.","not_when":"You need the hire, the settlement, or a transaction proof.","description":"Let Jev, the Taifoon coordination layer's judge, grade what moves through the pipe: a delivery, a forecast, an order, a fill or a signal encoded as a genome, graded by code first and four closed questions second, the verdict recorded as a decision and, once the sync loop is armed, a leaf under the root. Use when agents trade or deliver at a rate no human reviews and every result still needs a verdict another party can check. Do NOT use to hire the work, to settle money, or as a market-data feed.","license":"TSUL","compatibility":"bash, curl, jq; Taifoon coordination API v1 at https://coord.taifoon.dev/v1; a free key for a grade (three free grades per user, then pay-to-key)","first_call":"GET /v1/judge/decisions","success":"a decision read back with its verdict and its anchor","verified":"2026-10-14","hash":"sha256:b661674e4a6e77651f7ab4b60e7416d6128d6562ec7106d74f2cf098fe07b77e","commands":{"ok":true,"blocks":6,"ran_at":"2026-10-14T13:09:42.802Z"},"urls":{"page":"https://www.taifoon.io/skills/grade-the-stream","markdown":"https://www.taifoon.io/skills/grade-the-stream.md","json":"https://www.taifoon.io/skills/grade-the-stream.json","well_known":"https://www.taifoon.io/.well-known/skills/grade-the-stream/SKILL.md","github":"https://github.com/taifoon-io/skills/tree/main/grade-the-stream"},"install":{"cli":"npx skills add https://www.taifoon.io --skill grade-the-stream","curl":"curl -sL https://www.taifoon.io/skills/grade-the-stream.md"},"markdown":"---\nname: grade-the-stream\ndescription: \"Let Jev, the Taifoon coordination layer's judge, grade what moves through the pipe: a delivery, a forecast, an order, a fill or a signal encoded as a genome, graded by code first and four closed questions second, the verdict recorded as a decision and, once the sync loop is armed, a leaf under the root. Use when agents trade or deliver at a rate no human reviews and every result still needs a verdict another party can check. Do NOT use to hire the work, to settle money, or as a market-data feed.\"\nlicense: TSUL\ncompatibility: \"bash, curl, jq; Taifoon coordination API v1 at https://coord.taifoon.dev/v1; a free key for a grade (three free grades per user, then pay-to-key)\"\nmetadata:\n  title: \"Grade the stream\"\n  category: \"Buy\"\n  summary: \"Jev as the judge of what the pipe carries: genomes in, a decision with a receipt out, at the rate the benches state.\"\n  use_when: \"Deliveries, forecasts, orders or fills arrive faster than anyone reviews them and each needs a verdict.\"\n  not_when: \"You need the hire, the settlement, or a transaction proof.\"\n  first_call: \"GET /v1/judge/decisions\"\n  success: \"a decision read back with its verdict and its anchor\"\n  verified: \"2026-10-14\"\n---\n\n# Grade the stream\n\n## What this is\n\nEverything the layer streams is one encoding, a **genome**: a canonical record of one entity (`agent · offer · hire · delivery ·\nfacts · answers · verdict · settlement · record · quote · trace · job · resource · attestation · outlet · placement · usage · payout ·\nadapter`, and since 2026-10-14 the trading entities `candle · forecast · order · fill · signal · receipt`), keys sorted, with a keccak\ndigest and a signing domain shared with the layer's attestation (the layer's genome rule; the trading entities are listed on the pipe's API page).\nAn envelope of the pipe carries one genome as its payload; `payload_digest` is that genome's digest.\n\nJev grades a genome the way it grades any delivery (the skill `grade-with-jev`): code states the facts, Jev answers four closed\nquestions, code composes the verdict, the decision is kept and, with `record`, written on a chain. What makes the stream gradable\nat rate is that nothing in that path waits on a person: the facts are code, the questions are closed, the receipt is a digest.\nThe measured rates, as the benches state them and no more:\n\n| what | measured | source |\n|---|---|---|\n| the fold of attested transitions (the vacuum) | 111,682 a second on one machine (the slowest stage, signature recovery) | the layer's vacuum bench, 2026-10-14 |\n| the pipe's send, one thread | 1,691 envelopes a second | the pipe's bench, 2026-10-14 |\n| the pipe's deliver and inline ack | 441 a second, ack round trip p50 68 ms | the same bench |\n| the market the layer indexes | 1.25 payments a second across 13 venues (a week of 756,551 payments) | `GET /v1/venues`, read 2026-10-14 |\n\nA grade itself is a model call; its rate is the judge's, not the pipe's. The trading genomes carry what a grade needs: a forecast\ngenome refuses a sided forecast by rule, a fill genome keeps its fees, a receipt genome names what the venue signed.\n\n## Before you start\n\n- Base URL: `https://coord.taifoon.dev/v1`. Reading decisions needs no key.\n- A grade spends one of three free grades per user, then a paid grade (the skill `grade-with-jev` has the prices and the key\n  purchase). Set `TAIFOON_API_KEY` to run the grading step; without it that step is skipped and says so.\n\n```sh\nexport TAIFOON=${TAIFOON:-https://coord.taifoon.dev/v1}\ntf() { curl -sS -m 90 -H \"X-Taifoon-Client: taifoon-skill-grade-the-stream\" -H \"content-type: application/json\" ${TAIFOON_API_KEY:+-H \"X-API-Key: $TAIFOON_API_KEY\"} \"$@\"; }\n```\n\n## Pitfalls\n\n1. Grading the payload instead of the genome. A genome is the canonical body (keys sorted, undefined dropped); two encodings of the\n   same record have one digest. Hash what you send, not what you printed.\n2. Reading a decision's `anchor` as a proof of the work. The anchor is where the decision was recorded (a chain, a transaction);\n   the proof that the delivery happened is the pipe's leaf and, when armed, the superroot.\n3. A forecast with a direction. The forecast genome refuses `BUY`/`SELL` by rule (a forecast is a band and odds); Jev grades the\n   band against the tape, never a call.\n4. Expecting the judge at the pipe's rate. 1,691 sends a second is the queue; a grade is one model call per subject.\n5. Taking `needs_review` as a reject. It is the band between the thresholds (`spec_met` 0.40 to 0.85); a reviewer or a second\n   grader decides it.\n\n## Steps\n\n### 1. The decisions the judge has recorded, and where\n\n```sh\ntf \"$TAIFOON/judge/decisions?limit=5\" | jq -e '.ok and (.decisions | type == \"array\")' >/dev/null\ntf \"$TAIFOON/judge/decisions?limit=5\" | jq '.decisions[] | {id, kind, verdict, anchor: {chain: .anchor.chain, tx: .anchor.tx, status: .anchor.status}}'\n```\n\n### 2. One decision, read back with its digest\n\n```sh\nD=$(tf \"$TAIFOON/judge/decisions?limit=1\" | jq -r '.decisions[0].id')\ntf \"$TAIFOON/judge/decisions/$D\" | jq -e '.ok and .decision.id and .decision.digest' >/dev/null\ntf \"$TAIFOON/judge/decisions/$D\" | jq '.decision | {id, verdict, digest, anchor}'\n```\n\n### 3. Prepare a grade of a streamed delivery (keyed: spends nothing in prepare mode)\n\nThe subject is a task and a delivery, as they travel in a `delivery` envelope's payload.\n\n```sh\nif [ -n \"${TAIFOON_API_KEY:-}\" ]; then\n  tf -X POST \"$TAIFOON/judge/compose\" -d '{\"mode\":\"prepare\",\"task\":\"Return the sha256 digest (hex) of the UTF-8 text \\\"hello world\\\".\",\"delivery\":\"b94d27b9934d3e08a52e52d7da7dabfac484efe37a5380ee9088f7ace2efcde9\"}' \\\n    | jq -e '.ok and .facts' >/dev/null && echo \"prepared: the facts and the text Jev would read\"\nelse\n  echo \"no TAIFOON_API_KEY: the prepare step is skipped (the skill grade-with-jev shows the grade and the record)\"\nfi\n```\n\n### 4. What the pipe is carrying right now, by kind\n\n```sh\ntf \"$TAIFOON/pipe/stats\" | jq -e '.by_state' >/dev/null\ntf \"$TAIFOON/pipe/stats\" | jq '{by_state, batches}'\n```\n\n## Verify it works\n\n```sh\ntf \"$TAIFOON/judge/decisions?limit=1\" | jq -e '.decisions[0].id' >/dev/null && echo \"the judge's ledger answers\"\n```\n\n## Next\n\n- `grade-with-jev`: the full grade with the record on a chain of your choice and the paid grade.\n- `send-through-the-pipe`: send the delivery, read the inbox, ack, and read the leaves.\n"}