@taifoon/jev 0.2.15 → 0.2.16
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +6 -6
- package/docs/ON_CHAIN.md +2 -2
- package/docs/PIPELINE.md +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -6,13 +6,13 @@
|
|
|
6
6
|
delivery, and code turns the answers into complete, reject or needs review, with a receipt anyone can recompute.
|
|
7
7
|
- **Why:** agents are paid on chain for work nobody reads. A grade with its full probabilities, a published rubric and
|
|
8
8
|
an appeal path is something a buyer, a seller and a contract can all rely on.
|
|
9
|
-
- **How:** replay a
|
|
9
|
+
- **How:** replay a Base job, graded by Jev, offline and with no key:
|
|
10
10
|
|
|
11
11
|
```
|
|
12
12
|
npx @taifoon/jev run --demo
|
|
13
13
|
```
|
|
14
14
|
|
|
15
|
-

|
|
16
16
|
|
|
17
17
|
Then grade your own with your TypeSafe key from [console.typesafe.ai](https://console.typesafe.ai). Installing it also
|
|
18
18
|
installs Taifoon's other packages (@taifoon/jev-wilson, @taifoon/n8n-nodes-typesafe). No key inside, and it signs nothing. Recording a grade on chain is optional.
|
|
@@ -54,11 +54,11 @@ claims the evidence cannot support. Grade one with your key:
|
|
|
54
54
|
|
|
55
55
|
```
|
|
56
56
|
TYPESAFE_KEY=… npx @taifoon/jev run --job-file examples/jobs/invoice-extraction.json
|
|
57
|
-
npx @taifoon/jev run --demo # offline, no key: replays the
|
|
57
|
+
npx @taifoon/jev run --demo # offline, no key: replays the Base job below and checks it against the chain
|
|
58
58
|
npx @taifoon/jev run # a live Base job from the coordination layer's queue (needs TYPESAFE_KEY)
|
|
59
59
|
```
|
|
60
60
|
|
|
61
|
-
## A
|
|
61
|
+
## A Base job, graded
|
|
62
62
|
|
|
63
63
|
[BitAgent](https://basescan.org/address/0x5009ABB3A309115a4a682C66BAf3BC9E0329BaB7) job 7287 on Base: a buyer paid
|
|
64
64
|
1.5 USDC for `equity_research where ticker is 'AAPL'`. The seller submitted within seconds, but only a 32-byte digest
|
|
@@ -109,7 +109,7 @@ Safe by default: your own TypeSafe key only, nothing recorded, nothing signed or
|
|
|
109
109
|
|
|
110
110
|
| Flag | Default | What it does |
|
|
111
111
|
|---|---|---|
|
|
112
|
-
| `--demo` | off | Replays the
|
|
112
|
+
| `--demo` | off | Replays the Base job above, offline, no key |
|
|
113
113
|
| `--job <chain>:<id>` | first ready job in the layer's queue | Grade one live job, e.g. `8453:bitagent:8453:7287` |
|
|
114
114
|
| `--job-file job.json` | | Grade a job you describe (see `examples/jobs/`) |
|
|
115
115
|
| `--evidence pack.json` | | Grade your own evidence pack, no layer |
|
|
@@ -162,7 +162,7 @@ Each is tested against calldata a mined transaction carried.
|
|
|
162
162
|
- [Selling through Taifoon: readiness, the signed enrich route, A2A and x402 shapes, a first graded job, Monad](docs/SELLERS.md)
|
|
163
163
|
- [API: the six calls, where Jev is reached, your own rubric](docs/API.md)
|
|
164
164
|
- [Evaluator seats, with the transactions they are tested against](docs/EVALUATORS.md)
|
|
165
|
-
- [On chain: contract addresses on Base and devnet, and one
|
|
165
|
+
- [On chain: contract addresses on Base and devnet, and one grade end to end](docs/ON_CHAIN.md)
|
|
166
166
|
- [The records: receipt, decision.v2, jev.answer.v1](docs/RECORDS.md)
|
|
167
167
|
- [n8n workflows, and the TypeSafe node's Jev Options](docs/WORKFLOWS.md)
|
|
168
168
|
- [Develop](docs/DEVELOP.md)
|
package/docs/ON_CHAIN.md
CHANGED
|
@@ -19,7 +19,7 @@ On Base (8453), since 0.2.0:
|
|
|
19
19
|
`npx @taifoon/jev verify <digest> --network base` read them (the CLI's default `any` tries the devnet, then Base).
|
|
20
20
|
0.1.0 carried no Base addresses. An earlier Base answer log, `0x5bac70eb78224bbCBa83f5A36DF09D549d3f57fa`, is superseded and holds no records.
|
|
21
21
|
|
|
22
|
-
Here is one
|
|
22
|
+
Here is one grade, end to end: n8n execution 86, a proof-verification job graded with RUBRIC_v1.
|
|
23
23
|
|
|
24
24
|
- Answers recorded in devnet tx
|
|
25
25
|
[`0x9a38cf55…a61b`](https://www.taifoon.io/scan/36927/tx/0x9a38cf5541bb82a8a6e2e5cf1a96ed25fdc46921c351506da83023f5dec1a61b).
|
|
@@ -29,7 +29,7 @@ Here is one real grade, end to end: n8n execution 86, a proof-verification job g
|
|
|
29
29
|
Decision digest `0x781b0fce…3667`, confidence 2,700 bps.
|
|
30
30
|
- Jev answered spec_met `{ yes: 0.36, no: 0.64 }`, so the composed verdict is **reject** (spec_met ≤ 0.40).
|
|
31
31
|
|
|
32
|
-
`verify('0x6c7e6d29…f52d')` finds both rows. This is
|
|
32
|
+
`verify('0x6c7e6d29…f52d')` finds both rows. This is its output:
|
|
33
33
|
|
|
34
34
|
```
|
|
35
35
|
{"ok":true,"checks":{"answersOnChain":true,"decisionOnChain":true},
|
package/docs/PIPELINE.md
CHANGED
|
@@ -71,6 +71,6 @@ Steps 1 to 4 are required: saying no at one stops the run. Keys come from the en
|
|
|
71
71
|
TypeSafe key; without it the Jev step stops and says where to get one) and `TAIFOON_RELAYER_KEY`, and are never printed. Nothing is signed. In code it is `pipeline()`,
|
|
72
72
|
with a `before` gate and an `after` hook per step.
|
|
73
73
|
|
|
74
|
-
|
|
74
|
+
A run (2026-09-27): BitAgent job 7287 on Base asked for "equity_research where ticker is 'AAPL'" and
|
|
75
75
|
got a 32-byte digest. Facts passed (delivered, before the deadline, 1.5 USDC). Jev answered spec_met 0.03, so the
|
|
76
76
|
verdict is **reject**; the receipt re-derives; the seller's quote is 0.0%–39.0% (6 settled, thin record).
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@taifoon/jev",
|
|
3
|
-
"version": "0.2.
|
|
3
|
+
"version": "0.2.16",
|
|
4
4
|
"description": "Grade AI agent jobs with TypeSafe's Jev and record the verdict on chain: code checks the facts, Jev answers a published rubric, and you get a receipt, the on-chain record and the evaluator call for ERC-8183 and Virtuals ACP. No runtime dependencies, no key inside.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"jev",
|