jev-recipes 0.8.2 → 0.8.4
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 +22 -2
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -7,7 +7,7 @@
|
|
|
7
7
|
[](https://nodejs.org/)
|
|
8
8
|
[](https://github.com/agencyenterprise/jev-recipes/blob/main/LICENSE)
|
|
9
9
|
|
|
10
|
-
[Quickstart](#use-a-recipe) | [Recipe catalog](https://github.com/agencyenterprise/jev-recipes/blob/main/recipes/README.md) | [API vs. SDK vs. recipes](https://github.com/agencyenterprise/jev-recipes/blob/main/docs/api-sdk-recipes.md) | [Contributing](https://github.com/agencyenterprise/jev-recipes/blob/main/CONTRIBUTING.md)
|
|
10
|
+
[Quickstart](#use-a-recipe) | [Live music app](https://jev-ai-music.com/) | [Coding assistants](https://github.com/agencyenterprise/jev-recipes/blob/main/docs/coding-assistants.md) | [Recipe catalog](https://github.com/agencyenterprise/jev-recipes/blob/main/recipes/README.md) | [API vs. SDK vs. recipes](https://github.com/agencyenterprise/jev-recipes/blob/main/docs/api-sdk-recipes.md) | [Contributing](https://github.com/agencyenterprise/jev-recipes/blob/main/CONTRIBUTING.md)
|
|
11
11
|
|
|
12
12
|
<!-- BEGIN GENERATED: summary -->
|
|
13
13
|
|
|
@@ -17,14 +17,32 @@
|
|
|
17
17
|
|
|
18
18
|
Each recipe accepts your data, calls [Jev through TypeSafe's System One API](https://docs.typesafe.ai/introduction) or an injected compatible client, and returns a structured decision. Use it in a Node.js backend, a script, or a research evaluation. Your application decides what happens next.
|
|
19
19
|
|
|
20
|
-
Start with
|
|
20
|
+
## Start with one decision
|
|
21
|
+
|
|
22
|
+
| Your task | Try without a key | Build the workflow |
|
|
23
|
+
| --------------------------------- | ------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
|
|
24
|
+
| Route work to the right team | `npx jev-recipes demo route` | [Route work](https://github.com/agencyenterprise/jev-recipes/blob/main/examples/getting-started/README.md#route-work) |
|
|
25
|
+
| Select useful evidence | `npx jev-recipes demo rerank` | [Select evidence](https://github.com/agencyenterprise/jev-recipes/blob/main/examples/getting-started/README.md#select-evidence) |
|
|
26
|
+
| Review an agent's proposed action | `npx jev-recipes demo tool-call-gate` | [Review an action](https://github.com/agencyenterprise/jev-recipes/blob/main/examples/getting-started/README.md#review-an-action) |
|
|
27
|
+
|
|
28
|
+
These demos use saved responses. The [runnable workflow examples](https://github.com/agencyenterprise/jev-recipes/blob/main/examples/getting-started/README.md) show ready decisions, uncertainty, and provider failures. Use [TypeSafe directly or Vercel Gateway](https://github.com/agencyenterprise/jev-recipes/blob/main/docs/integrations.md) for live calls.
|
|
21
29
|
|
|
22
30
|
For example, give `route` a support message and descriptions of your teams. It returns a team such as `billing`, or a review outcome when the choice is uncertain.
|
|
23
31
|
|
|
24
32
|
Evaluate your own cases with the [installed evaluator](https://github.com/agencyenterprise/jev-recipes/blob/main/docs/evaluation.md), retain model responses, and replay confidence policies offline. The [agent workflow](https://github.com/agencyenterprise/jev-recipes/blob/main/examples/agent-loop/README.md) and [customer queue](https://github.com/agencyenterprise/jev-recipes/blob/main/examples/customer-queue/README.md) show how decisions fit into application code. [Direct and Gateway integrations](https://github.com/agencyenterprise/jev-recipes/blob/main/docs/integrations.md) use the same recipe interface.
|
|
25
33
|
|
|
34
|
+
Try the [support-routing starter](https://github.com/agencyenterprise/jev-recipes/blob/main/examples/support-routing/README.md) for a small web app with ready, review, and optional fallback paths. Its [rules/Jev/fallback comparison](https://github.com/agencyenterprise/jev-recipes/blob/main/evals/support-routing/README.md) retains responses and labels experimental evidence explicitly.
|
|
35
|
+
|
|
26
36
|
Build the searchable static catalog with `npm run site:build`, then preview it with `npm run site:preview`. It includes fixture exploration, related-recipe comparisons, and saved evaluation evidence. Current measurements and missing or older evidence are labeled explicitly.
|
|
27
37
|
|
|
38
|
+
## Hear a real application: Jevthoven
|
|
39
|
+
|
|
40
|
+
[Jevthoven](https://jev-ai-music.com/) is a music app built by this package's maintainer using jev-recipes. Its interface lets listeners choose a style, key, and tempo, and displays Jev's musical decisions alongside a piano roll. Playback requires sign-in.
|
|
41
|
+
|
|
42
|
+
[Open the music app](https://jev-ai-music.com/) · [Read the integration example](https://github.com/agencyenterprise/jev-recipes/blob/main/examples/jevthoven/README.md)
|
|
43
|
+
|
|
44
|
+
This is a maintainer-built application, not an independent customer adoption claim or a recipe accuracy benchmark.
|
|
45
|
+
|
|
28
46
|
## Watch Jev play checkers against Jev using the checkers-move recipe
|
|
29
47
|
|
|
30
48
|
[](https://www.youtube.com/shorts/Z282rGKysTg)
|
|
@@ -253,6 +271,8 @@ The [research guide](https://github.com/agencyenterprise/jev-recipes/blob/main/d
|
|
|
253
271
|
|
|
254
272
|
## Contributing and support
|
|
255
273
|
|
|
274
|
+
Built something with Jev? [Add your project to the examples](https://github.com/agencyenterprise/jev-recipes/blob/main/examples/README.md#add-your-project). Share a runnable demo or a walkthrough with a link to your deployed app so others can try it and learn how it works.
|
|
275
|
+
|
|
256
276
|
[Report a bug or request a recipe](https://github.com/agencyenterprise/jev-recipes/issues). Include the recipe name, package and Node.js versions, and a minimal reproduction. Keep API keys and private inputs out of reports.
|
|
257
277
|
|
|
258
278
|
To work on the repository:
|