@sassoftware/sas-score-mcp-serverjs 0.4.1-1 → 0.4.1-5

package/cli.js

@@ -84,7 +84,7 @@ const args = parseArgs({
 
 // Handle help flag
 if (args.values.help) {
-  console.log(`
+  console.error(`
 Usage: sas-score-mcp-serverjs [options]
 
 Options:
@@ -108,7 +108,7 @@ Environment Variables:
 // Handle version flag
 if (args.values.version) {
   let pkgJson = JSON.parse(pkg);
-  console.log(pkgJson.version);
+  console.error(pkgJson.version);
   process.exit(0);
 }
 
@@ -122,7 +122,7 @@ if (process.env.ENVFILE === 'FALSE') {
   console.error('Env file:', envf); 
   if (fs.existsSync(envf)) {
     console.error(`Loading environment variables from ${envf}...`);
-    let e = iconfig(envf); // avoid dotenv since it writes to console.log
+    let e = iconfig(envf); // avoid dotenv since it writes to console.error
     console.error('[Note]: Environment variables loaded from .env file...');
     console.error('Loaded env variables:', e);
     // dotenvExpand.expand(e);
@@ -390,7 +390,7 @@ function iconfig(envFile) {
     });
     return envData;
   } catch (err) {
-    console.log(err);
+    console.error(err);
     process.exit(0);
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sassoftware/sas-score-mcp-serverjs",
-  "version": "0.4.1-1",
+  "version": "0.4.1-5",
   "description": "A mcp server for SAS Viya",
   "author": "Deva Kumar <deva.kumar@sas.com>",
   "license": "Apache-2.0",

package/src/createMcpServer.js

@@ -73,18 +73,16 @@ async function createMcpServer(cache, _appContext) {
   let toolNames = [];
   toolSet.forEach((tool, i) => {
     let toolName = _appContext.brand + '-' + tool.name;
-    tool.inputSchema.additionalProperties = false; // disallow extra properties 
+    //tool.inputSchema.additionalProperties = false; // disallow extra properties 
     let config = {
-      title: toolName,
       description: tool.description,
       inputSchema: tool.inputSchema
     }
-    console.error(`[Note] Configuring tool ${toolName} with input schema: ${JSON.stringify(tool.inputSchema)}`);
+ 
     console.error(`\n[Note] Registering tool ${i + 1} : ${toolName}`);
     let toolHandler = wrapf(cache, tool.handler);
-
+    console.error(`[Note] Registering tool ${toolName} with config: ${JSON.stringify(config)}`);
     let r = mcpServer.registerTool(toolName, config, toolHandler);
-    console.error(`[Note] Tool ${toolName} registered with result: ${JSON.stringify(r)}`);
     toolNames.push(toolName);
   });
   console.error(`[Note] Registered ${toolSet.length} tools: ${toolNames}`);

package/src/toolSet/devaScore.js

@@ -1,61 +1,61 @@
-/*
- * Copyright © 2025, SAS Institute Inc., Cary, NC, USA.  All Rights Reserved.
- * SPDX-License-Identifier: Apache-2.0
- */
-import { z } from 'zod';
-
-function devaScore(_appContext) {
-
-    let description = `
-deva-score — compute a numeric score based on two input values.
-
-USE when: calculate deva score, score these values, compute score for numbers
-DO NOT USE for: model scoring (use model-score), statistical calculations, data lookup
-
-PARAMETERS
-- a: number (required) — first input value
-- b: number (required) — second input value
-
-FORMULA: (a + b) * 42
-
-ROUTING RULES
-- "calculate deva score for 5 and 10" → { a: 5, b: 10 }
-- "score 1 and 2" → { a: 1, b: 2 }
-- "deva score a=3, b=7" → { a: 3, b: 7 }
-- Multiple numbers → chain calls left-to-right: call(first, second), then call(result, third)
-
-EXAMPLES
-- "Calculate deva score for 5 and 10" → { a: 5, b: 10 } returns 630
-- "Score 1 and 2" → { a: 1, b: 2 } returns 126
-- "Deva score 20 and 30" → { a: 20, b: 30 } returns 2100
-
-NEGATIVE EXAMPLES (do not route here)
-- "Score this customer with credit model" (use model-score)
-- "Calculate the mean of these values" (use run-sas-program or sas-query)
-- "Statistical analysis of numbers" (use sas-query)
-
-RESPONSE
-Returns { score: (a + b) * 42 }
-    `;
-    let spec = {
-        name: 'deva-score',
-        description: description,
-        inputSchema: z.object({
-            a: z.number(),
-            b: z.number()
-        }),
-        handler: async ({ a, b }) => {
-            console.error(a, b);
-            let r = { score: (a + b) * 42 };
-            console.error('deva score result', r);
-            return {
-                content: [{ type: 'text', text: 'deva score result: ' + JSON.stringify(r) }],
-                structuredContent: r
-            };
-        }
-    }
-
-    return spec;
-}
-export default devaScore;
-
+/*
+ * Copyright © 2025, SAS Institute Inc., Cary, NC, USA.  All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { z } from 'zod';
+
+function devaScore(_appContext) {
+
+    let description = `
+deva-score — compute a numeric score based on two input values.
+
+USE when: calculate deva score, score these values, compute score for numbers
+DO NOT USE for: model scoring (use model-score), statistical calculations, data lookup
+
+PARAMETERS
+- a: number (required) — first input value
+- b: number (required) — second input value
+
+FORMULA: (a + b) * 42
+
+ROUTING RULES
+- "calculate deva score for 5 and 10" → { a: 5, b: 10 }
+- "score 1 and 2" → { a: 1, b: 2 }
+- "deva score a=3, b=7" → { a: 3, b: 7 }
+- Multiple numbers → chain calls left-to-right: call(first, second), then call(result, third)
+
+EXAMPLES
+- "Calculate deva score for 5 and 10" → { a: 5, b: 10 } returns 630
+- "Score 1 and 2" → { a: 1, b: 2 } returns 126
+- "Deva score 20 and 30" → { a: 20, b: 30 } returns 2100
+
+NEGATIVE EXAMPLES (do not route here)
+- "Score this customer with credit model" (use model-score)
+- "Calculate the mean of these values" (use run-sas-program or sas-query)
+- "Statistical analysis of numbers" (use sas-query)
+
+RESPONSE
+Returns { score: (a + b) * 42 }
+    `;
+    let spec = {
+        name: 'deva-score',
+        description: description,
+        inputSchema: z.object({
+            a: z.number(),
+            b: z.number(),
+        }),
+        handler: async ({ a, b }) => {
+            console.error(a, b);
+            let r = { score: (a + b) * 42 };
+            console.error('deva score result', r);
+            return {
+                content: [{ type: 'text', text: 'deva score result: ' + JSON.stringify(r) }],
+                structuredContent: r
+            };
+        }
+    }
+
+    return spec;
+}
+export default devaScore;
+

package/src/toolSet/findJob.js

@@ -42,7 +42,7 @@ Returns { jobs: [] } if not found; { jobs: [name, ...] } if found. Never halluci
     name: 'find-job',
     description: description,
     inputSchema: z.object({
-      name: z.string(),
+      name: z.string()
     }),
     handler: async (params) => {
       let r = await _listJobs(params);

package/src/toolSet/findJobdef.js

@@ -51,7 +51,7 @@ Returns { jobdefs: [] } if not found; { jobdefs: [name, ...] } if found. Never h
     name: 'find-jobdef',
     description: description,
     inputSchema: z.object({
-      name: z.string()
+        name: z.string()
     }),
     handler: async (params) => {
       let r = await _listJobdefs(params);
@@ -61,4 +61,4 @@ Returns { jobdefs: [] } if not found; { jobdefs: [name, ...] } if found. Never h
   return spec;
 }
 export default findJobdef;
-
+

package/src/toolSet/findLibrary.js

@@ -1,67 +1,68 @@
-/*
- * Copyright © 2025, SAS Institute Inc., Cary, NC, USA.  All Rights Reserved.
- * SPDX-License-Identifier: Apache-2.0
- */
-import { z } from 'zod';
-import _listLibrary from '../toolHelpers/_listLibrary.js';
-function findLibrary(_appContext) {
-  
-  let description = `
-find-library — locate a specific CAS or SAS library.
-
-USE when: find library, find lib, does library exist, is library available, lookup library
-DO NOT USE for: list libraries (use list-libraries), find table/job/jobdef/model (use respective tools), table structure (use table-info), create library (use run-sas-program)
-
-PARAMETERS
-- name: string (required) — library/caslib name; if multiple supplied, use first
-- server: 'cas' | 'sas' (default: 'cas') — target environment
-
-ROUTING RULES
-- "find lib <name>" → { name: "<name>", server: "cas" }
-- "find lib <name> in cas" → { name: "<name>", server: "cas" }
-- "find library <name> in sas" → { name: "<name>", server: "sas" }
-- "does library <name> exist" → { name: "<name>", server: "cas" }
-- "find lib" with no name → ask "Which library name would you like to find?"
-- "list libraries / list libs" → use list-libraries instead
-- "tables in <lib>" → use list-tables instead
-
-EXAMPLES
-- "find lib Public" → { name: "Public", server: "cas" }
-- "find library sasuser in sas" → { name: "sasuser", server: "sas" }
-- "does library Formats exist" → { name: "Formats", server: "cas" }
-
-NEGATIVE EXAMPLES (do not route here)
-- "list libs" (use list-libraries)
-- "show tables in Public" (use list-tables)
-- "find table cars in sashelp" (use find-table)
-- "find job cars_job" (use find-job)
-
-ERRORS
-Returns { libraries: [] } if not found; { libraries: [name, ...] } if found. Never hallucinate library names.
-  `;
-
-  let spec = {
-    name: 'find-library',
-    description: description,
-    inputSchema: z.object({
-      name: z.string(),
-      server: z.string()
-    }),
-    handler: async (params) => {
-      // normalize server to lowercase & default
-      if (!params.server) params.server = 'cas';
-      params.server = params.server.toLowerCase();
-
-      // If multiple names passed (comma or space separated), take the first token (defensive)
-      if (params.name && /[,\s]+/.test(params.name.trim())) {
-        params.name = params.name.split(/[,\s]+/).filter(Boolean)[0];
-      }
-
-      let r = await _listLibrary(params);
-      return r;
-    }
-  }
-  return spec;
-}
-export default findLibrary;
-
+/*
+ * Copyright © 2025, SAS Institute Inc., Cary, NC, USA.  All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { z } from 'zod';
+import _listLibrary from '../toolHelpers/_listLibrary.js';
+function findLibrary(_appContext) {
+  
+  let description = `
+find-library — locate a specific CAS or SAS library.
+
+USE when: find library, find lib, does library exist, is library available, lookup library
+DO NOT USE for: list libraries (use list-libraries), find table/job/jobdef/model (use respective tools), table structure (use table-info), create library (use run-sas-program)
+
+PARAMETERS
+- name: string (required) — library/caslib name; if multiple supplied, use first
+- server: 'cas' | 'sas' (default: 'cas') — target environment
+
+ROUTING RULES
+- "find lib <name>" → { name: "<name>", server: "cas" }
+- "find lib <name> in cas" → { name: "<name>", server: "cas" }
+- "find library <name> in sas" → { name: "<name>", server: "sas" }
+- "does library <name> exist" → { name: "<name>", server: "cas" }
+- "find lib" with no name → ask "Which library name would you like to find?"
+- "list libraries / list libs" → use list-libraries instead
+- "tables in <lib>" → use list-tables instead
+
+EXAMPLES
+- "find lib Public" → { name: "Public", server: "cas" }
+- "find library sasuser in sas" → { name: "sasuser", server: "sas" }
+- "does library Formats exist" → { name: "Formats", server: "cas" }
+
+NEGATIVE EXAMPLES (do not route here)
+- "list libs" (use list-libraries)
+- "show tables in Public" (use list-tables)
+- "find table cars in sashelp" (use find-table)
+- "find job cars_job" (use find-job)
+
+ERRORS
+Returns { libraries: [] } if not found; { libraries: [name, ...] } if found. Never hallucinate library names.
+  `;
+
+  let spec = {
+    name: 'find-library',
+    description: description,
+    inputSchema: z.object({
+      name: z.string(),
+      server: z.string().optional()
+    }),
+    
+    handler: async (params) => {
+      // normalize server to lowercase & default
+      if (!params.server) params.server = 'cas';
+      params.server = params.server.toLowerCase();
+
+      // If multiple names passed (comma or space separated), take the first token (defensive)
+      if (params.name && /[,\s]+/.test(params.name.trim())) {
+        params.name = params.name.split(/[,\s]+/).filter(Boolean)[0];
+      }
+
+      let r = await _listLibrary(params);
+      return r;
+    }
+  }
+  return spec;
+}
+export default findLibrary;
+

package/src/toolSet/findModel.js

@@ -46,7 +46,7 @@ Returns { models: [] } if not found; { models: [name, ...] } if found. Never hal
     name: 'find-model',
     description: description,
     inputSchema: z.object({
-      'name': z.string()
+      name: z.string()
     }),
     handler: async (params) => { 
       let r = await _listModels(params);
@@ -57,4 +57,4 @@ Returns { models: [] } if not found; { models: [name, ...] } if found. Never hal
 }
 
 export default findModel;
-
+

package/src/toolSet/findTable.js

@@ -47,10 +47,11 @@ Returns { tables: [] } if not found; { tables: [name, ...] } if found. Never hal
     name: 'find-table',
     description: description,
     inputSchema: z.object({
-      server: z.string(), // default server is 'cas',
       name: z.string(),
-      lib: z.string()
+      lib: z.string(),
+      server: z.string().optional() // default server is 'cas'
     }),
+    
     handler: async (params) => {
       // Check if the params.scenario is a string and parse it
       let r = await _listTables(params);

package/src/toolSet/getEnv.js

@@ -40,9 +40,13 @@ Returns variable name with current value, or null if not found. Return structure
     let spec = {
     name: 'get-env',
     description: description,
-        inputSchema: z.object({
-            name: z.string()
-        }),
+        inputSchema: {
+            type: 'object',
+            properties: {
+                name: { type: 'string' }
+            },
+            required: ['name']
+        },
     handler: async (params) => {
             return await _getEnv(params);
         }
@@ -50,4 +54,4 @@ Returns variable name with current value, or null if not found. Return structure
     return spec;
 }
 export default getEnv;
-
+

package/src/toolSet/listJobdefs.js

@@ -1,61 +1,61 @@
-/*
- * Copyright © 2025, SAS Institute Inc., Cary, NC, USA.  All Rights Reserved.
- * SPDX-License-Identifier: Apache-2.0
- */
-import { z } from 'zod';
-import _listJobdefs from '../toolHelpers/_listJobdefs.js';
-function listJobdefs(_appContext) {
-
-  let description = `
-list-jobdefs — enumerate SAS Viya job definitions (jobdefs) assets.
-
-USE when: list jobdefs, show jobdefs, browse jobdefs, list available jobdefs, next page
-DO NOT USE for: find single jobdef (use find-jobdef), execute jobdef (use run-jobdef), find job (use find-job), sas code (use run-sas-program)
-
-PARAMETERS
-- limit: number (default: 10) — number of jobdefs per page
-- start: number (default: 1) — 1-based page offset
-- where: string (default: '') — optional filter expression
-
-ROUTING RULES
-- list jobdefs → { start: 1, limit: 10 }
-- show me 25 jobdefs → { start: 1, limit: 25 }
-- next jobdefs → { start: previousStart + previousLimit, limit: previousLimit }
-
-EXAMPLES
-- list jobdefs → { start: 1, limit: 10 }
-- list 25 jobdefs → { start: 1, limit: 25 }
-- next jobdefs → { start: 11, limit: 10 }
-
-NEGATIVE EXAMPLES (do not route here)
-- find jobdef abc (use find-jobdef)
-- list jobs (use list-jobs)
-- run jobdef abc (use run-jobdef)
-- list models (use list-models)
-
-PAGINATION
-If returned length === limit, hint: next start = start + limit. Empty result with start > 1 means paged past end.
-
-ERRORS
-Surface backend error directly; never fabricate jobdef names.
-  `;
-
-  let spec = {
-    name: 'list-jobdefs',
-    description: description,
-    inputSchema: z.object({
-      limit: z.number(),
-      start: z.number(),
-      where: z.string() 
-    }),
-  // No 'server' required; backend context is implicit in helper
-    handler: async (params) => {
-      // _listJobdefs handles all validation and defaults
-      const result = await _listJobdefs(params);
-      return result;
-    }
-  }
-  return spec;
-}
-export default listJobdefs;
-
+/*
+ * Copyright © 2025, SAS Institute Inc., Cary, NC, USA.  All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { z } from 'zod';
+import _listJobdefs from '../toolHelpers/_listJobdefs.js';
+function listJobdefs(_appContext) {
+
+  let description = `
+list-jobdefs — enumerate SAS Viya job definitions (jobdefs) assets.
+
+USE when: list jobdefs, show jobdefs, browse jobdefs, list available jobdefs, next page
+DO NOT USE for: find single jobdef (use find-jobdef), execute jobdef (use run-jobdef), find job (use find-job), sas code (use run-sas-program)
+
+PARAMETERS
+- limit: number (default: 10) — number of jobdefs per page
+- start: number (default: 1) — 1-based page offset
+- where: string (default: '') — optional filter expression
+
+ROUTING RULES
+- list jobdefs → { start: 1, limit: 10 }
+- show me 25 jobdefs → { start: 1, limit: 25 }
+- next jobdefs → { start: previousStart + previousLimit, limit: previousLimit }
+
+EXAMPLES
+- list jobdefs → { start: 1, limit: 10 }
+- list 25 jobdefs → { start: 1, limit: 25 }
+- next jobdefs → { start: 11, limit: 10 }
+
+NEGATIVE EXAMPLES (do not route here)
+- find jobdef abc (use find-jobdef)
+- list jobs (use list-jobs)
+- run jobdef abc (use run-jobdef)
+- list models (use list-models)
+
+PAGINATION
+If returned length === limit, hint: next start = start + limit. Empty result with start > 1 means paged past end.
+
+ERRORS
+Surface backend error directly; never fabricate jobdef names.
+  `;
+
+  let spec = {
+    name: 'list-jobdefs',
+    description: description,
+    inputSchema: z.object({
+      limit: z.number().optional(),
+      start: z.number().optional(),
+      where: z.string().optional()
+    }),
+  // No 'server' required; backend context is implicit in helper
+    handler: async (params) => {
+      // _listJobdefs handles all validation and defaults
+      const result = await _listJobdefs(params);
+      return result;
+    }
+  }
+  return spec;
+}
+export default listJobdefs;
+

package/src/toolSet/listJobs.js

@@ -1,61 +1,61 @@
-/*
- * Copyright © 2025, SAS Institute Inc., Cary, NC, USA.  All Rights Reserved.
- * SPDX-License-Identifier: Apache-2.0
- */
-import { z } from 'zod';
-import _listJobs from '../toolHelpers/_listJobs.js';
-function listJobs(_appContext) {
-
-  let description = `
-list-jobs — enumerate SAS Viya job assets.
-
-USE when: list jobs, show jobs, browse jobs, list available jobs, next page
-DO NOT USE for: find single job (use find-job), execute job (use run-job), run job def (use run-jobdef), sas code (use run-sas-program)
-
-PARAMETERS
-- limit: number (default: 10) — number of jobs per page
-- start: number (default: 1) — 1-based page offset
-- where: string (default: '') — optional filter expression
-
-ROUTING RULES
-- list jobs → { start: 1, limit: 10 }
-- show me 25 jobs → { start: 1, limit: 25 }
-- next jobs → { start: previousStart + previousLimit, limit: previousLimit }
-
-EXAMPLES
-- list jobs → { start: 1, limit: 10 }
-- list 25 jobs → { start: 1, limit: 25 }
-- next jobs → { start: 11, limit: 10 }
-
-NEGATIVE EXAMPLES (do not route here)
-- find job abc (use find-job)
-- run job abc (use run-job)
-- list models (use list-models)
-- list tables in lib xyz (use list-tables)
-
-PAGINATION
-If returned length === limit, hint: next start = start + limit. Empty result with start > 1 means paged past end.
-
-ERRORS
-Surface backend error directly; never fabricate job names.
-  `;
-
-  let spec = {
-    name: 'list-jobs',
-    description: description,
-    inputSchema: z.object({
-      limit: z.number(),
-      start: z.number(),
-      where: z.string()
-    }),
-  // No 'server' required; backend context is implicit in helper
-    handler: async (params) => {
-      // _listJob handles all validation and defaults
-      const result = await _listJobs(params);
-      return result;
-    }
-  }
-  return spec;
-}
-export default listJobs;
-
+/*
+ * Copyright © 2025, SAS Institute Inc., Cary, NC, USA.  All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { z } from 'zod';
+import _listJobs from '../toolHelpers/_listJobs.js';
+function listJobs(_appContext) {
+
+  let description = `
+list-jobs — enumerate SAS Viya job assets.
+
+USE when: list jobs, show jobs, browse jobs, list available jobs, next page
+DO NOT USE for: find single job (use find-job), execute job (use run-job), run job def (use run-jobdef), sas code (use run-sas-program)
+
+PARAMETERS
+- limit: number (default: 10) — number of jobs per page
+- start: number (default: 1) — 1-based page offset
+- where: string (default: '') — optional filter expression
+
+ROUTING RULES
+- list jobs → { start: 1, limit: 10 }
+- show me 25 jobs → { start: 1, limit: 25 }
+- next jobs → { start: previousStart + previousLimit, limit: previousLimit }
+
+EXAMPLES
+- list jobs → { start: 1, limit: 10 }
+- list 25 jobs → { start: 1, limit: 25 }
+- next jobs → { start: 11, limit: 10 }
+
+NEGATIVE EXAMPLES (do not route here)
+- find job abc (use find-job)
+- run job abc (use run-job)
+- list models (use list-models)
+- list tables in lib xyz (use list-tables)
+
+PAGINATION
+If returned length === limit, hint: next start = start + limit. Empty result with start > 1 means paged past end.
+
+ERRORS
+Surface backend error directly; never fabricate job names.
+  `;
+
+  let spec = {
+    name: 'list-jobs',
+    description: description,
+    inputSchema: z.object({
+      limit: z.number().optional(),
+      start: z.number().optional(),
+      where: z.string().optional()
+    }),
+  // No 'server' required; backend context is implicit in helper
+    handler: async (params) => {
+      // _listJob handles all validation and defaults
+      const result = await _listJobs(params);
+      return result;
+    }
+  }
+  return spec;
+}
+export default listJobs;
+