@sassoftware/sas-score-mcp-serverjs 1.0.1-30 → 1.0.1-32

package/src/toolSet/{listModels.js → listMas.js}

@@ -1,56 +1,61 @@
-/*
- * 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 _listMas from '../toolHelpers/_listMas.js';
+
+function listMas(_appContext) {
+  let description = `
+list-mas — enumerate models published to MAS.
+
+USE when: list models, show models, list mas, show mas next page
+DO NOT USE for: find model, find mas, 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 }
+- "list mas" → { start:1, limit:10 }
+- "list 25 mas" → { start:1, limit:25 }
+- "next mas" → { start: start+limit, limit:10 }
+
+EXAMPLES
+- "list models" → { start:1, limit:10 }
+- "list 25 models" → { start:1, limit:25 }
+- "list mas" → { start:1, limit:10 }
+- "list 25 mas" → { 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-mas',
+    description: description,
+    inputSchema: z.object({
+      limit: z.number().optional(),
+      start: z.number().optional()
+    }),
+    handler: async (params) => { 
+      let r  = await _listMas(params);
+      return r;
+    }
+  }
+  
+  return spec;
+}
+
+export default listMas;
+

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

@@ -3,22 +3,28 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 
-import listModels from './listModels.js';
-import listTables from './listTables.js';
-import modelScore from './modelScore.js';
-import modelInfo from './modelInfo.js';
+import listMas from './listMas.js';
+
+
+import masScore from './masScore.js';
+import masInfo from './masInfo.js';
+import findMas from './findMas.js';
+
 import findLibrary from './findLibrary.js';
-import readTable from './readTable.js';
-import tableInfo from './tableInfo.js';
 import listLibraries from './listLibraries.js';
 
+import listTables from './listTables.js';
+import findTable from './findTable.js';
+import tableInfo from './tableInfo.js';
+import readTable from './readTable.js';
+
 import scrInfo from './scrInfo.js';
 import scrScore from './scrScore.js';
 
 import devaScore from './devaScore.js';
 
-import findTable from './findTable.js';
-import findModel from './findModel.js';
+
+
 import runProgram from './runProgram.js';
 import runMacro from './runMacro.js';
 import runJob from './runJob.js';
@@ -27,6 +33,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';
@@ -38,11 +46,11 @@ function makeTools(_appContext) {
 
   // get the tool definitions and handler 
   let list = [
-    listModels(_appContext),
+    listMas(_appContext),
     
-    findModel(_appContext),
-    modelInfo(_appContext),
-    modelScore(_appContext),
+    findMas(_appContext),
+    masInfo(_appContext),
+    masScore(_appContext),
 
     scrInfo(_appContext),
     scrScore(_appContext),
@@ -63,6 +71,7 @@ function makeTools(_appContext) {
     runJob(_appContext),
     listJobdefs(_appContext),
     findJobdef(_appContext),
+    jobdefInfo(_appContext),
     runJobdef(_appContext),
 
     devaScore(_appContext),

package/src/toolSet/{modelInfo.js → masInfo.js}

@@ -8,9 +8,9 @@ import debug from 'debug';
 import _masDescribe from '../toolHelpers/_masDescribe.js';
 const log = debug('tools');
 
-function modelInfo(_appContext) {
+function masInfo(_appContext) {
   let description = `
-model-info — retrieve detailed metadata for a deployed model.
+mas-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
@@ -19,26 +19,26 @@ PARAMETERS
 - model: string — model name (required, exact match)
 
 ROUTING RULES
-- "what inputs does model X need?" → { model: "X" }
-- "describe model Y" → { model: "Y" }
-- "show variables for Z" → { model: "Z" }
+- "what inputs does mas X need?" → { model: "X" }
+- "describe mas Y" → { model: "Y" }
+- "show variables for mas Z" → { model: "Z" }
 
 EXAMPLES
-- "What inputs does model churnRisk need?" → { model: "churnRisk" }
-- "Describe model creditScore" → { model: "creditScore" }
+- "What inputs does mas churnRisk need?" → { model: "churnRisk" }
+- "Describe mas creditScore" → { model: "creditScore" }
 - "Show variables for myModel" → { model: "myModel" }
 
 NEGATIVE EXAMPLES (do not route here)
-- "list models" (use list-models)
-- "find model X" (use find-model)
-- "score with model X" (use model-score)
+- "list mas" (use list-models)
+- "find mas X" (use find-model)
+- "score with mas X" (use model-score)
 
 ERRORS
 Returns model metadata: inputs (name, type, role), outputs (name, type, possible_values), model_type, description.
   `;
 
   let spec = {
-    name: 'model-info',
+    name: 'mas-info',
     description: description,
     inputSchema: z.object({
       model: z.string()
@@ -51,5 +51,5 @@ Returns model metadata: inputs (name, type, role), outputs (name, type, possible
   return spec;
 }
 
-export default modelInfo;
+export default masInfo;
 

package/src/toolSet/{modelScore.js → masScore.js}

@@ -8,7 +8,7 @@ import debug from 'debug';
 import _masScoring from '../toolHelpers/_masScoring.js';
 const log = debug('tools');
 
-function modelScore(_appContext) {
+function masScore(_appContext) {
   let description = `
 mas-score — score data using a deployed model on MAS.
 
@@ -74,7 +74,7 @@ Returns predictions, probabilities, scores merged with input data. Returns error
         params.model = params.model.substring(0, params.model.lastIndexOf('.'));
       }
   
-      log('modelScore params', params);
+      log('masScore params', params);
       // Check if the params.scenario is a string and parse it
       let r = await _masScoring(params)
       return r;
@@ -83,5 +83,5 @@ Returns predictions, probabilities, scores merged with input data. Returns error
   return spec;
 }
 
-export default modelScore;
+export default masScore;
 

package/src/toolSet/readTable.js

@@ -1,63 +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',
-      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;
+/*
+ * 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;