ff1-cli 1.0.1 → 1.0.2

package/README.md

@@ -10,6 +10,14 @@ FF1-CLI turns a simple prompt into a DP-1–conformant playlist you can preview
 npm i -g ff1-cli
 ```
 
+## Install (curl)
+
+```bash
+curl -fsSL https://feralfile.com/ff1-cli-install | bash
+```
+
+Installs a prebuilt binary for macOS/Linux (no Node.js required).
+
 ## One-off Usage (npx)
 
 ```bash

package/config.json.example

@@ -54,7 +54,7 @@
   },
   "feedServers": [
     {
-      "baseUrl": "https://feed.feralfile.com/api/v1",
+      "baseUrl": "https://dp1-feed-operator-api-prod.autonomy-system.workers.dev/api/v1",
       "apiKey": "YOUR_FEED_SERVER_API_KEY_OPTIONAL"
     },
     {

package/dist/index.js

@@ -37,7 +37,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-// Suppress punycode deprecation warning from jsdom dependency
+// Suppress punycode deprecation warnings from dependencies
 process.removeAllListeners('warning');
 process.on('warning', (warning) => {
     if (warning.name === 'DeprecationWarning' && warning.message.includes('punycode')) {
@@ -51,8 +51,22 @@ const chalk_1 = __importDefault(require("chalk"));
 const fs_1 = require("fs");
 const crypto_1 = __importDefault(require("crypto"));
 const readline = __importStar(require("readline"));
+const fs_2 = require("fs");
+const path_1 = require("path");
 const config_1 = require("./src/config");
 const main_1 = require("./src/main");
+// Load version from package.json
+// Try built location first (dist/index.js -> ../package.json)
+// Fall back to dev location (index.ts -> ./package.json)
+let packageJsonPath = (0, path_1.resolve)((0, path_1.dirname)(__filename), '..', 'package.json');
+try {
+    (0, fs_2.readFileSync)(packageJsonPath, 'utf8');
+}
+catch {
+    // Dev mode: tsx runs from project root
+    packageJsonPath = (0, path_1.resolve)((0, path_1.dirname)(__filename), 'package.json');
+}
+const { version: packageVersion } = JSON.parse((0, fs_2.readFileSync)(packageJsonPath, 'utf8'));
 const program = new commander_1.Command();
 const placeholderPattern = /YOUR_|your_/;
 /**
@@ -130,7 +144,7 @@ async function promptYesNo(ask, question, defaultYes = true) {
 program
     .name('ff1')
     .description('CLI to fetch NFT information and build DP1 playlists using AI (Grok, ChatGPT, Gemini)')
-    .version('1.0.1')
+    .version(packageVersion)
     .addHelpText('after', `\nQuick start:\n  1) ff1 setup\n  2) ff1 chat\n\nDocs: https://github.com/feralfile/ff1-cli\n`);
 program
     .command('setup')

package/dist/src/config.js

@@ -49,7 +49,7 @@ function loadConfig() {
                 maxTokens: parseInt(process.env.MAX_TOKENS || '4000', 10),
                 supportsFunctionCalling: true,
             },
-            gpt: {
+            chatgpt: {
                 apiKey: process.env.OPENAI_API_KEY || '',
                 baseURL: 'https://api.openai.com/v1',
                 model: 'gpt-4o',
@@ -80,7 +80,7 @@ function loadConfig() {
         feed: {
             baseURLs: process.env.FEED_BASE_URLS
                 ? process.env.FEED_BASE_URLS.split(',')
-                : ['https://feed.feralfile.com/api/v1'],
+                : ['https://dp1-feed-operator-api-prod.autonomy-system.workers.dev/api/v1'],
         },
     };
     // Try to load config.json if it exists
@@ -202,7 +202,7 @@ function getFeedConfig() {
     }
     else {
         // Default feed URL
-        urls = ['https://feed.feralfile.com/api/v1'];
+        urls = ['https://dp1-feed-operator-api-prod.autonomy-system.workers.dev/api/v1'];
     }
     return {
         baseURLs: urls,
@@ -241,24 +241,9 @@ function getFF1DeviceConfig() {
  * @returns {boolean} returns.supportsFunctionCalling - Whether model supports function calling
  * @throws {Error} If model is not configured or doesn't support function calling
  */
-function resolveModelName(config, modelName) {
-    const selectedModel = modelName || config.defaultModel;
-    if (config.models[selectedModel]) {
-        return selectedModel;
-    }
-    const aliasMap = {
-        gpt: 'chatgpt',
-        chatgpt: 'gpt',
-    };
-    const alias = aliasMap[selectedModel];
-    if (alias && config.models[alias]) {
-        return alias;
-    }
-    return selectedModel;
-}
 function getModelConfig(modelName) {
     const config = getConfig();
-    const selectedModel = resolveModelName(config, modelName);
+    const selectedModel = modelName || config.defaultModel;
     if (!config.models[selectedModel]) {
         throw new Error(`Model "${selectedModel}" is not configured. Available models: ${Object.keys(config.models).join(', ')}`);
     }
@@ -285,7 +270,7 @@ function validateConfig(modelName) {
     const errors = [];
     try {
         const config = getConfig();
-        const selectedModel = resolveModelName(config, modelName);
+        const selectedModel = modelName || config.defaultModel;
         if (!config.models[selectedModel]) {
             errors.push(`Model "${selectedModel}" is not configured. Available: ${Object.keys(config.models).join(', ')}`);
             return { valid: false, errors };
@@ -377,12 +362,5 @@ async function createSampleConfig(targetPath) {
  */
 function listAvailableModels() {
     const config = getConfig();
-    const modelNames = new Set(Object.keys(config.models));
-    if (modelNames.has('gpt')) {
-        modelNames.add('chatgpt');
-    }
-    if (modelNames.has('chatgpt')) {
-        modelNames.add('gpt');
-    }
-    return Array.from(modelNames);
+    return Object.keys(config.models);
 }

package/dist/src/intent-parser/index.js

@@ -210,7 +210,7 @@ PUBLISH INTENT (CRITICAL)
     2. If only 1 server → use it directly in playlistSettings.feedServer
     3. If 2+ servers → ask user "Which feed server?" with numbered list (e.g., "1) https://feed.feralfile.com 2) http://localhost:8787")
     4. After selection, set playlistSettings.feedServer = { baseUrl, apiKey } from selected server
-    5. Acknowledge in Settings bullets (e.g., "publish to: https://feed.feralfile.com/api/v1")
+    5. Acknowledge in Settings bullets (e.g., "publish to: https://dp1-feed-operator-api-prod.autonomy-system.workers.dev/api/v1")
   - User can request both device display AND publishing (e.g., "send to FF1 and publish to feed") → set both deviceName and feedServer
   - Publishing happens automatically after playlist verification passes
   
@@ -493,20 +493,6 @@ function printMarkdownContent(content) {
 function sleep(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));
 }
-function buildToolResponseMessages(toolCalls, responses) {
-    return toolCalls
-        .filter((toolCall) => toolCall.id)
-        .map((toolCall) => {
-        const content = toolCall.id && Object.prototype.hasOwnProperty.call(responses, toolCall.id)
-            ? responses[toolCall.id]
-            : { error: `Unknown function: ${toolCall.function.name}` };
-        return {
-            role: 'tool',
-            tool_call_id: toolCall.id,
-            content: JSON.stringify(content),
-        };
-    });
-}
 async function processNonStreamingResponse(response) {
     const message = response.choices[0]?.message;
     if (!message) {
@@ -705,10 +691,13 @@ async function processIntentParserRequest(userRequest, options = {}) {
                 // Get the list of configured devices
                 const { getConfiguredDevices } = await Promise.resolve().then(() => __importStar(require('../utilities/functions')));
                 const result = await getConfiguredDevices();
-                const toolResultMessages = buildToolResponseMessages(message.tool_calls, {
-                    [toolCall.id]: result,
-                });
-                const updatedMessages = [...messages, message, ...toolResultMessages];
+                // Add tool result to messages and continue conversation
+                const toolResultMessage = {
+                    role: 'tool',
+                    tool_call_id: toolCall.id,
+                    content: JSON.stringify(result),
+                };
+                const updatedMessages = [...messages, message, toolResultMessage];
                 // Continue the conversation with the device list
                 const followUpRequest = {
                     model: modelConfig.model,
@@ -752,13 +741,16 @@ async function processIntentParserRequest(userRequest, options = {}) {
                             apiKey: server.apiKey,
                         })) ||
                             feedConfig.baseURLs.map((url) => ({ baseUrl: url, apiKey: feedConfig.apiKey }));
-                        const feedToolResultMessages = buildToolResponseMessages(followUpMessage.tool_calls, {
-                            [followUpToolCall.id]: { servers: serverList },
-                        });
+                        // Add tool result to messages and continue conversation
+                        const feedToolResultMessage = {
+                            role: 'tool',
+                            tool_call_id: followUpToolCall.id,
+                            content: JSON.stringify({ servers: serverList }),
+                        };
                         const feedUpdatedMessages = [
                             ...updatedMessages,
                             followUpMessage,
-                            ...feedToolResultMessages,
+                            feedToolResultMessage,
                         ];
                         // Continue the conversation with the feed server list
                         const feedFollowUpRequest = {
@@ -894,8 +886,15 @@ async function processIntentParserRequest(userRequest, options = {}) {
                         }
                     }
                     else {
-                        const toolResultMessages = buildToolResponseMessages(followUpMessage.tool_calls, {});
-                        const validMessages = [...updatedMessages, followUpMessage, ...toolResultMessages];
+                        // Unhandled tool call - add assistant message and tool response to messages
+                        const toolResultMessage = {
+                            role: 'tool',
+                            tool_call_id: followUpToolCall.id,
+                            content: JSON.stringify({
+                                error: `Unknown function: ${followUpToolCall.function.name}`,
+                            }),
+                        };
+                        const validMessages = [...updatedMessages, followUpMessage, toolResultMessage];
                         // AI is still asking for more information after the error
                         return {
                             approved: false,
@@ -922,10 +921,13 @@ async function processIntentParserRequest(userRequest, options = {}) {
                     baseUrl: server.baseUrl,
                     apiKey: server.apiKey,
                 })) || feedConfig.baseURLs.map((url) => ({ baseUrl: url, apiKey: feedConfig.apiKey }));
-                const toolResultMessages = buildToolResponseMessages(message.tool_calls, {
-                    [toolCall.id]: { servers: serverList },
-                });
-                const updatedMessages = [...messages, message, ...toolResultMessages];
+                // Add tool result to messages and continue conversation
+                const toolResultMessage = {
+                    role: 'tool',
+                    tool_call_id: toolCall.id,
+                    content: JSON.stringify({ servers: serverList }),
+                };
+                const updatedMessages = [...messages, message, toolResultMessage];
                 // Continue the conversation with the feed server list
                 const followUpRequest = {
                     model: modelConfig.model,
@@ -1029,14 +1031,17 @@ async function processIntentParserRequest(userRequest, options = {}) {
                 // Validate and confirm the playlist
                 const confirmation = await confirmPlaylistForSending(args.filePath, args.deviceName);
                 if (!confirmation.success) {
-                    const toolResultMessages = buildToolResponseMessages(message.tool_calls, {
-                        [toolCall.id]: {
+                    // Add tool response message to make conversation valid
+                    const toolResultMessage = {
+                        role: 'tool',
+                        tool_call_id: toolCall.id,
+                        content: JSON.stringify({
                             success: false,
                             error: confirmation.error,
                             message: confirmation.message,
-                        },
-                    });
-                    const validMessages = [...messages, message, ...toolResultMessages];
+                        }),
+                    };
+                    const validMessages = [...messages, message, toolResultMessage];
                     // Check if this is a device selection needed case
                     if (confirmation.needsDeviceSelection) {
                         // Multiple devices available - ask user to choose
@@ -1120,14 +1125,17 @@ async function processIntentParserRequest(userRequest, options = {}) {
                 const { verifyAddresses } = await Promise.resolve().then(() => __importStar(require('../utilities/functions')));
                 const verificationResult = await verifyAddresses({ addresses: args.addresses });
                 if (!verificationResult.valid) {
-                    const toolResultMessages = buildToolResponseMessages(message.tool_calls, {
-                        [toolCall.id]: {
+                    // Add tool response message for invalid addresses
+                    const toolResultMessage = {
+                        role: 'tool',
+                        tool_call_id: toolCall.id,
+                        content: JSON.stringify({
                             valid: false,
                             errors: verificationResult.errors,
                             results: verificationResult.results,
-                        },
-                    });
-                    const validMessages = [...messages, message, ...toolResultMessages];
+                        }),
+                    };
+                    const validMessages = [...messages, message, toolResultMessage];
                     // Ask user to correct the addresses
                     return {
                         approved: false,
@@ -1136,13 +1144,16 @@ async function processIntentParserRequest(userRequest, options = {}) {
                         messages: validMessages,
                     };
                 }
-                const toolResultMessages = buildToolResponseMessages(message.tool_calls, {
-                    [toolCall.id]: {
+                // All addresses are valid - continue to next step
+                const toolResultMessage = {
+                    role: 'tool',
+                    tool_call_id: toolCall.id,
+                    content: JSON.stringify({
                         valid: true,
                         results: verificationResult.results,
-                    },
-                });
-                const validMessages = [...messages, message, ...toolResultMessages];
+                    }),
+                };
+                const validMessages = [...messages, message, toolResultMessage];
                 // Continue conversation after validation
                 const followUpRequest = {
                     model: modelConfig.model,
@@ -1187,14 +1198,12 @@ async function processIntentParserRequest(userRequest, options = {}) {
                         })) ||
                             feedConfig.baseURLs.map((url) => ({ baseUrl: url, apiKey: feedConfig.apiKey }));
                         // Add tool result to messages and continue conversation
-                        const feedToolResultMessages = buildToolResponseMessages(followUpMessage.tool_calls, {
-                            [followUpToolCall.id]: { servers: serverList },
-                        });
-                        const feedUpdatedMessages = [
-                            ...validMessages,
-                            followUpMessage,
-                            ...feedToolResultMessages,
-                        ];
+                        const feedToolResultMessage = {
+                            role: 'tool',
+                            tool_call_id: followUpToolCall.id,
+                            content: JSON.stringify({ servers: serverList }),
+                        };
+                        const feedUpdatedMessages = [...validMessages, followUpMessage, feedToolResultMessage];
                         // Continue the conversation with the feed server list
                         const feedFollowUpRequest = {
                             model: modelConfig.model,
@@ -1299,8 +1308,15 @@ async function processIntentParserRequest(userRequest, options = {}) {
                 };
             }
             else {
-                const toolResultMessages = buildToolResponseMessages(message.tool_calls, {});
-                const validMessages = [...messages, message, ...toolResultMessages];
+                // Unhandled tool call at top level
+                const toolResultMessage = {
+                    role: 'tool',
+                    tool_call_id: toolCall.id,
+                    content: JSON.stringify({
+                        error: `Unknown function: ${toolCall.function.name}`,
+                    }),
+                };
+                const validMessages = [...messages, message, toolResultMessage];
                 return {
                     approved: false,
                     needsMoreInfo: true,

package/docs/CONFIGURATION.md

@@ -94,7 +94,7 @@ DP‑1 Feed API configuration.
 
 - `feed.baseURLs` (string[]): Array of DP‑1 Feed Operator API v1 base URLs. The CLI queries all feeds in parallel.
 - Legacy support: `feed.baseURL` (string) is still accepted and normalized to an array.
-- Default: `https://feed.feralfile.com/api/v1` if not set.
+- Default: `https://dp1-feed-operator-api-prod.autonomy-system.workers.dev/api/v1` if not set.
 - Compatibility: API v1 of the DP‑1 Feed Operator server. See the repository for endpoints and behavior: [dp1-feed](https://github.com/display-protocol/dp1-feed).
 
 Endpoints used by the CLI:
@@ -105,7 +105,7 @@ Endpoints used by the CLI:
 Environment variable alternative:
 
 ```env
-FEED_BASE_URLS=https://feed.feralfile.com/api/v1,https://dp1-feed-operator-api-prod.autonomy-system.workers.dev/api/v1
+FEED_BASE_URLS=https://dp1-feed-operator-api-prod.autonomy-system.workers.dev/api/v1,https://dp1-feed-operator-api-prod.autonomy-system.workers.dev/api/v1
 ```
 
 ## ff1Devices
@@ -150,7 +150,7 @@ Minimal `config.json` example (selected fields):
   },
   "feed": {
     "baseURLs": [
-      "https://feed.feralfile.com/api/v1"
+      "https://dp1-feed-operator-api-prod.autonomy-system.workers.dev/api/v1"
     ]
   },
   "ff1Devices": {

package/docs/EXAMPLES.md

@@ -23,7 +23,7 @@ npm run dev -- chat "Get 3 items from Social Codes and 2 from 0xdef" -v
 
 # Switch model
 npm run dev -- chat "your request" --model grok
-npm run dev -- chat "your request" --model gpt
+npm run dev -- chat "your request" --model chatgpt
 npm run dev -- chat "your request" --model gemini
 ```
 
@@ -44,7 +44,7 @@ cat examples/params-example.json | npm run dev -- build -o playlist.json
 npm run dev -- chat "Build a playlist of my Tezos works from address tz1... plus 3 from Social Codes" -v -o playlist.json
 
 # Switch model if desired
-npm run dev -- chat "Build playlist from Ethereum address 0x... and 2 from Social Codes" --model gpt -v
+npm run dev -- chat "Build playlist from Ethereum address 0x... and 2 from Social Codes" --model chatgpt -v
 ```
 
 ### One‑shot complex prompt
@@ -67,7 +67,7 @@ The CLI recognizes publishing keywords like "publish", "publish to my feed", "pu
 npm run dev -- chat "Build playlist from Ethereum contract 0xb932a70A57673d89f4acfFBE830E8ed7f75Fb9e0 with tokens 52932 and 52457; publish to my feed" -o playlist.json -v
 
 # With feed selection (if multiple servers configured)
-# The CLI will ask: "Which feed server? 1) https://feed.feralfile.com/api/v1 2) http://localhost:8787"
+# The CLI will ask: "Which feed server? 1) https://dp1-feed-operator-api-prod.autonomy-system.workers.dev/api/v1 2) http://localhost:8787"
 npm run dev -- chat "Get 3 from Social Codes and publish to feed" -v
 
 # Publish existing playlist (defaults to ./playlist.json)
@@ -92,21 +92,18 @@ npm run dev -- chat "Get 5 from Social Codes, shuffle, display on 'Living Room',
 ### How It Works
 
 **Mode 1: Build and Publish** (when sources are mentioned)
-
 1. Intent parser detects "publish" keywords with sources/requirements
 2. Calls `get_feed_servers` to retrieve configured servers
 3. If 1 server → uses it automatically; if 2+ servers → asks user to pick
 4. Builds playlist → verifies → publishes automatically
 
 **Mode 2: Publish Existing File** (e.g., "publish playlist")
-
 1. Intent parser detects "publish playlist" or similar phrases
 2. Calls `get_feed_servers` to retrieve configured servers
 3. If 1 server → uses it automatically; if 2+ servers → asks user to pick
 4. Publishes the playlist from `./playlist.json` (or specified path)
 
 Output shows:
-
 - Playlist build progress (Mode 1 only)
 - Device sending (if requested): `✓ Sent to device: Living Room`
 - Publishing status: `✓ Published to feed server`
@@ -190,21 +187,18 @@ Select server (0-based index): 0
 ### Error Handling
 
 **Validation failed:**
-
 ```
 ❌ Failed to publish playlist
    Playlist validation failed: dpVersion: Required; id: Required
 ```
 
 **File not found:**
-
 ```
 ❌ Failed to publish playlist
    Playlist file not found: /path/to/playlist.json
 ```
 
 **API error:**
-
 ```
 ❌ Failed to publish playlist
    Failed to publish: {"error":"unauthorized","message":"Invalid API key"}
@@ -239,6 +233,7 @@ npm run dev -- config show
 npm run dev -- config init
 ```
 
+
 ### Natural‑language one‑shot examples (proven)
 
 - **ETH contract + token IDs (shuffle/mix, generic device)**
@@ -333,4 +328,4 @@ npm run dev -- config init
     ```bash
     npm run dev -- chat "Compose a playlist from reas.eth (3 items); send to device" -o playlist-generic-device.json -v
     npm run dev -- chat "Compose a playlist from reas.eth (3 items); send to 'Living Room'" -o playlist-named-device.json -v
-    ```
+    ```

package/docs/README.md

@@ -40,7 +40,7 @@ See the full configuration reference here: `./CONFIGURATION.md`.
       "model": "grok-beta",
       "supportsFunctionCalling": true
     },
-    "gpt": {
+    "chatgpt": {
       "apiKey": "sk-your-openai-key-here",
       "baseURL": "https://api.openai.com/v1",
       "model": "gpt-4o",
@@ -57,7 +57,7 @@ See the full configuration reference here: `./CONFIGURATION.md`.
   "playlist": {
     "privateKey": "your_ed25519_private_key_base64_here"
   },
-  "feed": { "baseURLs": ["https://feed.feralfile.com/api/v1"] },
+  "feed": { "baseURLs": ["https://dp1-feed-operator-api-prod.autonomy-system.workers.dev/api/v1"] },
   "ff1Devices": {
     "devices": [
       {
@@ -163,7 +163,7 @@ How it works (at a glance):
 - If `deviceName` is present, the CLI will send the validated playlist to that FF1 device.
 - If `feedServer` is present (via "publish to my feed"), the CLI will publish the playlist to the selected feed server.
 
-Use `--model grok|gpt|gemini` to switch models, or set `defaultModel` in `config.json`.
+Use `--model grok|chatgpt|gemini` to switch models, or set `defaultModel` in `config.json`.
 
 ### Natural language publishing
 

package/docs/RELEASING.md

@@ -4,16 +4,40 @@ The curl installer downloads prebuilt binaries from GitHub Releases. Build one a
 
 ## Build a Release Asset (local)
 
+**macOS / Linux:**
+
 ```bash
 ./scripts/release/build-asset.sh
 ```
 
-This produces:
+**Windows (PowerShell):**
+
+```powershell
+.\scripts\release\build-asset-windows.ps1
+```
+
+This produces (names vary by OS/arch):
+
+- `release/ff1-cli-darwin-arm64.tar.gz` (and `.sha256`) on macOS
+- `release/ff1-cli-linux-x64.tar.gz` (and `.sha256`) on Linux
+- `release/ff1-cli-windows-x64.zip` (and `.sha256`) on Windows
+
+Run the appropriate script on each target platform and upload each pair to the GitHub release.
 
-- `release/ff1-cli-darwin-x64.tar.gz`
-- `release/ff1-cli-darwin-x64.tar.gz.sha256`
+## GitHub Actions
+
+- **Build** (`build.yml`): Trigger manually (Actions → Build → Run workflow) or on pull requests. Builds binaries on macOS, Linux, and Windows and uploads them as workflow artifacts for download.
+- **Release** (`release.yml`): Triggered when you **publish a release** (create a release from the repo Releases page, or publish an existing draft). Builds the same binaries, then uploads them to that release. Pushing a tag alone does not run this; only creating/publishing a release does.
+
+## Installer Redirect
+
+`https://feralfile.com/ff1-cli-install` should redirect to:
+
+```
+https://raw.githubusercontent.com/feral-file/ff1-cli/main/scripts/install.sh
+```
 
-The exact filename depends on the OS/arch you build on. Run the script on each target platform (macOS + Linux, x64/arm64) and upload each pair to the GitHub release.
+The installer script then fetches the release assets from GitHub Releases.
 
 ## Environment Overrides
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ff1-cli",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "CLI to fetch NFT information and build DP1 playlists using Grok API",
   "main": "dist/index.js",
   "bin": {
@@ -43,24 +43,16 @@
   "author": "",
   "license": "MIT",
   "dependencies": {
-    "@lancedb/lancedb": "^0.22.1",
-    "@mozilla/readability": "^0.6.0",
-    "@xenova/transformers": "^2.17.2",
     "axios": "^1.6.2",
     "chalk": "^4.1.2",
-    "cheerio": "^1.0.0-rc.12",
     "commander": "^11.1.0",
     "dotenv": "^16.3.1",
     "dp1-js": "^1.1.0",
     "fuzzysort": "^3.1.0",
-    "jsdom": "^27.0.0",
     "openai": "^4.58.1",
-    "ora": "^5.4.1",
-    "puppeteer": "^24.22.3",
     "viem": "^2.38.2"
   },
   "devDependencies": {
-    "@types/jsdom": "^27.0.0",
     "@types/node": "^24.7.1",
     "@typescript-eslint/eslint-plugin": "^8.46.0",
     "@typescript-eslint/parser": "^8.46.0",