@sassoftware/sas-score-mcp-serverjs 0.4.0 → 0.4.1-15

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',
-    aliases: ['listModels','list models','list_models'],
-    description: description,
-    schema: {
-      'limit': z.number().default(10),
-      'start': z.number().default(1) 
-        },
-    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',
-      aliases: ['listTables','list tables','list_tables'],
-    description: description,
-
-    schema: {
-      'lib': z.string(),
-      'server': z.string().default('cas'),
-      'limit': z.number().default(10),
-      'start': z.number().default(1)
-    },
-    required: ['lib'],
-    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

@@ -30,7 +30,7 @@ import findJobdef from './findJobdef.js';
 
 import sasQuery from './sasQuery.js';
 import setContext from './setContext.js';
-//import scoreSkill from './scoreSkill.js';
+
 
 function makeTools(_appContext) {
   // wrap all tools with 
@@ -65,8 +65,6 @@ function makeTools(_appContext) {
     findJobdef(_appContext),
     runJobdef(_appContext),
 
-    //scoreSkill(_appContext),
-
     devaScore(_appContext),
     setContext(_appContext)
     

package/src/toolSet/modelInfo.js

@@ -39,12 +39,10 @@ Returns model metadata: inputs (name, type, role), outputs (name, type, possible
 
   let spec = {
     name: 'model-info',
-    aliases: ['modelInfo','model info','model_info'],
     description: description,
-    schema: {
-      'model': z.string()
-    },
-    required: ['model'],
+    inputSchema: z.object({
+      model: z.string()
+    }),
     handler: async (params) => {
       let r = await _masDescribe(params);
       return r;
@@ -54,3 +52,4 @@ Returns model metadata: inputs (name, type, role), outputs (name, type, possible
 }
 
 export default modelInfo;
+

package/src/toolSet/modelScore.js

@@ -41,14 +41,13 @@ Returns predictions, probabilities, scores merged with input data. Returns error
  
   let spec = {
     name: 'model-score',
-    aliases: ['modelScore','model score','model_score'],
     description: description,
-    schema: {
-      'model': z.string(),
-      'scenario': z.any(),
-      'uflag': z.boolean()
-    },
-    required: ['model', 'scenario'],
+    inputSchema:z.object({
+      model: z.string(),
+      scenario: z.string(),
+      uflag: z.boolean().optional()
+    }),
+      
     handler: async (iparams) => {
       let params = {...iparams}; 
       let scenario = params.scenario;
@@ -87,3 +86,4 @@ Returns predictions, probabilities, scores merged with input data. Returns error
 }
 
 export default modelScore;
+

package/src/toolSet/readTable.js

@@ -1,67 +1,63 @@
-/*
- * 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 _readTable from  '../toolHelpers/_readTable.js';
-function readTable(_appContext) {
-   
-     let describe = `
-read-table — retrieve rows from a table in a CAS or SAS library.
-
-USE when: read table, show rows, read from library, filtered data with WHERE
-DO NOT USE for: list tables, table structure (use table-info), SQL queries (use sas-query), SAS programs
-
-PARAMETERS
-- table: string — table name (required)
-- lib: string — caslib or libref (required)
-- server: string (default: 'cas') — 'cas' or 'sas'
-- start: number (default: 1) — 1-based row index
-- limit: number (default: 10) — max rows (1-1000)
-- where: string — SQL WHERE clause filter
-- format: boolean (default: true) — formatted or raw values
-
-ROUTING RULES
-- "read table cars in Samples" → { table: "cars", lib: "Samples", start: 1, limit: 10 }
-- "show 25 rows from customers" → { table: "customers", lib: "<lib>", limit: 25, start: 1 }
-- "read from mylib.orders where status='shipped'" → { table: "orders", lib: "mylib", where: "status='shipped'", start: 1, limit: 10 }
-
-EXAMPLES
-- "read table cars in Samples" → { table: "cars", lib: "Samples", start: 1, limit: 10 }
-- "show 25 rows from customers" → { table: "customers", lib: "mylib", limit: 25, start: 1 }
-
-NEGATIVE EXAMPLES (do not route here)
-- "list tables in Samples" (use list-tables)
-- "what columns are in cars" (use table-info)
-- "execute SQL query" (use sas-query)
-- "run SAS code" (use run-sas-program)
-
-ERRORS
-Returns rows array, total count, filtered_count, columns metadata. Empty array if no matches.
-  `;
-  
-    let  specs = {
-      name: 'read-table',
-      aliases: ['readTable','read table','read_table'],
-      description: describe,
-      schema: {
-        table: z.string(),
-        lib: z.string(),
-        start: z.number(),
-        limit: z.number().default(10),
-        server: z.string().default('cas'),
-        where: z.string().default(''),
-        format: z.boolean().default(true)
-
-      },
-      required: ['table', 'lib'],
-      handler: async (params) => {
-        let r = await _readTable(params,'query');
-        return r;
-      }
-    }
-    return specs;
-}
-export default readTable;
+/*
+ * 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 _readTable from  '../toolHelpers/_readTable.js';
+function readTable(_appContext) {
+   
+     let describe = `
+read-table — retrieve rows from a table in a CAS or SAS library.
+
+USE when: read table, show rows, read from library, filtered data with WHERE
+DO NOT USE for: list tables, table structure (use table-info), SQL queries (use sas-query), SAS programs
+
+PARAMETERS
+- table: string — table name (required)
+- lib: string — caslib or libref (required)
+- server: string (default: 'cas') — 'cas' or 'sas'
+- start: number (default: 1) — 1-based row index
+- limit: number (default: 10) — max rows (1-1000)
+- where: string — SQL WHERE clause filter
+- format: boolean (default: true) — formatted or raw values
+
+ROUTING RULES
+- "read table cars in Samples" → { table: "cars", lib: "Samples", start: 1, limit: 10 }
+- "show 25 rows from customers" → { table: "customers", lib: "<lib>", limit: 25, start: 1 }
+- "read from mylib.orders where status='shipped'" → { table: "orders", lib: "mylib", where: "status='shipped'", start: 1, limit: 10 }
+
+EXAMPLES
+- "read table cars in Samples" → { table: "cars", lib: "Samples", start: 1, limit: 10 }
+- "show 25 rows from customers" → { table: "customers", lib: "mylib", limit: 25, start: 1 }
+
+NEGATIVE EXAMPLES (do not route here)
+- "list tables in Samples" (use list-tables)
+- "what columns are in cars" (use table-info)
+- "execute SQL query" (use sas-query)
+- "run SAS code" (use run-sas-program)
+
+ERRORS
+Returns rows array, total count, filtered_count, columns metadata. Empty array if no matches.
+  `;
+  
+    let  specs = {
+      name: 'read-table',
+      description: describe,
+      inputSchema: z.object({
+        table: z.string(),
+        lib: z.string().optional(),
+        start: z.number().optional(),
+        limit: z.number().optional(),
+        server: z.string().optional(),
+        where: z.string().optional()
+      }),
+    handler: async (params) => {
+        let r = await _readTable(params,'query');
+        return r;
+      }
+    }
+    return specs;
+}
+export default readTable;

package/src/toolSet/runCasProgram.js

@@ -41,21 +41,20 @@ Log output and CAS results. If output table specified, returned as markdown tabl
 `;
 
   let spec = {
-    name: 'run-sas-program',
-    aliases: ['Program','run program'],
+    name: 'run-cas-program',
     description: description,
-    schema: {
+    inputSchema:z.object({
       src: z.string(),
-      scenario: z.any().default(''),
-      output: z.string().default(''),
-      folder: z.string().default(''),
-      limit: z.number().default(100)
-    },
+      scenario: z.string(),
+      output: z.string().optional,
+      folder: z.string().optional,
+      limit: z.number().optional
+    }),
+    
   // NOTE: Previously 'required' incorrectly listed 'program' which does not
   // exist in the schema. This prevented execution in some orchestrators that
   // enforce required parameter presence, causing only descriptions to appear.
   // Corrected to 'src'.
-  required: ['src'],
     handler: async (params) => {
       let {src, folder, scenario, _appContext} = params;
       // figure out src
@@ -96,3 +95,4 @@ Log output and CAS results. If output table specified, returned as markdown tabl
 }
 
 export default runCasProgram;
+

package/src/toolSet/runJob.js

@@ -1,82 +1,81 @@
-/*
- * Copyright © 2025, SAS Institute Inc., Cary, NC, USA.  All Rights Reserved.
- * SPDX-License-Identifier: Apache-2.0
- */
-
-import { z } from 'zod';
-import _jobSubmit from '../toolHelpers/_jobSubmit.js';
-
-function runJob(_appContext) {
- 
-  let description = `
-run-job — execute a deployed SAS Viya job.
-
-USE when: run job, execute job, run with parameters
-DO NOT USE for: arbitrary SAS code (use run-sas-program), macros (use run-macro), list/find jobs
-
-PARAMETERS
-- name: string — job name (required)
-- scenario: string | object — input parameters. Accepts: "x=1, y=2" or {x:1, y:2}
-
-ROUTING RULES
-- "run job xyz" → { name: "xyz" }
-- "run job xyz with param1=10, param2=val2" → { name: "xyz", scenario: {param1:10, param2:"val2"} }
-
-EXAMPLES
-- "run job xyz" → { name: "xyz" }
-- "run job monthly_etl with month=10, year=2025" → { name: "monthly_etl", scenario: {month:10, year:2025} }
-
-NEGATIVE EXAMPLES (do not route here)
-- "run SAS code" (use run-sas-program)
-- "run macro X" (use run-macro)
-- "list jobs" (use list-jobs)
-- "find job X" (use find-job)
-
-ERRORS
-Returns log output, listings, tables from job. Error if job not found.
-`;
-
-  let spec = {
-    aliases: ['run job', 'run-job', 'runjob'],
-    name: 'run-job',
-    description: description,
-    schema: {
-      name: z.string(),
-      scenario: z.any().default(''),
-    },
-    required: ['name'],
-    handler: async (params) => {
-      let scenario = params.scenario;
-      let scenarioObj = {};
-      let count = 0;
-      // 
-      if (scenario == null) {
-        scenarioObj = {};
-      } else if (typeof scenario === 'object') {
-        scenarioObj = scenario;
-      } else if (Array.isArray(scenario)) {
-        scenarioObj = scenario[0];
-      } else if (typeof scenario === 'string') {
-        if (scenario.trim() === '') {
-          scenarioObj = {};
-        } 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.type = 'job';
-      params.scenario = scenarioObj;
-      // Provide runtime context for auth and server settings
-      let r = await _jobSubmit(params);
-      return r;
-    }
-  };
-  return spec;
-}
-
-export default runJob;
+/*
+ * Copyright © 2025, SAS Institute Inc., Cary, NC, USA.  All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import { z } from 'zod';
+import _jobSubmit from '../toolHelpers/_jobSubmit.js';
+
+function runJob(_appContext) {
+ 
+  let description = `
+run-job — execute a deployed SAS Viya job.
+
+USE when: run job, execute job, run with parameters
+DO NOT USE for: arbitrary SAS code (use run-sas-program), macros (use run-macro), list/find jobs
+
+PARAMETERS
+- name: string — job name (required)
+- scenario: string | object — input parameters. Accepts: "x=1, y=2" or {x:1, y:2}
+
+ROUTING RULES
+- "run job xyz" → { name: "xyz" }
+- "run job xyz with param1=10, param2=val2" → { name: "xyz", scenario: {param1:10, param2:"val2"} }
+
+EXAMPLES
+- "run job xyz" → { name: "xyz" }
+- "run job monthly_etl with month=10, year=2025" → { name: "monthly_etl", scenario: {month:10, year:2025} }
+
+NEGATIVE EXAMPLES (do not route here)
+- "run SAS code" (use run-sas-program)
+- "run macro X" (use run-macro)
+- "list jobs" (use list-jobs)
+- "find job X" (use find-job)
+
+ERRORS
+Returns log output, listings, tables from job. Error if job not found.
+`;
+
+  let spec = {
+    name: 'run-job',
+    description: description,
+    inputSchema: z.object({
+      name: z.string(),
+      scenario: z.string().optional()
+    }),
+    handler: async (params) => {
+      let scenario = params.scenario;
+      let scenarioObj = {};
+      let count = 0;
+      // 
+      if (scenario == null) {
+        scenarioObj = {};
+      } else if (typeof scenario === 'object') {
+        scenarioObj = scenario;
+      } else if (Array.isArray(scenario)) {
+        scenarioObj = scenario[0];
+      } else if (typeof scenario === 'string') {
+        if (scenario.trim() === '') {
+          scenarioObj = {};
+        } 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.type = 'job';
+      params.scenario = scenarioObj;
+      // Provide runtime context for auth and server settings
+      let r = await _jobSubmit(params);
+      return r;
+    }
+  };
+  return spec;
+}
+
+export default runJob;
+