@sassoftware/sas-score-mcp-serverjs 1.0.1-9 → 1.1.1

package/src/toolHelpers/_casScore.js

@@ -0,0 +1,32 @@
+/*
+ * Copyright © 2025, SAS Institute Inc., Cary, NC, USA.  All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import restaflib from '@sassoftware/restaflib';
+import restaf from '@sassoftware/restaf';
+async function _casScore(params) {
+  let { model, name, scenario, _appContext } = params;
+  let { casSetup, caslScore } = restaflib;
+
+  let store = restaf.initStore(_appContext.storeConfig);
+  let { session } = await casSetup(store, _appContext.logonPayload, null, _appContext.cas);
+  if (session == null) {
+    return { content: [{ type: 'text', text: 'Could not create a cas session' }] };
+  }
+
+  try {
+    let args = {
+      name: name,
+      modelName: model,
+      scenario: scenario
+    }
+    let output = await caslScore(store, session, args);
+    let results = output.casResults;
+    return { content: [{ type: 'text', text: JSON.stringify(results) }], structuredContent: results };
+  } catch (err) {
+    console.log(err);
+    return { isError: true, content: [{ type: 'text', text: JSON.stringify(err) }] };
+  }
+}
+export default _casScore;

package/src/toolHelpers/_desc.js

@@ -0,0 +1,14 @@
+/*
+ * Copyright © 2025, SAS Institute Inc., Cary, NC, USA.  All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+/**
+ * Return lean description in agent mode, full description in standalone mode.
+ * @param {object} appContext  - the _appContext passed to every tool factory
+ * @param {string} lean        - short description for agent mode (~3-6 lines)
+ * @param {string} full        - full description for standalone mode
+ */
+export function desc(appContext, lean, full) {
+  return (appContext && appContext.agent) ? lean : full;
+}

package/src/toolHelpers/_findJob.js

