@taifoon/jev 0.2.4 → 0.2.6

package/README.md

@@ -12,6 +12,8 @@
 npx @taifoon/jev run --demo
 ```
 
+![npx @taifoon/jev run --demo: a real BitAgent job on Base, graded by Jev, checked against the chain](https://raw.githubusercontent.com/taifoon-io/jev/main/docs/demo.gif)
+
 Then grade your own with your TypeSafe key from [console.typesafe.ai](https://console.typesafe.ai). No runtime
 dependencies, no key inside, and it signs nothing. Recording a grade on chain is optional.
 
@@ -76,6 +78,16 @@ seat. The decision is anchored on the Taifoon devnet in
 `npx @taifoon/jev run --demo` replays it from [`examples/jobs/base-bitagent-7287.recorded.json`](examples/jobs/base-bitagent-7287.recorded.json)
 with no key and no network, and arrives at the same decision digest.
 
+## In Claude Code and other agents
+
+The repository ships a `jev-grader` skill that teaches an agent to grade a delivery the right way: the job as the buyer
+laid it out, your own key from the environment, and needs_review surfaced instead of overruled.
+
+```
+claude plugin marketplace add taifoon-io/jev && claude plugin install jev@taifoon-jev   # Claude Code
+npx skills add taifoon-io/jev --skill jev-grader                                        # Codex, Cursor, Cline and others
+```
+
 ## In n8n
 
 The same grader runs in n8n through [`@taifoon/n8n-nodes-typesafe`](https://www.npmjs.com/package/@taifoon/n8n-nodes-typesafe),
@@ -144,9 +156,6 @@ npx @taifoon/jev verify <digest> --network base
 npx @taifoon/jev workflows export ./jev-workflows
 ```
 
