jev-recipes 0.9.0 → 0.9.2

package/README.md

@@ -1,6 +1,6 @@
 # jev-recipes
 
-**Small, readable decisions for Jev and compatible System One APIs.**
+**Typed AI decisions for agents, RAG, and support flows: route, rerank, gate, grade, compare, and label text with one function call. Plug into Vercel AI SDK or LangChain, or call any recipe directly.**
 
 [![npm version](https://img.shields.io/npm/v/jev-recipes)](https://www.npmjs.com/package/jev-recipes)
 [![CI](https://github.com/agencyenterprise/jev-recipes/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/agencyenterprise/jev-recipes/actions/workflows/ci.yml)
@@ -31,6 +31,10 @@ For example, give `route` a support message and descriptions of your teams. It r
 
 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.
 
+## Watch Jev play checkers against Jev using the checkers-move recipe
+
+[![Jev plays checkers against Jev using the checkers-move recipe](https://raw.githubusercontent.com/agencyenterprise/jev-recipes/main/examples/checkers/jev-vs-jev.gif)](https://www.youtube.com/shorts/Z282rGKysTg)
+
 ## Build a complete support flow
 
 The [support conversation starter](https://github.com/agencyenterprise/jev-recipes/blob/main/examples/support-routing/README.md) checks for missing details, asks a configured question, and resumes with the customer's answer. It proposes a queue or requests human review when the conversation remains unresolved.
@@ -55,10 +59,6 @@ Build the searchable static catalog with `npm run site:build`, then preview it w
 
 This is a maintainer-built application, not an independent customer adoption claim or a recipe accuracy benchmark.
 
-## Watch Jev play checkers against Jev using the checkers-move recipe
-
-[![Jev plays checkers against Jev using the checkers-move recipe](https://raw.githubusercontent.com/agencyenterprise/jev-recipes/main/examples/checkers/jev-vs-jev.gif)](https://www.youtube.com/shorts/Z282rGKysTg)
-
 ## Use a recipe
 
 Requires **Node.js 22.9 or newer**, ES modules, and a **[TypeSafe API key](https://console.typesafe.ai/keys)**. Live calls send the supplied input to TypeSafe and use API quota.
@@ -204,6 +204,8 @@ npx jev-recipes run route input.json
 
 Read `result.status` and `result.route` in the JSON output. Substitute another recipe's name in both commands to use a different decision. Run `npx jev-recipes --help` for all commands.
 
+`run` accepts UTF-8 JSON files and stdin, with or without a byte-order mark (BOM), and UTF-16 files or stdin with a BOM. Non-English text and route names are preserved; no file conversion is needed for these encodings.
+
 The CLI reads environment variables; it does not automatically load `.env`. Errors go to stderr with exit code `1`. A review outcome is a completed evaluation, so inspect the result before acting.
 
 <a id="understand-the-result"></a>

package/dist/cli/index.js

@@ -106,23 +106,46 @@ async function runLiveRecipe(name, source) {
             name +
             ' without a key.');
     }
-    const inputJson = source === '-' ? await readStandardInput() : await readFile(source, 'utf8');
+    const input = await readJsonInput(source);
     const run = await loadRecipe(name);
-    const result = await run(JSON.parse(inputJson));
+    const result = await run(input);
     printJson({ mode: 'live', result });
 }
+async function readJsonInput(source) {
+    const inputBytes = source === '-' ? await readStandardInput() : await readFile(source);
+    const inputText = decodeInputText(inputBytes);
+    return JSON.parse(inputText);
+}
+async function readStandardInput() {
+    const chunks = [];
+    for await (const chunk of stdin)
+        chunks.push(chunk);
+    return Buffer.concat(chunks);
+}
+function decodeInputText(bytes) {
+    const encoding = detectInputEncoding(bytes);
+    try {
+        return new TextDecoder(encoding, { fatal: true }).decode(bytes);
+    }
+    catch {
+        throw new Error('Input must be UTF-8 or UTF-16 with a byte-order mark.');
+    }
+}
+function detectInputEncoding(bytes) {
+    const byteOrderMark = bytes.subarray(0, 2);
+    const utf16LittleEndianMark = Buffer.from([0xff, 0xfe]);
+    const utf16BigEndianMark = Buffer.from([0xfe, 0xff]);
+    if (byteOrderMark.equals(utf16LittleEndianMark))
+        return 'utf-16le';
+    if (byteOrderMark.equals(utf16BigEndianMark))
+        return 'utf-16be';
+    return 'utf-8';
+}
 async function readDemoFixture(name) {
     const fixturePath = new URL(`../recipes/${name}/demo.json`, import.meta.url);
     const fixtureJson = await readFile(fixturePath, 'utf8');
     return demoFixtureSchema.parse(JSON.parse(fixtureJson));
 }
-async function readStandardInput() {
-    stdin.setEncoding('utf8');
-    let input = '';
-    for await (const chunk of stdin)
-        input += chunk;
-    return input;
-}
 function printJson(value) {
     stdout.write(`${JSON.stringify(value, null, 2)}\n`);
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "jev-recipes",
-  "version": "0.9.0",
-  "description": "Small, composable Jev decisions for retrieval, conversations, and agent workflows.",
+  "version": "0.9.2",
+  "description": "248 small Jev decisions for JavaScript and TypeScript: route, rerank, gate, grade, compare, and label text for agents, RAG, support, code review, and music. Each returns a typed result with explicit uncertainty. Plug into Vercel AI SDK or LangChain agents, import one recipe, or run the CLI with JSON from any language.",
   "type": "module",
   "license": "MIT",
   "repository": {
@@ -1106,19 +1106,25 @@
     "vite": "6.4.3",
     "vitest": "4.1.11"
   },
-  "homepage": "https://github.com/agencyenterprise/jev-recipes#readme",
+  "homepage": "https://jev-recipes.com",
   "bugs": {
     "url": "https://github.com/agencyenterprise/jev-recipes/issues"
   },
   "keywords": [
     "jev",
     "typesafe",
-    "recipes",
-    "ai",
+    "ai-agents",
+    "agents",
+    "llm",
+    "ai-sdk",
+    "vercel-ai-sdk",
+    "langchain",
+    "guardrails",
+    "tool-calling",
     "routing",
     "reranking",
     "rag",
-    "evidence",
+    "classification",
     "typescript",
     "cli"
   ],