@@ -0,0 +1,12 @@
+/*
+ * Copyright © 2025, SAS Institute Inc., Cary, NC, USA.  All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import _listJobs from './_listJobs.js';  
+async function _findJob(params) {
+    let r = await _listJobs(params);
+    console.error ("findJob result:" , r);
+    return r;
+}
+export default _findJob;

package/src/toolHelpers/_findJobdef.js

@@ -0,0 +1,10 @@
+/*
+ * Copyright © 2025, SAS Institute Inc., Cary, NC, USA.  All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import _listJobdefs from './_listJobdefs.js';  
+async function _findJobdef(params) {
+    return  await _listJobdefs(params);
+}
+export default _findJobdef;

package/src/toolHelpers/_findLibrary.js

@@ -0,0 +1,11 @@
+/*
+ * Copyright © 2025, SAS Institute Inc., Cary, NC, USA.  All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import _listLibrary from './_listLibrary.js';  
+async function _findLibrary(params) {
+    params.tool = 'find';
+    return  await _listLibrary(params);
+}
+export default _findLibrary;

package/src/toolHelpers/_findMas.js

@@ -0,0 +1,13 @@
+/*
+ * Copyright © 2025, SAS Institute Inc., Cary, NC, USA.  All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import _listMas from './_listMas.js';  
+async function _findMas(params) {
+    params.tool = 'find';
+    let r = await _listMas(params);
+    console.log ("findMas result:" , r);
+    return r;
+}
+export default _findMas;

package/src/toolHelpers/_findScr.js

@@ -0,0 +1,36 @@
+/**
+ * Copyright © 2025, SAS Institute Inc., Cary, NC, USA.  All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import axios from 'axios';
+
+async function _findScr(params) {
+  let {name} = params;
+  let config = {
+    method: 'HEAD',
+    name: name + '/apiMeta/api',
+    headers: {
+      'Accept': 'application/json'
+    }
+  }
+  try {
+    console.error('[Note] Config:', config);
+    let response = await axios(config);
+    console.error('[Note] Response status:', response.status);
+    if (response.status !== 200) {
+      
+      return {isError: true, content: [{ type: 'text', text: `SCR model ${name} not found` }]};
+    } else if (response.status === 200) {
+      let r = { scr: [name] };
+      return { content: [{ type: 'text', text: JSON.stringify(r) }],
+        structuredOutput: r
+
+      };
+    }
+  }
+  catch (error) {
+    return {isError: true,content: [{ type: 'text', text: JSON.stringify(error) }]};  
+  }
+}
+export default _findScr;

package/src/toolHelpers/_findTable.js

@@ -0,0 +1,11 @@
+/*
+ * Copyright © 2025, SAS Institute Inc., Cary, NC, USA.  All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import _listTables from './_listTables.js';
+async function _findTable(params) {
+  params.tool = 'find';
+  return await _listTables(params);
+}
+export default _findTable;

package/src/toolHelpers/_listJobdefs.js

@@ -6,7 +6,7 @@ import restaf from '@sassoftware/restaf';
 
 
 async function _listJobdefs(params) {
-  let { limit, start, name, _appContext } = params;
+  let { limit, start, name, tool, _appContext } = params;
   
   let store = restaf.initStore(_appContext.storeConfig);
   let msg = await store.logon(_appContext.logonPayload);
@@ -41,7 +41,17 @@ async function _listJobdefs(params) {
 
     let response = {jobDefinitions: Object.keys(names)};
     if (name != null) {
-      response = { name: name, parameters: names[name].parameters };
+      if (tool === 'find') {
+        response = { job: [name] };
+      } else if (tool === 'describe') {
+        let p = [];
+        names[name].parameters.map((v, k) => {
+          if (v.name.startsWith('_') === false) {
+            p.push(v);
+          }
+        });
+        response = { describe: p };
+      };
     }
 
     return {

package/src/toolHelpers/_listJobs.js

@@ -6,7 +6,7 @@
 import restaf from '@sassoftware/restaf';
 
 async function _listJobs(params) {
-  let { limit, start, name, _appContext } = params;
+  let { limit, start, name, tool, _appContext } = params;
 
   let store = restaf.initStore(_appContext.storeConfig);
   let msg = await store.logon(_appContext.logonPayload);
@@ -33,21 +33,32 @@ async function _listJobs(params) {
     }
 
     let names = {};
-    
+
     jobList.itemsList().map((id, n) => {
       let jname = jobList.items(id, 'data', 'jobRequest', 'name');
-      
+
       if (names[jname] == null) {
         let value = jobList.items(id, 'data', 'jobRequest', 'jobDefinition', 'parameters');
-        names[jname] = {parameters: (value == null) ? {} : value.toJS() };
+        names[jname] = { parameters: (value == null) ? {} : value.toJS() };
       }
     });
-
-    let response  = {jobs: Object.keys(names)};
+    console.error('parameters', JSON.stringify(names, null, 2));
+    let response = { jobs: Object.keys(names) };
+    console.error('response', JSON.stringify(response, null, 2));
 
     if (name != null) {
-      response = { name: name, parameters: names[name].parameters };
-    };
+      if (tool === 'find') {
+        response = { job: [name] };
+      } else if (tool === 'describe') {
+        let p = [];
+        names[name].parameters.map((v, k) => {
+          if (v.name.startsWith('_') === false) {
+            p.push(v);
+          }
+        });
+        response = { describe: p };
+      };
+    }
     return {
       content: [{ type: 'text', text: JSON.stringify(response) }],
       structuredContent: response,

package/src/toolHelpers/{_listModels.js → _listMas.js}

@@ -5,7 +5,7 @@
 
 import restaf from '@sassoftware/restaf';
 
-async function _listModels(params) {
+async function _listMas(params) {
   let { limit, start , name, _appContext} = params;;
   // setup
 
@@ -27,9 +27,9 @@ async function _listModels(params) {
     }
     let result = await store.apiCall(microanalyticScore.links('modules'), payload);
     if (result.itemsList().size === 0) {
-      return { content: [{ type: 'text', text: `No models exist in MAS server` }]};
+      return { content: [{ type: 'text', text: `No MAS exist in MAS server` }]};
     }
-    let list = {models: result.itemsList().toJS()};
+    let list = {mas: result.itemsList().toJS()};
     return { content: [{ type: 'text', text: JSON.stringify(list) }],
       structuredContent: list
     };
@@ -38,4 +38,4 @@ async function _listModels(params) {
   }
 }
 
-export default _listModels;
+export default _listMas;

package/src/toolHelpers/_listScr.js

@@ -0,0 +1,13 @@
+/*
+ * Copyright © 2025, SAS Institute Inc., Cary, NC, USA.  All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+async function _listScr(params) {
+  let response = { scr: [] };
+  return {
+    content: [{ type: 'text', text: JSON.stringify(response) }],
+    structuredContent: response
+  }
+}
+export default _listScr;

package/src/toolHelpers/{_scrInfo.js → _scrDescribe.js}

@@ -5,11 +5,11 @@
 
 import axios from 'axios';
 
-async function _scrInfo(params) {
-  let {url} = params;
+async function _scrDescribe(params) {
+  let {name} = params;
   let config = {
     method: 'GET',
-    url: url + '/apiMeta/api',
+    name: name + '/apiMeta/api',
     headers: {
       'Accept': 'application/json'
     }
@@ -29,4 +29,4 @@ async function _scrInfo(params) {
     return {isError: true,content: [{ type: 'text', text: JSON.stringify(error) }]};  
   }
 }
-export default _scrInfo;
+export default _scrDescribe;

package/src/toolHelpers/_scrScore.js

@@ -7,7 +7,7 @@ import axios from 'axios';
 
 
 async function _scrScore(params) {
-  let { url, scenario} = params;
+  let { name, scenario} = params;
  
 
   let data = scenario.split(',').reduce((acc, pair) => {
@@ -18,7 +18,7 @@ async function _scrScore(params) {
 
   let config = {
     method: 'POST',
-    url: url,
+    name: name,
     headers: {
       'Content-Type': 'application/json',
       'Accept': 'application/json'

package/src/toolHelpers/_submitCasl.js

@@ -2,33 +2,35 @@
  * Copyright © 2025, SAS Institute Inc., Cary, NC, USA.  All Rights Reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
+import restaf from '@sassoftware/restaf';
 import restaflib from '@sassoftware/restaflib';
 
 async function _submitCasl(params) {
   let { src, args, _appContext } = params;
+  let { casSetup, caslRun } = restaflib;
+  console.error(_appContext);
+  let store = restaf.initStore(_appContext.storeConfig);
 
-   let store = restaf.initStore(_appContext.storeConfig);
-  
-  let session = await restaflib.casSetup(store, _appContext.logonPayload, null, _appContext.cas);
+  let { session } = await casSetup(store, _appContext.logonPayload, null, _appContext.cas);
   if (session == null) {
-    return {content: [{ type: 'text', text: 'Could not create a cas session' }]};
+    return { content: [{ type: 'text', text: 'Could not create a cas session' }] };
   }
 
   try {
-    try {
-      let r = await caslRun(store, session, src, (args == null) ? {} : args, true);
-      await store.apiCall( session.links( 'delete' ) );
-    
-      return {content: [{ type: 'text', text: JSON.stringify(r.items()) }], structuredContent: r.items() };
-    } catch (err) {
-      console.error(err);
-      return { isError: true, content: [{ type: 'text', text: JSON.stringify(err) }] }; 
-    }
-  }
-  catch (err) {
+    console.error(caslRun);
+    debugger;
+    let r = await caslRun(store, session, src, (args == null) ? {} : args);
+    console.error(r.results);
+    let response = (r.results == null) ? r : r.results; 
+    await store.apiCall(session.links('delete'));
+    return { content: [{ type: 'text', text: JSON.stringify(response) }], structuredContent: response };
+  } catch (err) {
     console.error(err);
-    await store.apiCall( session.links( 'delete' ) );
-    return { isError: true, content: [{ type: 'text', text: JSON.stringify(err) }] }; 
+    if (session != null) {
+      await store.apiCall(session.links('delete'));
+    } 
+    return { isError: true, content: [{ type: 'text', text: JSON.stringify(err) }] };
   }
 }
+
 export default _submitCasl;

package/src/toolHelpers/{_tableInfo.js → _tableDescribe.js}

@@ -5,7 +5,7 @@
 import restafedit from '@sassoftware/restafedit';
 import deleteSession from './deleteSession.js';
 
-async function _tableInfo(params) {
+async function _tableDescribe(params) {
   let { table, lib, server, _appContext } = params;
   
 
@@ -69,4 +69,4 @@ async function _tableInfo(params) {
     return { isError: true, content: [{ type: 'text', text: JSON.stringify(err) }] };
   }
 }
-export default _tableInfo;
+export default _tableDescribe;

package/src/toolHelpers/getLogonPayload.js

@@ -58,7 +58,7 @@ async function igetLogonPayload(_appContext) {
 
   // Use user supplied refresh token-
   if (_appContext.AUTHFLOW === "refresh") {
-    console.error("[Note] Using user supplied refresh token", _appContext.REFRESH_TOKEN); 
+    console.error("[Note] Using user supplied refresh token", _appContext.REFRESH_TOKEN.substring(0,20) + "..."); 
     let token = await refreshToken(_appContext,{token: _appContext.REFRESH_TOKEN, host: _appContext.VIYA_SERVER});
     let logonPayload = {
       host: _appContext.VIYA_SERVER,
@@ -71,7 +71,7 @@ async function igetLogonPayload(_appContext) {
   }
   
   if (_appContext.AUTHFLOW === "token") {
-    console.error("[Note] Using token supplied by user");
+    console.error("[Note] Using token supplied by user");  
     let logonPayload = {
       host: _appContext.VIYA_SERVER,
       authType: "server",

package/src/toolSet/casModelScore.js

@@ -0,0 +1,93 @@
+/*
+ * Copyright © 2025, SAS Institute Inc., Cary, NC, USA.  All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import { z } from 'zod';
+import _casScore from '../toolHelpers/_casScore.js';
+
+function casModelScore(_appContext) {
+  const isAgent = _appContext && _appContext.agent;
+
+  let description = isAgent ? `
+cas-model-score — score with a model persisted as a CAS table in a CAS server.
+PARAMS:  name(string, required), model(string, optional),scenario (string|object, optional)
+RETURNS: returns the score for the specified scenario
+Notes: name is specified as a.b.cas where a is the library, b is the CAS table name, and .cas is the suffix. Model parameter is optional and can be used to specify a different model name if it is not the same as the table name.
+` : `
+cas-model-score — execute a CAS model on SAS Viya  cas server.
+
+USE when:  score cas model with scenario
+DO NOT USE for: macros (use ${_appContext.brand}-macro-score), SAS code (use ${_appContext.brand}-program-score), jobs (use ${_appContext.brand}-job-score), jobdefs (use ${_appContext.brand}-jobdef-score), scr(use ${_appContext.brand}-scr-score)
+
+PARAMETERS
+
+- name: string (optional) — CAS model table to use for scoring
+- model: string (optional) — name of the model to use for scoring, if different from the table name
+- scenario: string or object (optional) — input parameters
+
+
+ROUTING RULES
+- "score "mymodel.abc.cas" with scenario "x=1, y=2" → { name: "mymodel.abc", scenario: "x=1, y=2" }
+ 
+
+EXAMPLES
+- "score "mymodel.abc.cas" with scenario "x=1, y=2" → { name: "mymodel.abc", scenario: "x=1, y=2" }
+
+NEGATIVE EXAMPLES (do not route here)
+- "score sas macro" (use ${_appContext.brand}-macro-score)
+- "submit sas code" (use ${_appContext.brand}-program-score)
+- "score job X" (use ${_appContext.brand}-job-score)
+- "score jobdef X" (use ${_appContext.brand}-jobdef-score)
+- "score scr X" (use ${_appContext.brand}-scr-score)
+
+
+
+
+RESPONSE
+Log output and CAS results. If output table is specified, that table's rows up to the limit.
+`;
+
+  let spec = {
+    name: 'cas-model-score',
+    description: description,
+    inputSchema: z.object({
+      scenario: z.any().optional(),
+      model: z.string().optional(),
+      name: z.string()
+    }),
+    handler: async (params) => {
+      let {name, model, scenario, _appContext} = params;
+      // figure out src
+  
+
+      // Convert the scenario string to an object
+      // Example: "x=1, y=2, z=3" to { x: 1, y: 2, z: 3 }
+      let scenarioObj = {};
+      if (typeof scenario === 'object' && scenario !== null) {
+        scenarioObj = scenario;
+      } else if (Array.isArray(scenario)) {
+        scenarioObj = scenario[0];
+      } else if (typeof scenario === 'string' && scenario.includes('=')) {
+        scenarioObj = scenario.split(',').reduce((acc, pair) => {
+          let [key, value] = pair.split('=');
+          acc[key.trim()] = value;
+          return acc;
+        }, {});
+      }
+      params.scenario = scenarioObj;
+
+      let iparms = {
+        args: scenarioObj,
+        model: params.model,
+        name: params.name,
+        _appContext: _appContext
+      }
+      let r =  await _casScore(iparms); 
+      return r;
+    }
+  }
+  return spec;
+}
+
+export default casModelScore;

package/src/toolSet/casProgramScore.js

@@ -0,0 +1,105 @@
+/*
+ * Copyright © 2025, SAS Institute Inc., Cary, NC, USA.  All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import { z } from 'zod';
+import _submitCasl from '../toolHelpers/_submitCasl.js';
+import _casScore from '../toolHelpers/_casScore.js';
+
+function casProgramScore(_appContext) {
+  const isAgent = _appContext && _appContext.agent;
+
+  let description = isAgent ? `
+cas-program-score — execute a CAS program src code or score a persisted CAS model on SAS Viya server.
+PARAMS: src (string, required), model(string,optional), name(string, optional),scenario (string|object, optional), output (string, optional), limit (number, optional)
+RETURNS: log output and CAS results, optional output table rows
+` : `
+cas-program-score — execute a CAS program model on SAS Viya server.
+
+USE when: score cas program, run cas program,  submit CASL, score cas model with scenario
+DO NOT USE for: macros (use ${_appContext.brand}-macro-score), SAS code (use ${_appContext.brand}-program-score), jobs (use ${_appContext.brand}-job-score), jobdefs (use ${_appContext.brand}-jobdef-score), scr(use ${_appContext.brand}-scr-score)
+
+PARAMETERS
+- src: string (required) — CAS program or CASL code to execute verbatim
+- casmodel: string (optional) — CAS model table to use for scoring
+- name: string (optional) — name of the model to use for scoring, if different from the table name
+- scenario: string or object (optional) — input parameters
+- output: string — table name to return in response
+- limit: number (default: 100) — max rows to return
+
+**NOTE** if both src and casmodel are specified, the casmodel will take precedence
+ROUTING RULES
+- "run cas program "action echo" → { src: "action echo" }
+- "execute cas "action simple.summary" with table=a.b → { src: "action simple.summary",scenario: {
+table: "a.b"} }
+- "score casmodel "mymodel.abc" with scenario "x=1, y=2" → { casmodel: "mymodel.abc", scenario: "x=1, y=2" }
+ 
+
+EXAMPLES
+- "run cas program "action echo" → { src: "action echo" }
+- "score casmodel "mymodel.abc" with scenario "x=1, y=2" → { casmodel: "mymodel.abc", scenario: "x=1, y=2" }
+
+NEGATIVE EXAMPLES (do not route here)
+- "score sas macro" (use ${_appContext.brand}-macro-score)
+- "submit sas code" (use ${_appContext.brand}-program-score)
+- "score job X" (use ${_appContext.brand}-job-score)
+- "score jobdef X" (use ${_appContext.brand}-jobdef-score)
+- "score scr X" (use ${_appContext.brand}-scr-score)
+
+NOTES
+Sends src verbatim without validation. Use parameter scenario to pass arguments. For arbitrary SAS code use ${_appContext.brand}-program-score.
+
+RESPONSE
+Log output and CAS results. If output table is specified, that table's rows up to the limit.
+`;
+
+  let spec = {
+    name: 'cas-program-score',
+    description: description,
+    inputSchema: z.object({
+      src: z.string(),
+      scenario: z.any().optional(),
+      output: z.string().optional(),
+      casmodel: z.string().optional(),
+      name: z.string().optional(),  
+      limit: z.number().optional()
+    }),
+    handler: async (params) => {
+      let {src, scenario, _appContext} = params;
+      // figure out src
+      let isrc = src;
+
+      // Convert the scenario string to an object
+      // Example: "x=1, y=2, z=3" to { x: 1, y: 2, z: 3 }
+      let scenarioObj = {};
+      if (typeof scenario === 'object' && scenario !== null) {
+        scenarioObj = scenario;
+      } else if (Array.isArray(scenario)) {
+        scenarioObj = scenario[0];
+      } else if (typeof scenario === 'string' && scenario.includes('=')) {
+        scenarioObj = scenario.split(',').reduce((acc, pair) => {
+          let [key, value] = pair.split('=');
+          acc[key.trim()] = value;
+          return acc;
+        }, {});
+      }
+      params.scenario = scenarioObj;
+
+      let iparms = {
+        args: scenarioObj,
+        output: params.output,
+        limit: params.limit,
+        src: isrc,
+        model: params.casmodel,
+        name: params.name,
+        _appContext: _appContext
+      }
+      let r = (params.casmodel == null) ? await _submitCasl(iparms) : await _casScore(iparms);
+      return r;
+    }
+  }
+  return spec;
+}
+
+export default casProgramScore;

package/src/toolSet/devaScore.js

@@ -5,12 +5,17 @@
 import { z } from 'zod';
 
 function devaScore(_appContext) {
-
-    let description = `
+  const isAgent = _appContext && _appContext.agent;
+let brand = _appContext.brand + '-';
+    let description = isAgent ? `
+deva-score — run a demonstration scoring calculation.
+PARAMS: a (number, required), b (number, required)
+RETURNS: computed result for a and b
+` : `
 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
+DO NOT USE for: model scoring (use ${brand}model-score), statistical calculations, data lookup
 
 PARAMETERS
 - a: number (required) — first input value
@@ -30,9 +35,9 @@ EXAMPLES
 - "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)
+- "Score this customer with credit model" (use ${brand}model-score)
+- "Calculate the mean of these values" (use ${brand}program-score or ${brand}sas-query)
+- "Statistical analysis of numbers" (use ${brand}sas-query)
 
 RESPONSE
 Returns { score: (a + b) * 42 }