-Pricing the next job from a seller's record is a separate package:
-[`@taifoon/jev-wilson`](https://github.com/taifoon-io/jev-wilson).
-
 ## Licence
 
 Independent project. Jev and TypeSafe are products of TypeSafe AI, Inc., which does not endorse this package.

package/bin/run.mjs

@@ -69,16 +69,16 @@ export async function run(argv) {
 
   const t = createTerm({ quiet: json });
   const rl = yes ? null : createInterface({ input: process.stdin, output: process.stdout });
-  t.info(`jev run · ${noLayer ? 'independent (no layer)' : `layer ${layer ?? 'https://coord.taifoon.dev'}`} · grade on ${demo ? `Jev's recorded answers for ${rec.job.ref} (${rec.job.task})` : ansFile ? 'supplied answers' : process.env.TYPESAFE_KEY ? 'your TypeSafe key' : 'no key: set TYPESAFE_KEY, or try --demo'} · record → ${network === 'none' ? 'none (opt in with --record devnet|base|both)' : network}${process.env.TAIFOON_RELAYER_KEY ? ' + the layer' : ''}`);
+  t.info(`jev run · ${noLayer ? 'offline' : `layer ${layer ?? 'https://coord.taifoon.dev'}`} · grade on ${demo ? `Jev's recorded answers for ${rec.job.ref} (${rec.job.task})` : ansFile ? 'supplied answers' : process.env.TYPESAFE_KEY ? 'your TypeSafe key' : 'no key: set TYPESAFE_KEY, or try --demo'} · record → ${network === 'none' ? 'none (opt in with --record devnet|base|both)' : network}${process.env.TAIFOON_RELAYER_KEY ? ' + the layer' : ''}`);
 
   const trace = await pipeline({
     layer, job, network, protocol, priceUsdc: price ? Number(price) : undefined,
-    evidence: rec ? { subject: rec.subject.ref, chainId: rec.subject.chainId, label: rec.subject.label, state: rec.evidence, delivered: rec.facts.delivered, checks: rec.facts.checks } : jobFile ? prepareJob(JSON.parse(readFileSync(jobFile, 'utf8'))).pack : evFile ? JSON.parse(readFileSync(evFile, 'utf8')) : undefined,
+    evidence: rec ? { subject: rec.subject.ref, from: `the recorded job ${rec.job.ref} (${rec.job.protocol}, ${rec.job.price})`, chainId: rec.subject.chainId, label: rec.subject.label, state: rec.evidence, delivered: rec.facts.delivered, checks: rec.facts.checks } : jobFile ? prepareJob(JSON.parse(readFileSync(jobFile, 'utf8'))).pack : evFile ? JSON.parse(readFileSync(evFile, 'utf8')) : undefined,
     answers: rec ? rec.answers : ansFile ? JSON.parse(readFileSync(ansFile, 'utf8')) : undefined, ...(rec ? { model: rec.model } : {}),
     key: process.env.TYPESAFE_KEY || null, relayerKey: process.env.TAIFOON_RELAYER_KEY || null,
     before: async (s) => {
       t.step(STEPS.indexOf(s) + 1, STEPS.length, s.title);
-      if (s.route) t.note(s.route);
+      if (s.route && !noLayer) t.note(s.route);
       if (!rl) return true;
       const r = (await rl.question(s.required ? '  enter = run · q = quit › ' : '  enter = run · s = skip · q = quit › ')).trim().toLowerCase();
       if (r === 'q') { rl.close(); process.exit(0); }

package/dist/pipeline.d.ts

@@ -95,6 +95,7 @@ export type PipelineOpts = {
         subject: string;
         chainId?: number;
         label?: string;
+        from?: string;
         state: string;
         delivered?: boolean;
         checks?: FactsInput['checks'];

package/dist/pipeline.js

@@ -98,7 +98,7 @@ export async function pipeline(o = {}) {
     await step('pick', async () => {
         if (o.evidence) {
             t.job = { chainId: o.evidence.chainId ?? 0, jobId: o.evidence.subject, seller: o.evidence.seller ?? null };
-            return { skip: 'your own evidence pack' };
+            return { skip: o.evidence.from ?? 'your own evidence pack' };
         }
         if (o.job) {
             t.job = { ...parseJob(o.job), seller: null };
@@ -117,7 +117,7 @@ export async function pipeline(o = {}) {
     await step('evidence', async () => {
         if (o.evidence) {
             ev = { chainId: 0, jobId: o.evidence.subject, state: o.evidence.state, facts: [] };
-            return { skip: 'your own evidence pack' };
+            return { skip: o.evidence.from ?? 'your own evidence pack' };
         }
         ev = await getJson(f, `${layer}/v1/judge/evidence/${t.job.chainId}/${encodeURIComponent(t.job.jobId)}`);
         t.job.seller ??= fact(ev, /^seller$/i) ?? null;
@@ -182,7 +182,7 @@ export async function pipeline(o = {}) {
     await step('premium', async () => {
         const seller = t.job.seller;
         if (!layer)
-            return { skip: 'independent mode: price it with @taifoon/jev-wilson (premium({ k, n }, { price }))' };
+            return { skip: 'offline: the premium quote reads the seller\'s record from the layer' };
         if (!seller)
             return { skip: 'no seller address in the evidence' };
         const price = o.priceUsdc ?? budget;

package/docs/PIPELINE.md

@@ -64,7 +64,7 @@ npx @taifoon/jev run --no-layer --evidence pack.json    # your own pack, no laye
 | 4 | Jev answers RUBRIC_v1, code composes the verdict | none | same |
 | 5 | record the answers and the decision | `POST /v1/judge/answers/record` (only with `TAIFOON_RELAYER_KEY`) | unsigned calls |
 | 6 | the evaluator call that ends the job | none | same |
-| 7 | price the next premium from the seller record | `POST /v1/pools/quote` | skipped; use `@taifoon/jev-wilson` |
+| 7 | price the next premium from the seller record | `POST /v1/pools/quote` | skipped (the quote needs the seller's record) |
 | 8 | re-derive the receipt (and find it on chain) | none | same |
 
 Steps 1 to 4 are required: saying no at one stops the run. Keys come from the environment only, `TYPESAFE_KEY` (your own

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@taifoon/jev",
-  "version": "0.2.4",
+  "version": "0.2.6",
   "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.",
   "keywords": [
     "jev",
@@ -50,7 +50,8 @@
     "docs",
     "examples",
     "README.md",
-    "LICENSE"
+    "LICENSE",
+    "!docs/demo.gif"
   ],
   "sideEffects": false,
   "engines": {