fa-mcp-sdk 0.4.76 → 0.4.77

package/cli-template/package.json

@@ -16,9 +16,13 @@
     "ci": "node --no-deprecation ./scripts/npm/run.js",
     "reinstall": "node --no-deprecation ./scripts/npm/run.js reinstall",
     "typecheck": "tsc --noEmit",
-    "lint": "eslint .",
-    "lint:fix": "eslint --fix .",
-    "lint-fix-build": "eslint --fix . && rimraf dist && tsc",
+    "lint": "oxlint .",
+    "lint:fix": "oxlint --fix .",
+    "format": "oxfmt --check .",
+    "format:fix": "oxfmt .",
+    "quality": "npm run lint && npm run format",
+    "quality:fix": "npm run lint:fix && npm run format:fix",
+    "lint-fix-build": "oxlint --fix . && oxfmt . && rimraf dist && tsc",
     "generate-token": "node node_modules/fa-mcp-sdk/dist/core/auth/token-generator/server.js",
     "dead:exports": "ts-prune",
     "dead:files": "knip",
@@ -50,15 +54,16 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
     "dotenv": "^17.4.1",
-    "fa-mcp-sdk": "^0.4.76"
+    "fa-mcp-sdk": "^0.4.77"
   },
   "devDependencies": {
     "@types/express": "^5.0.6",
     "@types/jest": "^30.0.0",
     "@types/node": "^25.5.2",
     "cross-env": "^10.1.0",
-    "eslint-config-at-26-2": "^26.4.9",
     "jest": "^30.3.0",
+    "oxfmt": "^0.48.0",
+    "oxlint": "^1.63.0",
     "rimraf": "^6.1.3",
     "ts-jest": "^29.4.9",
     "tsx": "^4.21.0",

package/cli-template/prompt-example-new-MCP.md

@@ -1,101 +1,101 @@
-# Goal
-Write the code for MCP server tools that implement retrieving the current cross-rate for a specified pair of currencies.
-
-## Instructions
-
-### Currency Cross-Rate API
-
-#### Available Currencies
-Currency codes (ISO 4217 code Alpha-3): ALL, ARS, AUD, BGN, BRL, BYN, CAD, CHF, CLP, CNY, CZK, DKK, EUR, GBP, HKD, HRK, HUF, IDR, INR, ISK, JOD, JPY, KRW, KZT, LAK, LKR, MKD, MMK, MXN, MYR, NOK, NPR, NZD, PHP, PLN, RON, RSD, RUB, SEK, SGD, THB, TRY, TWD, UAH, USD, VND, ZAR
-
-#### Endpoint
-
-```http request
-GET http://<appConfig.accessPoints.currencyService.host>:<appConfig.accessPoints.currencyService.port>/currency-service/?rate=<QUOTE_CURRENCY><BASE_CURRENCY>
-Authorization: Bearer <appConfig.accessPoints.currencyService.token>
-```
-
-Example:
-
-```http request
-GET http://smart-trade-ml.com:5001/currency-service/?rate=THBRUB
-Authorization: Bearer <appConfig.accessPoints.currencyService.token>
-```
-
-Response:
-
-```json
-{"symbol": "THBRUB", "rate": 2.424167346170733}
-```
-
-Possible error codes: 400, 401, 404, 502
-
-### Addition to config/default.yaml
-
-```yaml
-accessPoints:
-  currencyService:
-    host: smart-trade-ml.com
-    port: 5002
-    token: '***'
-```
-
-
-### Create config/local.yaml
-
-Create a file config/local.yaml with the following content:
-
-```yaml
----
-accessPoints:
-   currencyService:
-      token: '88888888-4444-4444-4444-bbbbbbbbbbbb'
-
-agentTester:
-   enabled: true
-   openAi:
-      apiKey: '<ask the user for the key>'
-
-consul:
-   service:
-      enable: false
-
-webServer:
-   auth:
-      enabled: true
-      jwtToken:
-         encryptKey: 'dbbe87db-90d0-4732-aae3-4089763ec392'
-         checkMCPName: true
-         isCheckIP: false
-      permanentServerTokens: ['psToken1']
-
-adminPanel:
-   enabled: true
-   authType: 'permanentServerTokens'
-```
-
-# Task
-
-1) Instead of the test tool 'example_tool', add a tool to get the current currency cross-rate.
-   Tool parameters:
-- quoteCurrency - Currency code (ISO 4217 code Alpha-3) - required parameter
-- baseCurrency - Currency code (ISO 4217 code Alpha-3) - optional parameter, default is USD
-
-2) Instead of the test resource 'custom-resource://resource1', add a resource to get the list of available currencies
-
-3) Instead of the endpoint /api/example (/example) in the file `src/api/router.ts`, create the endpoint get-curr-rate as a proxy to http://<appConfig.accessPoints.currencyService.host>:<appConfig.accessPoints.currencyService.port>/currency-service/?rate=<QUOTE_CURRENCY><BASE_CURRENCY>
-
-4) Replace file content `src/asset/logo.svg` with
-```
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
-  <path fill="currentColor"
-      d="M12 14.4q-.8 0-1.4-.6l-.3-.3H10l-1 1v.2l.3.3q.7.8 1.9 1v1l.1.2h1.4l.2-.1v-1q2-.4 2.1-2.2c0-1.8-1.5-2.3-2.5-2.6-1.3-.4-1.5-.5-1.5-1s.8-.6 1.3-.6q.7 0 1.3.4l.3.2h.3l.7-1.3v-.2l-.4-.2Q13.8 8 13 8V7l-.2-.1h-1.4l-.1.2v1q-1.9.6-2 2.2c0 1.9 1.8 2.4 2.7 2.7q1.6.4 1.4.9c0 .4-.8.5-1.2.5m10 .2-.7-.1-.7.3a8.6 8.6 0 0 1-10.9 5.6c-2.8-1-5-3.2-5.7-6l1.7.8q.5.2.8-.3l.3-.5-.3-.8-3.7-2a1 1 0 0 0-.8.4l-2 3.7.3.8.6.3q.5.2.8-.3l.7-1.3A10.4 10.4 0 0 0 17 21.5q3.8-2 5.2-6.1a1 1 0 0 0-.4-.8M24 8q0-.3-.3-.4l-.6-.3-.8.3-.7 1.3A10.4 10.4 0 0 0 7 2.7a10 10 0 0 0-5.2 6q-.2.6.4.8l.6.2q.5.1.7-.4a8.6 8.6 0 0 1 10.9-5.6 9 9 0 0 1 5.7 6.1L18.3 9l-.8.3-.3.5.3.8 3.7 2 .8-.3 2-3.8z"/>
-</svg>
-```
-
-5) Formulate the prompt AGENT_BRIEF in `src/prompts/agent-brief.ts` and AGENT_PROMPT in `src/prompts/agent-prompt.ts`
-
-6) Instead of the test examples in `tests/mcp/test-cases.js`, write tests for our case
-
-7) Update the README.md to reflect the new project. This README.md will be used when searching for this MCP in the RAG system.
-   Therefore, describe the essence of the tool, its features, how to install, a list of tools, resources, prompts. Briefly and to the point.
+# Goal
+Write the code for MCP server tools that implement retrieving the current cross-rate for a specified pair of currencies.
+
+## Instructions
+
+### Currency Cross-Rate API
+
+#### Available Currencies
+Currency codes (ISO 4217 code Alpha-3): ALL, ARS, AUD, BGN, BRL, BYN, CAD, CHF, CLP, CNY, CZK, DKK, EUR, GBP, HKD, HRK, HUF, IDR, INR, ISK, JOD, JPY, KRW, KZT, LAK, LKR, MKD, MMK, MXN, MYR, NOK, NPR, NZD, PHP, PLN, RON, RSD, RUB, SEK, SGD, THB, TRY, TWD, UAH, USD, VND, ZAR
+
+#### Endpoint
+
+```http request
+GET http://<appConfig.accessPoints.currencyService.host>:<appConfig.accessPoints.currencyService.port>/currency-service/?rate=<QUOTE_CURRENCY><BASE_CURRENCY>
+Authorization: Bearer <appConfig.accessPoints.currencyService.token>
+```
+
+Example:
+
+```http request
+GET http://smart-trade-ml.com:5001/currency-service/?rate=THBRUB
+Authorization: Bearer <appConfig.accessPoints.currencyService.token>
+```
+
+Response:
+
+```json
+{"symbol": "THBRUB", "rate": 2.424167346170733}
+```
+
+Possible error codes: 400, 401, 404, 502
+
+### Addition to config/default.yaml
+
+```yaml
+accessPoints:
+  currencyService:
+    host: smart-trade-ml.com
+    port: 5002
+    token: '***'
+```
+
+
+### Create config/local.yaml
+
+Create a file config/local.yaml with the following content:
+
+```yaml
+---
+accessPoints:
+   currencyService:
+      token: '88888888-4444-4444-4444-bbbbbbbbbbbb'
+
+agentTester:
+   enabled: true
+   openAi:
+      apiKey: '<ask the user for the key>'
+
+consul:
+   service:
+      enable: false
+
+webServer:
+   auth:
+      enabled: true
+      jwtToken:
+         encryptKey: 'dbbe87db-90d0-4732-aae3-4089763ec392'
+         checkMCPName: true
+         isCheckIP: false
+      permanentServerTokens: ['psToken1']
+
+adminPanel:
+   enabled: true
+   authType: 'permanentServerTokens'
+```
+
+# Task
+
+1) Instead of the test tool 'example_tool', add a tool to get the current currency cross-rate.
+   Tool parameters:
+- quoteCurrency - Currency code (ISO 4217 code Alpha-3) - required parameter
+- baseCurrency - Currency code (ISO 4217 code Alpha-3) - optional parameter, default is USD
+
+2) Instead of the test resource 'custom-resource://resource1', add a resource to get the list of available currencies
+
+3) Instead of the endpoint /api/example (/example) in the file `src/api/router.ts`, create the endpoint get-curr-rate as a proxy to http://<appConfig.accessPoints.currencyService.host>:<appConfig.accessPoints.currencyService.port>/currency-service/?rate=<QUOTE_CURRENCY><BASE_CURRENCY>
+
+4) Replace file content `src/asset/logo.svg` with
+```
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
+  <path fill="currentColor"
+      d="M12 14.4q-.8 0-1.4-.6l-.3-.3H10l-1 1v.2l.3.3q.7.8 1.9 1v1l.1.2h1.4l.2-.1v-1q2-.4 2.1-2.2c0-1.8-1.5-2.3-2.5-2.6-1.3-.4-1.5-.5-1.5-1s.8-.6 1.3-.6q.7 0 1.3.4l.3.2h.3l.7-1.3v-.2l-.4-.2Q13.8 8 13 8V7l-.2-.1h-1.4l-.1.2v1q-1.9.6-2 2.2c0 1.9 1.8 2.4 2.7 2.7q1.6.4 1.4.9c0 .4-.8.5-1.2.5m10 .2-.7-.1-.7.3a8.6 8.6 0 0 1-10.9 5.6c-2.8-1-5-3.2-5.7-6l1.7.8q.5.2.8-.3l.3-.5-.3-.8-3.7-2a1 1 0 0 0-.8.4l-2 3.7.3.8.6.3q.5.2.8-.3l.7-1.3A10.4 10.4 0 0 0 17 21.5q3.8-2 5.2-6.1a1 1 0 0 0-.4-.8M24 8q0-.3-.3-.4l-.6-.3-.8.3-.7 1.3A10.4 10.4 0 0 0 7 2.7a10 10 0 0 0-5.2 6q-.2.6.4.8l.6.2q.5.1.7-.4a8.6 8.6 0 0 1 10.9-5.6 9 9 0 0 1 5.7 6.1L18.3 9l-.8.3-.3.5.3.8 3.7 2 .8-.3 2-3.8z"/>
+</svg>
+```
+
+5) Formulate the prompt AGENT_BRIEF in `src/prompts/agent-brief.ts` and AGENT_PROMPT in `src/prompts/agent-prompt.ts`
+
+6) Instead of the test examples in `tests/mcp/test-cases.js`, write tests for our case
+
+7) Update the README.md to reflect the new project. This README.md will be used when searching for this MCP in the RAG system.
+   Therefore, describe the essence of the tool, its features, how to install, a list of tools, resources, prompts. Briefly and to the point.

