@sassoftware/sas-score-mcp-serverjs 1.0.1-3 → 1.0.1-31

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().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;
-
+/*
+ * 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;
+

package/src/toolSet/listLibraries.js

@@ -1,78 +1,78 @@
-/*
- * 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 listLibraries(_appContext) {
-  let description = `
-list-libraries — enumerate CAS or SAS libraries.
-
-USE when user asks to: list/show/enumerate libraries, caslibs, sas libs, or available libraries.
-DO NOT USE for: listing tables in a library (→ list-tables), column/table metadata, job execution, models, scoring.
-
-PARAMETERS
-- server: 'cas' | 'sas' | 'all' (default: 'all')
-- limit: integer > 0 (default: 10)
-- start: 1-based offset (default: 1)
-- where: optional filter expression (default: '')
-
-ROUTING RULES
-- "cas libs / cas libraries / in cas"         → { server: 'cas' }
-- "sas libs / sas libraries / in sas"         → { server: 'sas' }
-- "all libs / all libraries"                  → { server: 'all' }
-- "list tables in <libname>"                  → route to list-tables, NOT here
-- server unspecified                          → default { server: 'all' }
-- "all cas libs" with no limit specified      → { server: 'cas', limit: 50 } + paging note
-- "next" after prior call (start:S, limit:L) → { start: S + L, limit: L }
-- ambiguous "list" or "libs" with no context → assume { server: 'cas' }
-
-EXAMPLES
-- "list libraries"              → { server: 'all', start: 1, limit: 10 }
-- "list libs     "              → { server: 'all', start: 1, limit: 10 }
-
-- "list all libs"               → { server: 'all', start: 1, limit: 10 }
-- "list cas libraries"          → { server: 'cas', start: 1, limit: 10 }
-- "show me 25 sas libs"         → { server: 'sas', limit: 25, start: 1 }
-- "next" (prev: start:1,limit:10) → { server: <same>, start: 11, limit: 10 }
-- "filter cas libs" (no filter given) → ask: "What filter expression should I apply?"
-
-NEGATIVE EXAMPLES (do not route here)
-- "list tables in SASHELP"      → list-tables
-- "list models / jobs / jobdefs"→ respective tools
-- "run a program to create a lib" → run-sas-program
-
-PAGINATION
-If returned item count === limit, hint: next start = start + limit.
-If start > 1 and result is empty, note paging may have exceeded available items.
-
-ERRORS
-Return structured error with a message field. Never hallucinate library names.
-`;
-
-
-  // Canonical kebab-case tool name; legacy aliases preserved for compatibility
-  
- 
-  let spec = {
-    name: 'list-libraries',
-    description: description,
-    inputSchema: z.object({
-      server: z.string().optional(),
-      limit: z.number().optional(),
-      start: z.number().optional(),
-      where: z.string().optional()
-    }),
-    // 'server' has a default so we don't mark it required
-    handler: async (params) => {
-      // normalize server just in case caller sends 'CAS'/'SAS'
-      params.server = (params.server || 'all').toLowerCase();
-      
-      let r = await _listLibrary(params);
-      return r;
-    }
-  };
-  return spec;
-}
-export default listLibraries;
-     
+/*
+ * 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 listLibraries(_appContext) {
+  let description = `
+list-libraries — enumerate CAS or SAS libraries.
+
+USE when user asks to: list/show/enumerate libraries, caslibs, sas libs, or available libraries.
+DO NOT USE for: listing tables in a library (→ list-tables), column/table metadata, job execution, models, scoring.
+
+PARAMETERS
+- server: 'cas' | 'sas' | 'all' (default: 'all')
+- limit: integer > 0 (default: 10)
+- start: 1-based offset (default: 1)
+- where: optional filter expression (default: '')
+
+ROUTING RULES
+- "cas libs / cas libraries / in cas"         → { server: 'cas' }
+- "sas libs / sas libraries / in sas"         → { server: 'sas' }
+- "all libs / all libraries"                  → { server: 'all' }
+- "list tables in <libname>"                  → route to list-tables, NOT here
+- server unspecified                          → default { server: 'all' }
+- "all cas libs" with no limit specified      → { server: 'cas', limit: 50 } + paging note
+- "next" after prior call (start:S, limit:L) → { start: S + L, limit: L }
+- ambiguous "list" or "libs" with no context → assume { server: 'cas' }
+
+EXAMPLES
+- "list libraries"              → { server: 'all', start: 1, limit: 10 }
+- "list libs     "              → { server: 'all', start: 1, limit: 10 }
+
+- "list all libs"               → { server: 'all', start: 1, limit: 10 }
+- "list cas libraries"          → { server: 'cas', start: 1, limit: 10 }
+- "show me 25 sas libs"         → { server: 'sas', limit: 25, start: 1 }
+- "next" (prev: start:1,limit:10) → { server: <same>, start: 11, limit: 10 }
+- "filter cas libs" (no filter given) → ask: "What filter expression should I apply?"
+
+NEGATIVE EXAMPLES (do not route here)
+- "list tables in SASHELP"      → list-tables
+- "list models / jobs / jobdefs"→ respective tools
+- "run a program to create a lib" → run-sas-program
+
+PAGINATION
+If returned item count === limit, hint: next start = start + limit.
+If start > 1 and result is empty, note paging may have exceeded available items.
+
+ERRORS
+Return structured error with a message field. Never hallucinate library names.
+`;
+
+
+  // Canonical kebab-case tool name; legacy aliases preserved for compatibility
+  
+ 
+  let spec = {
+    name: 'list-libraries',
+    description: description,
+    inputSchema: z.object({
+      server: z.string().optional(),
+      limit: z.number().optional(),
+      start: z.number().optional(),
+      where: z.string().optional()
+    }),
+    // 'server' has a default so we don't mark it required
+    handler: async (params) => {
+      // normalize server just in case caller sends 'CAS'/'SAS'
+      params.server = (params.server || 'all').toLowerCase();
+      
+      let r = await _listLibrary(params);
+      return r;
+    }
+  };
+  return spec;
+}
+export default listLibraries;
+     

package/src/toolSet/listModels.js

@@ -1,56 +1,56 @@
-/*
- * Copyright © 2025, SAS Institute Inc., Cary, NC, USA.  All Rights Reserved.
- * SPDX-License-Identifier: Apache-2.0
- */
-
-import { z } from 'zod';
-import _listModels from '../toolHelpers/_listModels.js';
-
-function listModels(_appContext) {
-  let description = `
-list-models — enumerate models published to MAS.
-
-USE when: list models, show models, browse models, next page
-DO NOT USE for: find model, model metadata, score model, list jobs/tables/libraries
-
-PARAMETERS
-- limit: number (default: 10) — page size
-- start: number (default: 1) — 1-based offset
-
-ROUTING RULES
-- "list models" → { start:1, limit:10 }
-- "list 25 models" → { start:1, limit:25 }
-- "next models" → { start: start+limit, limit:10 }
-
-EXAMPLES
-- "list models" → { start:1, limit:10 }
-- "list 25 models" → { start:1, limit:25 }
-
-NEGATIVE EXAMPLES (do not route here)
-- "find model X" (use find-model)
-- "describe model X" (use model-info)
-- "score model X" (use model-score)
-- "list jobs" (use list-jobs)
-
-ERRORS
-Returns empty array if no models found.
-  `;
-
-  let spec = {
-    name: 'list-models',
-    description: description,
-    inputSchema: z.object({
-      limit: z.number().optional(),
-      start: z.number().optional()
-    }),
-    handler: async (params) => { 
-      let r  = await _listModels(params);
-      return r;
-    }
-  }
-  
-  return spec;
-}
-
-export default listModels;
-
+/*
+ * Copyright © 2025, SAS Institute Inc., Cary, NC, USA.  All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import { z } from 'zod';
+import _listModels from '../toolHelpers/_listModels.js';
+
+function listModels(_appContext) {
+  let description = `
+list-models — enumerate models published to MAS.
+
+USE when: list models, show models, browse models, next page
+DO NOT USE for: find model, model metadata, score model, list jobs/tables/libraries
+
+PARAMETERS
+- limit: number (default: 10) — page size
+- start: number (default: 1) — 1-based offset
+
+ROUTING RULES
+- "list models" → { start:1, limit:10 }
+- "list 25 models" → { start:1, limit:25 }
+- "next models" → { start: start+limit, limit:10 }
+
+EXAMPLES
+- "list models" → { start:1, limit:10 }
+- "list 25 models" → { start:1, limit:25 }
+
+NEGATIVE EXAMPLES (do not route here)
+- "find model X" (use find-model)
+- "describe model X" (use model-info)
+- "score model X" (use model-score)
+- "list jobs" (use list-jobs)
+
+ERRORS
+Returns empty array if no models found.
+  `;
+
+  let spec = {
+    name: 'list-models',
+    description: description,
+    inputSchema: z.object({
+      limit: z.number().optional(),
+      start: z.number().optional()
+    }),
+    handler: async (params) => { 
+      let r  = await _listModels(params);
+      return r;
+    }
+  }
+  
+  return spec;
+}
+
+export default listModels;
+

package/src/toolSet/listTables.js

@@ -1,66 +1,66 @@
-/*
- * Copyright © 2025, SAS Institute Inc., Cary, NC, USA.  All Rights Reserved.
- * SPDX-License-Identifier: Apache-2.0
- */
-
-import { z } from 'zod';
-import debug from 'debug';
-import _listTables from '../toolHelpers/_listTables.js';
-
-
-function listTables(_appContext) {
-  const log = debug('tools');
-
-    let description = `
-list-tables — enumerate tables within a library.
-
-USE when: list tables in <lib>, show tables in <lib>, next page
-DO NOT USE for: find table, list libraries, get table structure (use table-info), read data (use read-table)
-
-PARAMETERS
-- lib: string — library to inspect (required)
-- server: string (default: 'cas') — 'cas' or 'sas'
-- limit: number (default: 10) — page size
-- start: number (default: 1) — 1-based offset
-- where: string — optional filter expression
-
-ROUTING RULES
-- "list tables in Samples" → { lib: "Samples", start: 1, limit: 10 }
-- "list 25 tables in sashelp" → { lib: "sashelp", limit: 25, start: 1 }
-- "list cas tables in Public" → { lib: "Public", server: "cas", start: 1, limit: 10 }
-
-EXAMPLES
-- "list tables in Samples" → { lib: "Samples", start: 1, limit: 10 }
-- "show 25 tables in sashelp" → { lib: "sashelp", limit: 25, start: 1 }
-
-NEGATIVE EXAMPLES (do not route here)
-- "list libs" (use list-libraries)
-- "find lib Public" (use find-library)
-- "describe table cars" (use table-info)
-- "read table cars" (use read-table)
-
-ERRORS
-Returns empty array if no tables found.
-  `;
-    
-  let spec = {
-    name: 'list-tables',
-    description: description,
-
-    inputSchema: z.object({
-      lib: z.string(),
-      server: z.string().optional(),
-      limit: z.number().optional(),
-      start: z.number().optional(),
-      where: z.string().optional()
-    }),
-    handler: async (params) => { 
-      let r = await _listTables(params);
-      return r;
-    }
-  }
-  return spec;
-}
-
-export default listTables;
-
+/*
+ * Copyright © 2025, SAS Institute Inc., Cary, NC, USA.  All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import { z } from 'zod';
+import debug from 'debug';
+import _listTables from '../toolHelpers/_listTables.js';
+
+
+function listTables(_appContext) {
+  const log = debug('tools');
+
+    let description = `
+list-tables — enumerate tables within a library.
+
+USE when: list tables in <lib>, show tables in <lib>, next page
+DO NOT USE for: find table, list libraries, get table structure (use table-info), read data (use read-table)
+
+PARAMETERS
+- lib: string — library to inspect (required)
+- server: string (default: 'cas') — 'cas' or 'sas'
+- limit: number (default: 10) — page size
+- start: number (default: 1) — 1-based offset
+- where: string — optional filter expression
+
+ROUTING RULES
+- "list tables in Samples" → { lib: "Samples", start: 1, limit: 10 }
+- "list 25 tables in sashelp" → { lib: "sashelp", limit: 25, start: 1 }
+- "list cas tables in Public" → { lib: "Public", server: "cas", start: 1, limit: 10 }
+
+EXAMPLES
+- "list tables in Samples" → { lib: "Samples", start: 1, limit: 10 }
+- "show 25 tables in sashelp" → { lib: "sashelp", limit: 25, start: 1 }
+
+NEGATIVE EXAMPLES (do not route here)
+- "list libs" (use list-libraries)
+- "find lib Public" (use find-library)
+- "describe table cars" (use table-info)
+- "read table cars" (use read-table)
+
+ERRORS
+Returns empty array if no tables found.
+  `;
+    
+  let spec = {
+    name: 'list-tables',
+    description: description,
+
+    inputSchema: z.object({
+      lib: z.string(),
+      server: z.string().optional(),
+      limit: z.number().optional(),
+      start: z.number().optional(),
+      where: z.string().optional()
+    }),
+    handler: async (params) => { 
+      let r = await _listTables(params);
+      return r;
+    }
+  }
+  return spec;
+}
+
+export default listTables;
+

package/src/toolSet/makeTools.js

@@ -27,6 +27,8 @@ import runJobdef from './runJobdef.js';
 import findJob from './findJob.js';
 import listJobdefs from './listJobdefs.js';
 import findJobdef from './findJobdef.js';
+import jobInfo from './jobInfo.js';
+import jobdefInfo from './jobdefInfo.js';
 
 import sasQuery from './sasQuery.js';
 import setContext from './setContext.js';
@@ -63,6 +65,7 @@ function makeTools(_appContext) {
     runJob(_appContext),
     listJobdefs(_appContext),
     findJobdef(_appContext),
+    jobdefInfo(_appContext),
     runJobdef(_appContext),
 
     devaScore(_appContext),

package/src/toolSet/modelInfo.js

@@ -10,7 +10,7 @@ const log = debug('tools');
 
 function modelInfo(_appContext) {
   let description = `
-model-info — retrieve detailed metadata for a deployed model.
+model-info — return detailed information about a specific MAS model, including its inputs, outputs, and metadata.
 
 USE when: what inputs does model need, describe model, show variables for model, model inputs/outputs
 DO NOT USE for: find model, list models, score model, table/job operations

package/src/toolSet/modelScore.js

@@ -17,16 +17,16 @@ DO NOT USE for: find model, model metadata, list models, run programs/jobs, quer
 
 PARAMETERS
 - model: string — model name (required, exact match)
-- scenario: string | object | array — input data (required). Accepts: "x=1, y=2", {x:1, y:2}, or array of objects
-- uflag: boolean (default: false) — prefix model fields with underscore when true
+- scenario: object — input data as JSON (optional, defaults to {}). Example: {age:45, income:60000}
+
 
 ROUTING RULES
-- "score with model X using a=1, b=2" → { model: "X", scenario: {a:1, b:2}, uflag: false }
-- "predict using model Y with age=45, income=60000" → { model: "Y", scenario: {age:45, income:60000}, uflag: false }
+- "score with model X using a=1, b=2" → { model: "X", scenario: {a:1, b:2} }
+- "predict using model Y with age=45, income=60000" → { model: "Y", scenario: {age:45, income:60000} }
 
 EXAMPLES
-- "score with model churn using age=45, income=60000" → { model: "churn", scenario: {age:45, income:60000}, uflag: false }
-- "predict creditScore for credit=700, debt=20000" → { model: "creditScore", scenario: {credit:700, debt:20000}, uflag: false }
+- "score with model churn using age=45, income=60000" → { model: "churn", scenario: {age:45, income:60000} }
+- "predict creditScore for credit=700, debt=20000" → { model: "creditScore", scenario: {credit:700, debt:20000} }
 
 NEGATIVE EXAMPLES (do not route here)
 - "find model X" (use find-model)
@@ -42,40 +42,38 @@ Returns predictions, probabilities, scores merged with input data. Returns error
   let spec = {
     name: 'mas-score',
     description: description,
-    inputSchema:z.object({
+    inputSchema: z.object({
       model: z.string(),
-      scenario: z.string(),
-      uflag: z.boolean().optional()
+      scenario: z.any()
     }),
       
     handler: async (iparams) => {
-      let params = {...iparams}; 
+      let params = {...iparams};
       let scenario = params.scenario;
-   
-        // Convert the scenario string to an object
-        // Example: "x=1, y=2, z=3" to { x: 1, y: 2, z: 3 }
-      let scenarioObj ={};
-       let count = 0;
+
+      // Convert the scenario string to an object
+      // Example: "x=1, y=2, z=3" to { x: 1, y: 2, z: 3 }
+      let scenarioObj = {};
+      let count = 0;
       if (typeof scenario === 'object') {
         scenarioObj = scenario;
-      } else if (Array.isArray(scenario)) { 
+      } else if (Array.isArray(scenario)) {
         scenarioObj = scenario[0];
       } else {
         //console.error('Incoming scenario', scenario);
         scenarioObj = scenario.split(',').reduce((acc, pair) => {
-            let [key, value] = pair.split('=');
-            acc[key.trim()] = value;
-            count++;
-            return acc;
-          }, {});
-        }
-      params.scenario= scenarioObj;
-      
+          let [key, value] = pair.split('=');
+          acc[key.trim()] = value;
+          count++;
+          return acc;
+        }, {});
+      }
+      params.scenario = scenarioObj;
       // Drop model extension (e.g., .job, .model)
       if (params.model && params.model.includes('.')) {
         params.model = params.model.substring(0, params.model.lastIndexOf('.'));
       }
-      
+  
       log('modelScore params', params);
       // Check if the params.scenario is a string and parse it
       let r = await _masScoring(params)