n8n-nodes-jev 0.2.0

package/LICENSE.md

@@ -0,0 +1,19 @@
+Copyright 2026 Brains of Bots
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
+of the Software, and to permit persons to whom the Software is furnished to do
+so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,300 @@
+# n8n-nodes-jev
+
+[![CI](https://github.com/vibe-with-me-tools/n8n-nodes-jev/actions/workflows/ci.yml/badge.svg)](https://github.com/vibe-with-me-tools/n8n-nodes-jev/actions/workflows/ci.yml)
+[![npm version](https://img.shields.io/npm/v/n8n-nodes-jev.svg)](https://www.npmjs.com/package/n8n-nodes-jev)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE.md)
+
+An [n8n](https://n8n.io) community node for **Jev**, a decision model from [TypeSafe](https://docs.typesafe.ai).
+
+Many workflows have a step where something needs a judgment. Which team should handle this ticket? Is this lead a good fit? Does this message contain personal data? Jev answers questions like these. You define the question and the answers it can give, and Jev returns one of your answers with a probability for each option. It doesn't write text, so there's no JSON to parse and no free-form reply to check.
+
+The probabilities are what make this useful in a workflow. When Jev isn't sure, the numbers show it, so you can send that item to a person instead of acting on a guess.
+
+![How the Jev node works](docs/images/how-it-works.svg)
+
+## Contents
+
+- [Why use Jev for this step](#why-use-jev-for-this-step)
+- [Question types](#question-types)
+- [When to use it](#when-to-use-it)
+- [Use cases](#use-cases)
+- [Installation](#installation)
+- [Credentials](#credentials)
+- [Operations](#operations)
+- [Example workflows](#example-workflows)
+- [Writing good questions](#writing-good-questions)
+- [Limits and costs](#limits-and-costs)
+- [Development](#development)
+
+## Why use Jev for this step
+
+In n8n today, a judgment step usually means an LLM node, a Structured Output Parser, and an IF node to catch replies that don't match the format. A general-purpose LLM can do the job, but it writes its answer out token by token, and you have to check whatever comes back.
+
+Jev is built only for this kind of step. It doesn't write a reply. It scores the options you gave it and returns the result.
+
+| | LLM with a structured-output prompt | Jev |
+| --- | --- | --- |
+| **What comes back** | Generated text that should match your format, so you parse and validate it | One of your options, always. It can't return a value you didn't define. |
+| **Speed** | Grows with the length of the reply, because every output token is generated | Most requests finish in about 100 ms, according to TypeSafe. All questions in a request are answered in parallel. |
+| **Cost** | Input and output tokens | Input tokens only, at $0.042 per million. Output is free. |
+| **Knowing when it's unsure** | No built-in signal in the answer. Some APIs expose token probabilities, but they don't map directly onto your options. | A probability for every option, trained to be calibrated, so a low number means send it to a person |
+| **Same input, same answer** | Can vary between runs | Designed to give stable answers on repeated runs |
+
+For scale: in TypeSafe's own cost comparison (September 2026), a small general-purpose model, gpt-5.4-mini, costs $0.75 per million input tokens and $4.50 per million output tokens.
+
+Asking several questions in one request also saves time and money. In a TypeSafe [benchmark](https://docs.typesafe.ai/cookbooks/parallel_questions), 13 questions about one document took 0.27 s and cost $0.0005 as a single request, compared with 2.71 s and $0.0061 as 13 separate requests, with the same answers. The node always sends all of an item's questions in one request.
+
+What you give up: Jev can't write, summarize, or explain its answer. When a step needs text, keep an LLM for that step and use Jev for the decisions around it. See [When to use it](#when-to-use-it).
+
+Figures are from TypeSafe's [System One](https://docs.typesafe.ai/concepts/system-one), [Models](https://docs.typesafe.ai/models), and [cascade cookbook](https://docs.typesafe.ai/cookbooks/sde_cascade) pages as of September 2026. Check those pages for current numbers.
+
+## Question types
+
+Every question is one of three types. You can mix them in one request, and they're all answered together.
+
+| Type | Use it to ask | You get back | Example |
+| --- | --- | --- | --- |
+| **Choice** | Which of these options fits? | The chosen option, a probability per option, and a confidence value | *Which team should handle this?* billing / technical / sales |
+| **Score** | Where does this fall on a scale you describe? | A weighted score (it can fall between levels), probabilities, and confidence | *How frustrated is the customer?* calm → frustrated → very angry |
+| **Noul** | Is this statement true? | The probability that the answer is yes, from 0 to 1 | *Does the message contain a card number?* |
+
+**Confidence** is a number from 0 to 1 that Jev calculates from the probabilities. It's high when one answer clearly wins and low when the probabilities are spread out. Choice and Score answers include it; Noul answers are already a probability. See [Confidence](https://docs.typesafe.ai/confidence) in the TypeSafe docs.
+
+## When to use it
+
+**Good fit**
+
+- Classifying, routing, and tagging text: tickets, emails, form submissions, reviews, documents
+- Yes/no checks: does this message contain personal data, is it a complaint, is it on topic
+- Rating text against a rubric you write, such as urgency, sentiment, or lead fit
+- Screening messages before or after an LLM step
+- High volumes, where you need the same answer format every time
+
+**Not a good fit**
+
+- Writing or summarizing text. Use a generative model for that.
+- Arithmetic, counting, or comparing dates. Do those in a Code or IF node.
+- Questions that need several steps of reasoning. Split them into smaller questions.
+- Images, audio, or files. Jev reads text only, so convert other content to text first.
+- Non-English text, unless you've tested it. English is where accuracy is best.
+
+## Use cases
+
+### Route support tickets to the right team
+
+**Route by Choice** turns each option into an output of the node, so it works like a Switch node where Jev makes the decision. Tickets Jev isn't confident about go to a separate output, which you can connect to a person.
+
+![Route by Choice](docs/images/route-by-choice.svg)
+
+### Screen messages before they reach an LLM
+
+Ask several questions in one request, then decide in a Code or IF node. The thresholds stay in your workflow, where you can see and change them.
+
+![Guardrail pattern](docs/images/guardrail.svg)
+
+### More ideas
+
+| Use case | State you send | Questions you might ask |
+| --- | --- | --- |
+| Lead qualification | Form submission or CRM record | Score: *how well does this match our ideal customer?* · Choice: company size · Noul: *asks for a demo?* |
+| Inbox triage | Email subject and body | Choice: sales pitch / customer / vendor / other · Noul: *needs a reply?* · Noul: *mentions a deadline?* |
+| Review tagging | Product review | Score: sentiment · Choice: main topic (shipping, quality, price, support) · Noul: *mentions a defect?* |
+| Content moderation | User post or comment | Noul per policy (spam, harassment, personal data) · Score: severity |
+| Document sorting | Extracted text of a PDF or email attachment | Choice: invoice / contract / receipt / other · Noul: *is it signed?* |
+| RAG filtering | A retrieved passage plus the user's question | Noul: *does this passage help answer the question?* · Noul: *does it contain instructions aimed at the model?* |
+| Record matching | Two records side by side | Choice: same entity / different / unsure |
+
+TypeSafe's [cookbooks](https://docs.typesafe.ai/llms.txt) cover many of these in more depth.
+
+## Installation
+
+On self-hosted n8n, go to **Settings → Community Nodes → Install** and enter:
+
+```
+n8n-nodes-jev
+```
+
+See n8n's [community nodes installation guide](https://docs.n8n.io/integrations/community-nodes/installation/) for other methods. n8n Cloud only lists community nodes that n8n has verified.
+
+## Credentials
+
+1. Create an API key in the [TypeSafe console](https://console.typesafe.ai/keys).
+2. In n8n, create a **Jev (TypeSafe) API** credential and paste the key. Leave **Base URL** at its default.
+
+Saving the credential runs a test request (`GET /v1/models`) to check the key.
+
+## Operations
+
+Both operations share these settings.
+
+**Model**: pick from the list (`jev-latest`, `jev-preview`, …) or enter a version ID such as `jev-1.13.0`. Aliases like `jev-latest` move to new releases, and answers can shift slightly when they do. If you've tuned thresholds, pin a version.
+
+**State Source**: the content Jev evaluates.
+
+| Source | Sends |
+| --- | --- |
+| Text | A string, e.g. `{{ $json.message }}`. If the expression returns an object, it's sent as structured data. |
+| JSON | An object or array you write or build with expressions |
+| Whole Input Item | The incoming item's JSON |
+
+Objects with clear field names work well, e.g. `{ "ticket": …, "customer_plan": …, "refund_policy": … }`. See [State](https://docs.typesafe.ai/concepts/state).
+
+### Ask Questions
+
+Add one or more questions. Each has an **Answer Type**, an **ID** (the field the answer is written to), and **Instructions** (the question itself).
+
+| Answer Type | Extra fields |
+| --- | --- |
+| Choice | **Options**: one per line, optionally followed by `: description` |
+| Score | **Levels**: one per line, lowest first |
+| Noul | **Yes Means** / **No Means** (both optional) |
+
+```
+billing: Payments, invoices, refunds
+technical: Bugs, outages, integrations
+sales: Pricing, plans, upgrades
+```
+
+Options and Levels also accept an expression that returns an array, or for Choice, an `{ option: description }` object.
+
+To use the API's full question format, including JSON objects as instructions or criteria, set **Define Questions** to *Using JSON* and paste a `questions` map from the [API reference](https://docs.typesafe.ai/api).
+
+**Output** (default, with *Simplify Output* on):
+
+```json
+{
+  "message": "I was charged twice for order A-104. Please refund the duplicate.",
+  "jev": {
+    "department": "billing",
+    "department_confidence": 0.93,
+    "frustration": 1.1,
+    "frustration_level": "Frustrated but civil",
+    "frustration_confidence": 0.84,
+    "is_urgent": 0.21,
+    "_model": "jev-1.13.0"
+  }
+}
+```
+
+| Answer Type | Fields written |
+| --- | --- |
+| Choice | `<id>` (the chosen option), `<id>_confidence` |
+| Score | `<id>` (the weighted score), `<id>_level` (the most likely level's text), `<id>_confidence` |
+| Noul | `<id>` (the probability of yes) |
+
+`_model` is the version that answered. Turn off **Simplify Output** to get the full API response, including every probability and token usage.
+
+### Route by Choice
+
+1. **Instructions**: what to decide, e.g. *Which team should handle this ticket?*
+2. **Routes**: at least two. Each route's **Name** becomes an output. **Use When** describes what belongs there. Names can't be expressions, because they define the outputs.
+3. **Low Confidence Handling**:
+   - *Send to Low Confidence Output* (default) adds a last output for items whose confidence is below the **Confidence Threshold** (default 0.5).
+   - *Send to Best Route Anyway* doesn't add the extra output.
+
+Each item leaves through one output and carries:
+
+```json
+"jev": {
+  "route": "technical",
+  "confidence": 0.94,
+  "lowConfidence": false,
+  "probabilities": { "billing": 0.03, "technical": 0.96, "sales": 0.01 },
+  "_model": "jev-1.13.0"
+}
+```
+
+### Options
+
+| Option | Default | Description |
+| --- | --- | --- |
+| Include Input Fields | on | Keep the incoming item's fields next to the answers |
+| Output Field | `jev` | Field the answers are written to |
+| Simplify Output | on | Flat fields instead of the raw response (Ask Questions only) |
+| Max Retries | 3 | Retries when TypeSafe returns `429` (rate limited) or `529` (overloaded), with exponential backoff that honors `retry-after` |
+| Timeout (ms) | 60000 | How long to wait for a response |
+
+### As an AI Agent tool
+
+The node can also be used as a tool: it appears as **Jev Tool** in an AI Agent's tool list. It's useful when you want the agent to get a structured decision, such as a policy check or a classification, instead of reasoning about it in free text.
+
+## Example workflows
+
+Import these from [`examples/`](examples) with **Workflows → Import from File**, then pick your Jev credential on the Jev node.
+
+| Workflow | Shows |
+| --- | --- |
+| [Support ticket triage](examples/support-ticket-triage.json) | Ask Questions with Choice, Score, and Noul together; an IF node escalates urgent or angry tickets |
+| [Route tickets by team](examples/route-tickets-by-team.json) | Route by Choice with three team outputs and a Low Confidence output for human review |
+| [Message guardrail](examples/message-guardrail.json) | JSON questions, the whole input item as state, and a Code node that decides pass, review, or block |
+
+## Writing good questions
+
+Most of this comes from TypeSafe's notes on [known limitations](https://docs.typesafe.ai/model-jaggedness/jev-1.13).
+
+- **One decision per question.** Ask *is it urgent?* and *which team?* separately, not *is it an urgent billing issue?* Extra questions in the same request cost little.
+- **Say exactly what you mean.** Jev reads instructions literally. Put borderline cases in the option descriptions, e.g. `billing: Payments and refunds, including disputed charges`.
+- **Make options that don't overlap,** and add an `other` option when inputs can fall outside your set.
+- **Keep numbers and dates in the workflow.** Ask Jev to find or classify the value, then compare it in an IF or Code node.
+- **Send only what the question needs.** Long state full of unrelated detail lowers accuracy.
+- **Set thresholds by risk.** A wrong route to the sales queue costs little. A wrong refund approval costs more, so gate it at a higher confidence.
+- **Test on your own data** before relying on it, and look at the items that end up in the low-confidence path.
+
+## Limits and costs
+
+- **One API request per input item.** Items are processed one after another. For large batches, use n8n's **Loop Over Items** node to control the pace.
+- **Context:** up to 64k tokens per request, of which the state plus the longest question can use 32k.
+- **Rate limits and pricing** are set by TypeSafe and billed per input token. Check the [Models](https://docs.typesafe.ai/models) page for current numbers. The node retries rate-limited requests automatically.
+- **Text only.** State must be a string, a JSON object, or an array.
+
+## Development
+
+```bash
+npm install
+npm run dev         # starts n8n with this node loaded and rebuilds on change
+npm test            # runs the test suite
+npm run typecheck   # type-checks the node and the tests
+npm run build
+npm run lint
+```
+
+The tests in [`test/`](test) use [Vitest](https://vitest.dev) with a stubbed n8n context and a fake API, so they need no API key or running n8n. They cover question building, output flattening, routing, retries, error handling, and the example workflows. Test files use the `.mts` extension so n8n's node linter, which applies n8n Cloud's runtime rules to `.ts` files, doesn't treat them as node code.
+
+`npm run dev` needs Node.js 24 or newer, because it runs the latest n8n. In dev mode n8n registers the node as `CUSTOM.jev` instead of `n8n-nodes-jev.jev`. To import the example workflows into a dev instance, change the node type first:
+
+```bash
+sed 's/"n8n-nodes-jev\.jev"/"CUSTOM.jev"/' examples/route-tickets-by-team.json > /tmp/route-dev.json
+```
+
+### Releasing
+
+Releases are published to npm by the [Publish workflow](.github/workflows/publish.yml) when a version tag is pushed. n8n requires community nodes to be published this way, with npm provenance, to be eligible for verification. Don't run `npm publish` from your machine.
+
+1. Move the entries under **Unreleased** in [CHANGELOG.md](CHANGELOG.md) to a new version heading and commit.
+2. Bump the version. This commits the change and creates a tag such as `v0.3.0`:
+
+   ```bash
+   npm version minor -m "chore: release %s"
+   ```
+
+3. Push the commit and the tag:
+
+   ```bash
+   git push --follow-tags
+   ```
+
+The workflow checks that the tag matches `package.json`, runs the type-check and tests, then lints, builds, and publishes.
+
+Use `npm version` rather than `npm run release`: n8n's release command regenerates CHANGELOG.md from commit messages, which replaces the hand-written entries.
+
+**One-time npm setup.** The first publish needs an npm access token saved as the `NPM_TOKEN` repository secret. Once the package exists on npm, add this repository as a [Trusted Publisher](https://docs.npmjs.com/trusted-publishers) in the package settings (workflow `publish.yml`) and delete the secret. The workflow file lists the exact steps.
+
+## Links
+
+- [TypeSafe documentation](https://docs.typesafe.ai) and [API reference](https://docs.typesafe.ai/api)
+- [n8n community nodes](https://docs.n8n.io/integrations/#community-nodes)
+- [Changelog](CHANGELOG.md)
+
+## License
+
+[MIT](LICENSE.md). This community node is maintained by Brains of Bots. Jev and the TypeSafe API are provided by TypeSafe.

package/dist/credentials/JevApi.credentials.d.ts

@@ -0,0 +1,10 @@
+import type { IAuthenticateGeneric, Icon, ICredentialTestRequest, ICredentialType, INodeProperties } from 'n8n-workflow';
+export declare class JevApi implements ICredentialType {
+    name: string;
+    displayName: string;
+    icon: Icon;
+    documentationUrl: string;
+    properties: INodeProperties[];
+    authenticate: IAuthenticateGeneric;
+    test: ICredentialTestRequest;
+}

package/dist/credentials/JevApi.credentials.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JevApi = void 0;
+class JevApi {
+    constructor() {
+        this.name = 'jevApi';
+        this.displayName = 'Jev (TypeSafe) API';
+        this.icon = { light: 'file:../icons/jev.svg', dark: 'file:../icons/jev.dark.svg' };
+        this.documentationUrl = 'https://docs.typesafe.ai/introduction/quickstart';
+        this.properties = [
+            {
+                displayName: 'API Key',
+                name: 'apiKey',
+                type: 'string',
+                typeOptions: { password: true },
+                default: '',
+                required: true,
+                description: 'Create a key at https://console.typesafe.ai/keys',
+            },
+            {
+                displayName: 'Base URL',
+                name: 'baseUrl',
+                type: 'string',
+                default: 'https://api.typesafe.ai',
+                description: 'Only change this if TypeSafe has given you a different API host',
+            },
+        ];
+        this.authenticate = {
+            type: 'generic',
+            properties: {
+                headers: {
+                    Authorization: '=Bearer {{$credentials.apiKey}}',
+                },
+            },
+        };
+        this.test = {
+            request: {
+                baseURL: '={{$credentials.baseUrl.replace(/\\/+$/, "")}}',
+                url: '/v1/models',
+                method: 'GET',
+            },
+        };
+    }
+}
+exports.JevApi = JevApi;
+//# sourceMappingURL=JevApi.credentials.js.map

package/dist/credentials/JevApi.credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"JevApi.credentials.js","sourceRoot":"","sources":["../../credentials/JevApi.credentials.ts"],"names":[],"mappings":";;;AAQA,MAAa,MAAM;IAAnB;QACC,SAAI,GAAG,QAAQ,CAAC;QAEhB,gBAAW,GAAG,oBAAoB,CAAC;QAEnC,SAAI,GAAS,EAAE,KAAK,EAAE,uBAAuB,EAAE,IAAI,EAAE,4BAA4B,EAAE,CAAC;QAEpF,qBAAgB,GAAG,kDAAkD,CAAC;QAEtE,eAAU,GAAsB;YAC/B;gBACC,WAAW,EAAE,SAAS;gBACtB,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;gBAC/B,OAAO,EAAE,EAAE;gBACX,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,kDAAkD;aAC/D;YACD;gBACC,WAAW,EAAE,UAAU;gBACvB,IAAI,EAAE,SAAS;gBACf,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,yBAAyB;gBAClC,WAAW,EAAE,iEAAiE;aAC9E;SACD,CAAC;QAEF,iBAAY,GAAyB;YACpC,IAAI,EAAE,SAAS;YACf,UAAU,EAAE;gBACX,OAAO,EAAE;oBACR,aAAa,EAAE,iCAAiC;iBAChD;aACD;SACD,CAAC;QAEF,SAAI,GAA2B;YAC9B,OAAO,EAAE;gBACR,OAAO,EAAE,gDAAgD;gBACzD,GAAG,EAAE,YAAY;gBACjB,MAAM,EAAE,KAAK;aACb;SACD,CAAC;IACH,CAAC;CAAA;AA5CD,wBA4CC"}

package/dist/icons/jev.dark.svg

@@ -0,0 +1,7 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="60" height="60" viewBox="0 0 60 60" fill="none">
+	<rect x="2" y="2" width="56" height="56" rx="14" fill="#5C7CFA"/>
+	<circle cx="16" cy="30" r="5" fill="#FFFFFF"/>
+	<path d="M21 30 H28 M28 30 C33 30 34 18 42 18 M28 30 C33 30 34 42 42 42" stroke="#FFFFFF" stroke-width="3.5" stroke-linecap="round" fill="none"/>
+	<circle cx="45" cy="18" r="4" fill="#A5D8FF"/>
+	<circle cx="45" cy="42" r="4" fill="#FFFFFF"/>
+</svg>

package/dist/icons/jev.svg

@@ -0,0 +1,7 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="60" height="60" viewBox="0 0 60 60" fill="none">
+	<rect x="2" y="2" width="56" height="56" rx="14" fill="#3B5BDB"/>
+	<circle cx="16" cy="30" r="5" fill="#FFFFFF"/>
+	<path d="M21 30 H28 M28 30 C33 30 34 18 42 18 M28 30 C33 30 34 42 42 42" stroke="#FFFFFF" stroke-width="3.5" stroke-linecap="round" fill="none"/>
+	<circle cx="45" cy="18" r="4" fill="#A5D8FF"/>
+	<circle cx="45" cy="42" r="4" fill="#FFFFFF"/>
+</svg>

package/dist/nodes/Jev/Jev.node.d.ts

@@ -0,0 +1,11 @@
+import type { IExecuteFunctions, INodeExecutionData, INodeType, INodeTypeDescription } from 'n8n-workflow';
+import { searchModels } from './listSearch/searchModels';
+export declare class Jev implements INodeType {
+    description: INodeTypeDescription;
+    methods: {
+        listSearch: {
+            searchModels: typeof searchModels;
+        };
+    };
+    execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]>;
+}

package/dist/nodes/Jev/Jev.node.js

@@ -0,0 +1,155 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Jev = void 0;
+const n8n_workflow_1 = require("n8n-workflow");
+const searchModels_1 = require("./listSearch/searchModels");
+const descriptions_1 = require("./shared/descriptions");
+const questions_1 = require("./shared/questions");
+const route_1 = require("./shared/route");
+const transport_1 = require("./shared/transport");
+function parseJsonParameter(value, label, itemIndex) {
+    if (typeof value !== 'string')
+        return value;
+    try {
+        return (0, n8n_workflow_1.jsonParse)(value);
+    }
+    catch {
+        throw new n8n_workflow_1.NodeOperationError(this.getNode(), `${label} is not valid JSON`, { itemIndex });
+    }
+}
+class Jev {
+    constructor() {
+        this.description = {
+            displayName: 'Jev',
+            name: 'jev',
+            icon: { light: 'file:../../icons/jev.svg', dark: 'file:../../icons/jev.dark.svg' },
+            group: ['transform'],
+            version: 1,
+            subtitle: '={{ $parameter["model"].cachedResultName || $parameter["model"].value }}',
+            description: "Ask TypeSafe's Jev model typed questions, or route items by its choice, with calibrated confidence",
+            defaults: {
+                name: 'Jev',
+            },
+            usableAsTool: true,
+            inputs: [n8n_workflow_1.NodeConnectionTypes.Main],
+            outputs: `={{(${route_1.configuredOutputs})($parameter)}}`,
+            credentials: [
+                {
+                    name: 'jevApi',
+                    required: true,
+                },
+            ],
+            properties: [
+                descriptions_1.operationProperty,
+                descriptions_1.modelProperty,
+                ...descriptions_1.stateProperties,
+                ...descriptions_1.questionProperties,
+                ...descriptions_1.routeProperties,
+                descriptions_1.optionsProperty,
+            ],
+        };
+        this.methods = {
+            listSearch: {
+                searchModels: searchModels_1.searchModels,
+            },
+        };
+    }
+    async execute() {
+        var _a;
+        const items = this.getInputData();
+        const operation = this.getNodeParameter('operation', 0);
+        const routeFields = operation === 'route' ? this.getNodeParameter('routes.values', 0, []) : [];
+        const routeNames = routeFields.map((route) => { var _a; return ((_a = route.name) !== null && _a !== void 0 ? _a : '').trim(); });
+        const lowConfidenceOutput = operation === 'route' && this.getNodeParameter('lowConfidence', 0) !== 'bestRoute';
+        const outputCount = operation === 'route' ? routeNames.length + (lowConfidenceOutput ? 1 : 0) : 1;
+        const returnData = Array.from({ length: Math.max(outputCount, 1) }, () => []);
+        for (let itemIndex = 0; itemIndex < items.length; itemIndex++) {
+            try {
+                const model = this.getNodeParameter('model', itemIndex, '', {
+                    extractValue: true,
+                });
+                if (!model) {
+                    throw new n8n_workflow_1.NodeOperationError(this.getNode(), 'Select a model', { itemIndex });
+                }
+                const state = getState.call(this, itemIndex, items[itemIndex]);
+                const options = this.getNodeParameter('options', itemIndex, {});
+                const questions = operation === 'route'
+                    ? {
+                        [route_1.ROUTE_QUESTION_ID]: (0, route_1.buildRouteQuestion)(this.getNodeParameter('routeInstructions', itemIndex, ''), routeFields),
+                    }
+                    : getQuestions.call(this, itemIndex);
+                const response = await transport_1.jevApiRequest.call(this, 'POST', '/v1/systemone', { state, model, questions }, { maxRetries: options.maxRetries, timeout: options.timeout, itemIndex });
+                let outputIndex = 0;
+                let result;
+                if (operation === 'route') {
+                    const threshold = lowConfidenceOutput
+                        ? this.getNodeParameter('confidenceThreshold', itemIndex, 0.5)
+                        : 0;
+                    const decision = (0, route_1.decideRoute)(response, routeNames, lowConfidenceOutput, threshold);
+                    outputIndex = decision.outputIndex;
+                    result = decision.result;
+                }
+                else {
+                    result = options.simplify === false ? response : (0, questions_1.simplifyResponse)(response);
+                }
+                const outputField = ((_a = options.outputField) === null || _a === void 0 ? void 0 : _a.trim()) || 'jev';
+                const includeInput = options.includeInputFields !== false;
+                returnData[outputIndex].push({
+                    json: includeInput
+                        ? { ...items[itemIndex].json, [outputField]: result }
+                        : { [outputField]: result },
+                    binary: includeInput ? items[itemIndex].binary : undefined,
+                    pairedItem: { item: itemIndex },
+                });
+            }
+            catch (error) {
+                const nodeError = error instanceof questions_1.QuestionDefinitionError
+                    ? new n8n_workflow_1.NodeOperationError(this.getNode(), error.message, { itemIndex })
+                    : error;
+                if (this.continueOnFail()) {
+                    returnData[0].push({
+                        json: { ...items[itemIndex].json, error: nodeError.message },
+                        pairedItem: { item: itemIndex },
+                    });
+                    continue;
+                }
+                if (nodeError.context)
+                    nodeError.context.itemIndex = itemIndex;
+                throw nodeError;
+            }
+        }
+        return returnData;
+    }
+}
+exports.Jev = Jev;
+function getState(itemIndex, item) {
+    const source = this.getNodeParameter('stateSource', itemIndex);
+    if (source === 'inputItem')
+        return item.json;
+    if (source === 'json') {
+        const state = parseJsonParameter.call(this, this.getNodeParameter('stateJson', itemIndex), 'State (JSON)', itemIndex);
+        if (state === null || typeof state !== 'object') {
+            throw new n8n_workflow_1.NodeOperationError(this.getNode(), 'State (JSON) must be a JSON object or array', {
+                itemIndex,
+            });
+        }
+        return state;
+    }
+    const text = this.getNodeParameter('stateText', itemIndex, '');
+    if (text !== null && typeof text === 'object')
+        return text;
+    const state = String(text !== null && text !== void 0 ? text : '');
+    if (!state.trim())
+        throw new n8n_workflow_1.NodeOperationError(this.getNode(), 'State is empty', { itemIndex });
+    return state;
+}
+function getQuestions(itemIndex) {
+    const mode = this.getNodeParameter('questionMode', itemIndex);
+    if (mode === 'json') {
+        const value = parseJsonParameter.call(this, this.getNodeParameter('questionsJson', itemIndex), 'Questions (JSON)', itemIndex);
+        return (0, questions_1.validateQuestionsJson)(value);
+    }
+    const fields = this.getNodeParameter('questions.question', itemIndex, []);
+    return (0, questions_1.buildQuestionsFromFields)(fields);
+}
+//# sourceMappingURL=Jev.node.js.map

package/dist/nodes/Jev/Jev.node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Jev.node.js","sourceRoot":"","sources":["../../../nodes/Jev/Jev.node.ts"],"names":[],"mappings":"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"}

package/dist/nodes/Jev/Jev.node.json

@@ -0,0 +1,18 @@
+{
+    "node": "n8n-nodes-jev.jev",
+    "nodeVersion": "1.0",
+    "codexVersion": "1.0",
+    "categories": ["AI", "Development"],
+    "resources": {
+        "credentialDocumentation": [
+            {
+                "url": "https://github.com/vibe-with-me-tools/n8n-nodes-jev#credentials"
+            }
+        ],
+        "primaryDocumentation": [
+            {
+                "url": "https://github.com/vibe-with-me-tools/n8n-nodes-jev#readme"
+            }
+        ]
+    }
+}

package/dist/nodes/Jev/listSearch/searchModels.d.ts

@@ -0,0 +1,2 @@
+import type { ILoadOptionsFunctions, INodeListSearchResult } from 'n8n-workflow';
+export declare function searchModels(this: ILoadOptionsFunctions, filter?: string): Promise<INodeListSearchResult>;

package/dist/nodes/Jev/listSearch/searchModels.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.searchModels = searchModels;
+const transport_1 = require("../shared/transport");
+async function searchModels(filter) {
+    var _a;
+    const response = await transport_1.jevApiRequest.call(this, 'GET', '/v1/models');
+    const models = ((_a = response.models) !== null && _a !== void 0 ? _a : []);
+    const query = filter === null || filter === void 0 ? void 0 : filter.toLowerCase();
+    return {
+        results: models
+            .map((model) => ({
+            name: String(model.name),
+            value: String(model.name),
+            description: [model.description, model.release_date].filter(Boolean).join(' · '),
+        }))
+            .filter((model) => !query || model.name.toLowerCase().includes(query)),
+    };
+}
+//# sourceMappingURL=searchModels.js.map

package/dist/nodes/Jev/listSearch/searchModels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"searchModels.js","sourceRoot":"","sources":["../../../../nodes/Jev/listSearch/searchModels.ts"],"names":[],"mappings":";;AAGA,oCAiBC;AAnBD,mDAAoD;AAE7C,KAAK,UAAU,YAAY,CAEjC,MAAe;;IAEf,MAAM,QAAQ,GAAG,MAAM,yBAAa,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC;IACrE,MAAM,MAAM,GAAG,CAAC,MAAA,QAAQ,CAAC,MAAM,mCAAI,EAAE,CAAkB,CAAC;IACxD,MAAM,KAAK,GAAG,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,WAAW,EAAE,CAAC;IAEpC,OAAO;QACN,OAAO,EAAE,MAAM;aACb,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YAChB,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;YACxB,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;YACzB,WAAW,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC;SAChF,CAAC,CAAC;aACF,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;KACvE,CAAC;AACH,CAAC"}

package/dist/nodes/Jev/shared/descriptions.d.ts

@@ -0,0 +1,7 @@
+import type { INodeProperties } from 'n8n-workflow';
+export declare const operationProperty: INodeProperties;
+export declare const modelProperty: INodeProperties;
+export declare const stateProperties: INodeProperties[];
+export declare const questionProperties: INodeProperties[];
+export declare const optionsProperty: INodeProperties;
+export declare const routeProperties: INodeProperties[];