package/cli-template/readme-docs/SKILLS.md

@@ -37,7 +37,7 @@ Generates JWT tokens for MCP server authentication via `scripts/generate-jwt.js`
 Generates a migration guide for upgrading the `fa-mcp-sdk` dependency in this project. Analyzes diffs in:
 
 - `config/*.yaml` — new/removed/changed keys and defaults (correlates `default.yaml`, `_local.yaml`, `local.yaml`)
-- `cli-template/` — `package.json` (new deps only), `tsconfig.json`, `eslint.config.js`, `CLAUDE.md`, `deploy/`,
+- `cli-template/` — `package.json` (new deps only), `tsconfig.json`, `.oxlintrc.json`, `.oxfmtrc.json`, `CLAUDE.md`, `deploy/`,
   `.claude/skills/`, `.run/` (from `r/`)
 - `scripts/` — new or updated SDK utilities (excluding SDK-internal `copy-static.js`, `publish.sh`)
 - `dist/core/index.js` — added/removed/renamed exports and breaking type changes

package/cli-template/tsconfig.json

@@ -1,58 +1,58 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "ES2022",
-    "moduleResolution": "bundler",
-    "lib": ["ES2022"],
-    "outDir": "./dist",
-    "rootDir": "./",
-    "baseUrl": "./",
-    "ignoreDeprecations": "6.0",
-    "strict": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "forceConsistentCasingInFileNames": true,
-    "declaration": true,
-    "declarationMap": true,
-    "sourceMap": true,
-    "removeComments": false,
-    "noImplicitAny": true,
-    "noImplicitReturns": true,
-    "noFallthroughCasesInSwitch": true,
-    "noUncheckedIndexedAccess": true,
-    "exactOptionalPropertyTypes": true,
-    "noImplicitOverride": true,
-    "allowSyntheticDefaultImports": true,
-    "resolveJsonModule": true,
-    "isolatedModules": true,
-    "experimentalDecorators": true,
-    "emitDecoratorMetadata": true
-  },
-  "include": [
-    "src/**/*",
-    "tests/**/*"
-  ],
-  "exclude": [
-    ".claude",
-    ".idea",
-    ".junie",
-    ".playwright-mcp",
-    ".run",
-    ".serena",
-    "_misc",
-    "_tmp",
-    "config",
-    "out",
-    "deploy",
-    "dist",
-    "doc",
-    "docs",
-    "node_modules",
-    "out",
-    "coverage",
-    "swagger"
-  ],
-  "ts-node": {
-    "esm": true
-  }
-}
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ES2022",
+    "moduleResolution": "bundler",
+    "lib": ["ES2022"],
+    "outDir": "./dist",
+    "rootDir": "./",
+    "baseUrl": "./",
+    "ignoreDeprecations": "6.0",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "removeComments": false,
+    "noImplicitAny": true,
+    "noImplicitReturns": true,
+    "noFallthroughCasesInSwitch": true,
+    "noUncheckedIndexedAccess": true,
+    "exactOptionalPropertyTypes": true,
+    "noImplicitOverride": true,
+    "allowSyntheticDefaultImports": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "experimentalDecorators": true,
+    "emitDecoratorMetadata": true
+  },
+  "include": [
+    "src/**/*",
+    "tests/**/*"
+  ],
+  "exclude": [
+    ".claude",
+    ".idea",
+    ".junie",
+    ".playwright-mcp",
+    ".run",
+    ".serena",
+    "_misc",
+    "_tmp",
+    "config",
+    "out",
+    "deploy",
+    "dist",
+    "doc",
+    "docs",
+    "node_modules",
+    "out",
+    "coverage",
+    "swagger"
+  ],
+  "ts-node": {
+    "esm": true
+  }
+}

package/cli-template/update.cjs

@@ -142,10 +142,11 @@ const logTryUpdate = (updateReason = '') => {
 /**
  * Execute command in NVM environment
  */
-function execCommand (command, options = {}, withSetupScript = false) {
+function execCommand(command, options = {}, withSetupScript = false) {
   // If we have NVM setup, wrap the command
-  const fullCommand = (setupScript && withSetupScript) ? `${setupScript} && ${command}` : command;
+  const fullCommand = setupScript && withSetupScript ? `${setupScript} && ${command}` : command;
   try {
+    // noinspection UnnecessaryLocalVariableJS
     const result = execSync(fullCommand, {
       encoding: 'utf8',
       stdio: options.silent ? 'inherit' : 'pipe',
@@ -158,14 +159,14 @@ function execCommand (command, options = {}, withSetupScript = false) {
   }
 }
 
-function execWithNODE (command, options = {}) {
+function execWithNODE(command, options = {}) {
   return execCommand(command, options, true);
 }
 
 /**
  * Load NVM environment and get Node.js version
  */
-function loadNVMEnvironment () {
+function loadNVMEnvironment() {
   try {
     if (fs.existsSync('.envrc')) {
       const envrcContent = fs.readFileSync('.envrc', 'utf8');
@@ -187,7 +188,7 @@ function loadNVMEnvironment () {
 /**
  * Parse command line arguments
  */
-function parseArgs () {
+function parseArgs() {
   const pArgs = process.argv.slice(2);
   const args = {
     expectedBranch: null,
@@ -219,7 +220,7 @@ function parseArgs () {
 /**
  * Show help information
  */
-function showHelp () {
+function showHelp() {
   console.log(`
 ================================================================================
     Project update and rebuild
@@ -244,7 +245,7 @@ function showHelp () {
 /**
  * Parse simple YAML content (key: value format)
  */
-function parseSimpleYAML (content) {
+function parseSimpleYAML(content) {
   const config = {};
   const lines = content.split('\n');
 
@@ -272,7 +273,7 @@ function parseSimpleYAML (content) {
 /**
  * Load configuration from YAML file
  */
-function loadConfig () {
+function loadConfig() {
   // Load NVM environment from .envrc
   loadNVMEnvironment();
 
@@ -301,7 +302,7 @@ function loadConfig () {
 /**
  * Get service name from package.json and .env
  */
-function getServiceName () {
+function getServiceName() {
   let serviceName = '';
   let serviceInstance = '';
   try {
@@ -334,7 +335,7 @@ function getServiceName () {
 /**
  * Check if systemctl service exists
  */
-function systemctlServiceExists (serviceName) {
+function systemctlServiceExists(serviceName) {
   try {
     execCommand(`systemctl list-unit-files "${serviceName}.service"`);
     return true;
@@ -343,7 +344,7 @@ function systemctlServiceExists (serviceName) {
   }
 }
 
-function pm2ServiceExists (serviceName) {
+function pm2ServiceExists(serviceName) {
   try {
     const res = execCommand(`pm2 id "${serviceName}"`);
     return /\[\s*\d\s*]/.test(res);
@@ -355,7 +356,7 @@ function pm2ServiceExists (serviceName) {
 /**
  * Get git repository information
  */
-function getRepoInfo () {
+function getRepoInfo() {
   try {
     const branch = execCommand('git rev-parse --abbrev-ref HEAD').trim();
     const headHash = execCommand('git rev-parse HEAD').trim();
@@ -376,27 +377,26 @@ function getRepoInfo () {
       upstreamHash,
     };
   } catch (error) {
-    const message = String(error.message).includes(error.stderr)
-      ? error.message
-      : [error.stderr, error.message].join('\n');
+    const message = String(error.message).includes(error.stderr) ? error.message : [error.stderr, error.message].join('\n');
 
     console.error('Error getting repo info:', message);
     return null;
   }
 }
 
-const colorizeHTML = (text) => text
-  .replace(/<red>/g, '<span style="color:#ff0000;">')
-  .replace(/<\/red>/g, '</span>')
-  .replace(/<y>/g, '<span style="background-color:#ffff00;">')
-  .replace(/<\/y>/g, '</span>')
-  .replace(/<g>/g, '<span style="background-color:#00ff00;">')
-  .replace(/<\/g>/g, '</span>')
-  .replace(/<r>/g, '<span style="background-color:#ff0000; color:#ffffff;">')
-  .replace(/<\/r>/g, '</span>')
-  .replace(/\[ERROR]/g, '<span style="color:#ffffff; background-color: #ff0000">[ERROR]</span>');
-
-async function sendBuildNotification (emails, status, body, serviceName) {
+const colorizeHTML = (text) =>
+  text
+    .replace(/<red>/g, '<span style="color:#ff0000;">')
+    .replace(/<\/red>/g, '</span>')
+    .replace(/<y>/g, '<span style="background-color:#ffff00;">')
+    .replace(/<\/y>/g, '</span>')
+    .replace(/<g>/g, '<span style="background-color:#00ff00;">')
+    .replace(/<\/g>/g, '</span>')
+    .replace(/<r>/g, '<span style="background-color:#ff0000; color:#ffffff;">')
+    .replace(/<\/r>/g, '</span>')
+    .replace(/\[ERROR]/g, '<span style="color:#ffffff; background-color: #ff0000">[ERROR]</span>');
+
+async function sendBuildNotification(emails, status, body, serviceName) {
   if (!emails) {
     return;
   }
@@ -423,7 +423,10 @@ ${colorizeHTML(clearColors(body))}
 </pre></body></html>`;
 
   // Send to each email address
-  const emailArray = emails.split(',').map((email) => email.trim()).filter((email) => email);
+  const emailArray = emails
+    .split(',')
+    .map((email) => email.trim())
+    .filter((email) => email);
 
   for (let i = 0; i < emailArray.length; i++) {
     const emailAddress = emailArray[i];
@@ -507,7 +510,7 @@ const restartService = (serviceNamePM) => {
 /**
  * Main update function
  */
-async function main () {
+async function main() {
   logTryUpdate();
   fs.writeFileSync(runTimeLogFile, '');
   const args = parseArgs();
@@ -603,9 +606,7 @@ async function main () {
       logIt('No changes detected. Update skipped.');
     }
   } catch (err) {
-    const message = String(err.message).includes(err.stderr)
-      ? err.message
-      : [err.stderr, err.message].join('\n');
+    const message = String(err.message).includes(err.stderr) ? err.message : [err.stderr, err.message].join('\n');
     logError(message);
     if (config.email) {
       await sendBuildNotification(config.email, 'FAIL', logBuffer, serviceName);
@@ -630,9 +631,11 @@ process.on('SIGTERM', () => {
   process.exit(1);
 });
 
-main().then(() => {
-  process.exit(0);
-}).catch((error) => {
-  console.error('Update failed:', error.message);
-  process.exit(1);
-});
+main()
+  .then(() => {
+    process.exit(0);
+  })
+  .catch((error) => {
+    console.error('Update failed:', error.message);
+    process.exit(1);
+  });