@sassoftware/sas-score-mcp-serverjs 0.0.2

package/src/toolhelpers/_listJobdefs.js

@@ -0,0 +1,59 @@
+/*
+ * Copyright © 2025, SAS Institute Inc., Cary, NC, USA.  All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import restaf from '@sassoftware/restaf';
+
+
+async function _listJobdefs(params) {
+  let { limit, start, name, _appContext } = params;
+  
+  let store = restaf.initStore(_appContext.storeConfig);
+  let msg = await store.logon(_appContext.logonPayload);
+
+  try {
+    let { jobDefinitions } = await store.addServices('jobDefinitions');
+    let payload = {
+      qs: {
+        limit: (limit != null) ? limit : 10,
+        start: start - 1
+      }
+    };
+
+    if (name != null && name.trim().length > 0) {
+      payload.qs = {
+        filter: `eq(name, '${name}')`
+      }
+    }
+    let jobDefList = await store.apiCall(jobDefinitions.links('job-definitions'), payload);
+    if (jobDefList.itemsList().size === 0) {
+      return { content: [{ type: 'text', text: 'No jobDefinitions found' }] };
+    }
+
+    let names = {};
+    jobDefList.itemsList().map((id, n) => {
+      let jname = jobDefList.items(id, 'name');
+      let p = jobDefList.items(id, 'data', 'parameters');
+      if (names[jname] == null) {
+        names[jname] = { parameters: (p == null) ? {} : p.toJS() };
+      }
+    });
+
+    let response = {jobDefinitions: Object.keys(names)};
+    if (name != null) {
+      response = { name: name, parameters: names[name].parameters };
+    }
+
+    return {
+      content: [{ type: 'text', text: JSON.stringify(response) }],
+      structuredContent: response,
+      hint: (Object.keys(names).length === (limit || 10)) ? `next page start=${(start || 1) + (limit || 10)}` : undefined
+    };
+  } catch (err) {
+    console.error('Error in _listJobdefs', err);
+    return { isError: true, content: [{ type: 'text', text: `Error retrieving job definitions: ${err}` }] };
+
+  }
+}
+
+export default _listJobdefs;

package/src/toolhelpers/_listJobs.js

@@ -0,0 +1,63 @@
+/*
+ * Copyright © 2025, SAS Institute Inc., Cary, NC, USA.  All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import restaf from '@sassoftware/restaf';
+
+async function _listJobs(params) {
+  let { limit, start, name, _appContext } = params;
+
+  let store = restaf.initStore(_appContext.storeConfig);
+  let msg = await store.logon(_appContext.logonPayload);
+
+
+  let { jobExecution } = await store.addServices('jobExecution');
+  try {
+    let payload = {
+      qs: {
+        limit: (limit != null) ? limit : 10,
+        start: start - 1
+      }
+    };
+
+    if (name != null && name.trim().length > 0) {
+      payload.qs = {
+        filter: `eq(name, '${name}')`
+      }
+    }
+    console.error('payload', JSON.stringify(payload, null, 2));
+    let jobList = await store.apiCall(jobExecution.links('jobs'), payload);
+    if (jobList.itemsList().size === 0) {
+      return { content: [{ type: 'text', text: 'No jobs found' }] };
+    }
+
+    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() };
+      }
+    });
+
+    let response  = {jobs: Object.keys(names)};
+
+    if (name != null) {
+      response = { name: name, parameters: names[name].parameters };
+    };
+    return {
+      content: [{ type: 'text', text: JSON.stringify(response) }],
+      structuredContent: response,
+      hint: (Object.keys(names).length === (limit || 10)) ? `next page start=${(start || 1) + (limit || 10)}` : undefined
+    };
+  } catch (err) {
+    console.error('Error in _listJobs', err);
+    return { isError: true, content: [{ type: 'text', text: `Error retrieving jobs: ${err}` }] };
+
+  }
+}
+
+export default _listJobs;

package/src/toolhelpers/_listLibrary.js

@@ -0,0 +1,56 @@
+/*
+ * Copyright © 2025, SAS Institute Inc., Cary, NC, USA.  All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import restafedit from '@sassoftware/restafedit';
+import deleteSession from './deleteSession.js';
+
+async function _listLibrary(params ){
+
+  let { server, limit, start, name, _appContext } = params;
+  
+  let config = {
+    casServerName: _appContext.cas,
+    computeContext: _appContext.sas,
+    source: (server === 'sas') ? 'compute' : server,
+    table: null
+  };
+
+  try {
+    // setup request control
+    let appControl = await restafedit.setup(
+      _appContext.logonPayload,
+      config
+      ,null,{},'user',{}, {}, _appContext.storeConfig
+    );
+    
+    // query parameters
+    let payload = {
+      qs: {
+        limit: (limit != null) ? limit : 10,
+        start: start - 1
+      }
+    };
+
+    if (name != null) {
+      payload.qs = {
+        filter: `eq(name, '${name}')`
+      }
+    }
+   
+    let items = await restafedit.getLibraryList(appControl, payload);
+    let response = {libraries: items};
+    await deleteSession(appControl);
+    
+    return { content: [{ type: 'text', text: JSON.stringify(response) }],
+      structuredContent: response
+    };
+  } catch (err) {
+    console.error(JSON.stringify(err));
+    await deleteSession(appControl);
+    return { isError: true, content: [{ type: 'text', text: JSON.stringify(err) }] };
+  }
+}
+
+export default _listLibrary;

package/src/toolhelpers/_listModels.js

@@ -0,0 +1,41 @@
+/*
+ * Copyright © 2025, SAS Institute Inc., Cary, NC, USA.  All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import restaf from '@sassoftware/restaf';
+
+async function _listModels(params) {
+  let { limit, start , name, _appContext} = params;;
+  // setup
+
+  let store = restaf.initStore(_appContext.storeConfig);
+
+  try {
+    await store.logon(_appContext.logonPayload);
+    let { microanalyticScore } = await store.addServices('microanalyticScore');
+    let payload = {
+      qs: {
+        limit: Math.max(limit,1),
+        start:  Math.max(start-1, 0)
+      }
+    }
+    if (name != null) {
+      payload.qs = {
+        filter: `eq(name, '${name}')`
+      } 
+    }
+    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` }]};
+    }
+    let list = {models: result.itemsList().toJS()};
+    return { content: [{ type: 'text', text: JSON.stringify(list) }],
+      structuredContent: list
+    };
+  } catch (err) {
+    return { isError: true, content: [{ type: 'text', text: JSON.stringify(err) }] };
+  }
+}
+
+export default _listModels;

package/src/toolhelpers/_listTables.js

@@ -0,0 +1,52 @@
+/*
+ * Copyright © 2025, SAS Institute Inc., Cary, NC, USA.  All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import restafedit from '@sassoftware/restafedit';
+
+async function _listTables(params) {
+  let { server, lib, limit, start, name, _appContext} = params;
+ 
+  let config = {
+    casServerName: _appContext.cas,
+    computeContext: _appContext.sas,
+    source: (server === 'sas') ? 'compute' : server,
+    table: null
+  };
+  
+  try {
+    let appControl = await restafedit.setup(
+      _appContext.logonPayload,
+      config,
+      null,/* create a session */
+      {},
+      'user',
+      _appContext.storeConfig
+    );
+
+    let payload = {
+      qs: {
+        limit: (typeof limit === 'number') ? limit : 10, // Use provided limit or default to 10
+        start: (typeof start === 'number') ? Math.max(0, start - 1) : 0,
+      }
+    };
+
+    if (name != null) {
+      // Normalize to upper-case to match table name casing in CAS (e.g. COSTCHANGE)
+      const nameVal = ('' + name).toUpperCase();
+      payload.qs.filter = `eq(name, '${nameVal}')`;
+    }
+
+    let items = await restafedit.getTableList(lib, appControl, payload);
+    let response = {tables: items};
+    return {content: [{ type: 'text', text: JSON.stringify(response) }],
+      structuredContent: response};
+  } catch (err) {
+    console.error(JSON.stringify(err));
+    return {isError: true, content: [{ type: 'text', text: JSON.stringify(err) }] }
+  }
+
+};
+
+export default _listTables;

package/src/toolhelpers/_masDescribe.js

@@ -0,0 +1,27 @@
+/*
+ * 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 _masDescribe(params) {
+ // setup
+  let {model, _appContext} = params;
+  let { masSetup, masDescribe } = restaflib;
+  let store = restaf.initStore(_appContext.storeConfig);
+ 
+  try {
+    let masControl = await masSetup(store, [model], _appContext.logonPayload);
+    let describe = await masDescribe(masControl, model, null,true);
+    let response = {decription: describe};
+    return { content: [{ type: 'text', text: JSON.stringify(response) }],
+      structuredContent: response
+     };
+  } catch (err) {
+    console.error(err);
+    return { isError: true, content: [{ type: 'text', text: JSON.stringify(err) }] };
+  }
+}
+
+export default _masDescribe;

package/src/toolhelpers/_masScoring.js

@@ -0,0 +1,64 @@
+/*
+ * 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 _masScoring(params) {
+
+ // setup
+   let {model, scenario, uflag, _appContext} = params;
+  let { masSetup, masDescribe, masRun } = restaflib;
+  let store = restaf.initStore(_appContext.storeConfig);
+
+  let inputs = {};
+  let masControl;
+
+  try {
+   
+    masControl = await masSetup(store, [model], _appContext.logonPayload);
+    let describe = await masDescribe(masControl, model);
+    let inputs = {};
+    let types = {};
+    describe.forEach(d => {
+      inputs[d.name] = null;
+      types[d.name] = d.type;
+    });
+    
+    if (scenario === null) {
+      // if scenario is empty, return the inputs
+      return { content: [{ type: 'text', text: JSON.stringify(inputs) }] };
+    }
+    let iscenario = {};
+    
+    for (let v in inputs) {
+       let v1 = (uflag === true) ? v.substring(0, v.length - 1) : v;
+      let t = (scenario[v1] == null) ? null : scenario[v1];
+      t  = (types[v] === 'decimal' && typeof t === 'string'   ) ? parseFloat(t) : t;
+      iscenario[v] = t; 
+    }
+   
+    let result = await masRun(store, masControl, model, iscenario);
+
+    // add a unique key for the result
+		
+    let r = {...result, ...iscenario};
+    let t = '';
+    let sep = ''
+    for (let k in r) {
+      t += sep + k + '=' + r[k];
+      sep = ', ';
+    }
+  
+    return { content: [{ type: 'text', text: JSON.stringify(r)}], structuredContent: r};
+  
+  } catch (err) {
+    console.error('Error in _masScoring:', err);
+    return { isError: true, content: [{ type: 'text', text: JSON.stringify({ status: { statusCode: 2, msg: err } }) }] };
+  }
+}
+
+export default _masScoring;
+

package/src/toolhelpers/_readTable.js

@@ -0,0 +1,69 @@
+/*
+ * Copyright © 2025, SAS Institute Inc., Cary, NC, USA.  All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import restafedit from '@sassoftware/restafedit';
+import deleteSession from './deleteSession.js';
+
+async function _readTable(params) {
+  let { table, lib, start, limit, server, format, where, _appContext } = params;
+ 
+
+  if (table.includes('.')) {
+    let parts = table.split('.');
+    lib = parts[0];
+    table = parts[1];
+  }
+  let itable = { name: table };
+  if (server === 'cas') {
+    itable.caslib = lib;
+  } else {
+    itable.libref = lib;
+  }
+  let config = {
+    casServerName: _appContext.cas,
+    computeContext: _appContext.sas,
+    source: (server === 'sas') ? 'compute' : server,
+    casServer: _appContext.cas,
+    table: itable,
+
+    initialFetch: {
+      qs: {
+        start: (start == null) ? 0 : start - 1, // Adjust for 0-based index
+        limit: limit,
+        format: format || false,
+        where: where || ''
+      }
+    }
+  };
+
+  let appControl = {};
+  try {
+    appControl = await restafedit.setup(
+      _appContext.logonPayload,
+      config,
+      null,/* create a sessiion */
+      {},
+      'user',
+      _appContext.storeConfig
+    );
+ 
+    await restafedit.scrollTable('first', appControl);
+  
+    let outdata = appControl.state.data.map((d) => {
+      delete d._rowIndex;
+      delete d._modified;
+      delete d._index_;
+      return d;
+    });
+    let tabled = { tabled: outdata };
+    let t = (limit === 1) ? JSON.stringify(outdata[0]) : JSON.stringify(tabled);
+    return { content: [{ type: 'text', text: t }], structuredContent: tabled };
+
+  } catch (err) {
+    await deleteSession(appControl);
+    return { isError: true, content: [{ type: 'text', text: JSON.stringify(err) }],
+     };
+  }
+}
+export default _readTable;

package/src/toolhelpers/_scrInfo.js

@@ -0,0 +1,32 @@
+/**
+ * Copyright © 2025, SAS Institute Inc., Cary, NC, USA.  All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import axios from 'axios';
+
+async function _scrInfo(params) {
+  let {url} = params;
+  let config = {
+    method: 'GET',
+    url: url + '/apiMeta/api',
+    headers: {
+      'Accept': 'application/json'
+    }
+  }
+  try {
+    console.error('[Note] Config:', config);
+    let response = await axios(config);
+    console.error('[Note] Response status:', response.status);
+    let r = {
+      input: response.data.components.schemas.SCRInput.properties.data.properties,
+      output: response.data.components.schemas.SCROutput.properties.data.properties
+    };
+    console.error('[Note] Response data:', JSON.stringify(r, null, 2));
+    return {content: [{ type: 'text', text: JSON.stringify(r)}], structuredContent: r};
+  }
+  catch (error) {
+    return {isError: true,content: [{ type: 'text', text: JSON.stringify(error) }]};  
+  }
+}
+export default _scrInfo;

package/src/toolhelpers/_scrScore.js

@@ -0,0 +1,49 @@
+/**
+ * Copyright © 2025, SAS Institute Inc., Cary, NC, USA.  All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import axios from 'axios';
+
+
+async function _scrScore(params) {
+  let { url, scenario} = params;
+ 
+
+  let data = scenario.split(',').reduce((acc, pair) => {
+    let [key, value] = pair.split('=');
+    acc[key.trim()] = value.trim();
+    return acc;
+  }, {});
+
+  let config = {
+    method: 'POST',
+    url: url,
+    headers: {
+      'Content-Type': 'application/json',
+      'Accept': 'application/json'
+    },
+    data: data
+  };
+
+  try {
+    console.error('[Note] Config:', config);
+    let response = await axios(config);
+    console.error('[Note] Response status:', response.status);
+    console.error('[Note] Response data:', response.data);
+     let t = ' ';
+    let sep = ''
+    for (let k in r) {
+      t += sep + k + '=' + r[k];
+      sep = ', ';
+    }
+    console.error('t', t);
+    let r = { ...response.data, ...scenario }; // merge the response with the scenario and add a unique key
+    return { content: [{ type: 'text', text: JSON.stringify(r) }], structuredContent: r };
+  
+  }
+  catch (error) {
+    return { isError: true, content: [{ type: 'text', text: JSON.stringify(error) }] };
+  }
+}
+export default _scrScore;

package/src/toolhelpers/_submitCasl.js

@@ -0,0 +1,34 @@
+/*
+ * Copyright © 2025, SAS Institute Inc., Cary, NC, USA.  All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import restaflib from '@sassoftware/restaflib';
+
+async function _submitCasl(params) {
+  let { src, args, _appContext } = params;
+
+   let store = restaf.initStore(_appContext.storeConfig);
+  
+  let session = await restaflib.casSetup(store, _appContext.logonPayload, null, _appContext.cas);
+  if (session == null) {
+    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(err);
+    await store.apiCall( session.links( 'delete' ) );
+    return { isError: true, content: [{ type: 'text', text: JSON.stringify(err) }] }; 
+  }
+}
+export default _submitCasl;

package/src/toolhelpers/_submitCode.js

@@ -0,0 +1,96 @@
+/*
+ * 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 _submitCode(params) {
+  let { output, limit, args, src, _appContext } = params;
+  try {
+    // setup
+    let store = restaf.initStore(_appContext.storeConfig);
+
+    // get compute sessio, run sas code and retrieve result
+
+    let computeSession = await restaflib.computeSetup(store, _appContext.sas, _appContext.logonPayload);
+    let computeSummary = await restaflib.computeRun(store, computeSession, src, args);
+
+    let jobStatus = computeSummary.SASJobStatus;
+    let structuredOutput = {};
+    if (jobStatus === 'failed' || jobStatus === 'error' || jobStatus === 'running') {
+      let msg = `Job  ended with status of ${jobStatus}. Please check the log for errors.`;
+      let log = await computeResults(store, computeSummary, 'log');
+      let status = { status: { statusCode: 2, msg: msg } };
+      structuredOutput = { status, log: log2html(log) };
+    }
+    else {
+      let ods = await restaflib.computeResults(store, computeSummary, "ods");
+      let log = await restaflib.computeResults(store, computeSummary, "log");
+      let listing = await restaflib.computeResults(store, computeSummary, "listing");
+      let tables = await restaflib.computeResults(store, computeSummary, 'tables');
+      let cc = jobStatus === 'warning' ? 1 : 0;
+      let status = { status: { statusCode: cc, msg: `Job completed with status ${jobStatus}` } };
+
+      let rows = [];
+      let notes = ' ';
+      let tabled = [];
+      if (output != null && output.trim().length > 0 && output.trim().toLowerCase() !== 'none') {
+        if (tables.includes(output.toUpperCase()) === false) {
+          let msg = `The requested output table ${output} was not found in the response. 
+                     Please check the tables element for available tables.`;
+          notes = { status: { statusCode: 1, msg: msg } };
+        } else {
+          let tpayload = {
+            qs: {
+              limit: (limit != null) ? limit : 100,
+              start: 0
+            }
+          }
+          rows = await restaflib.computeFetchData(store, computeSummary, output, null, tpayload);
+          let schema = rows.schema;
+          let data = rows.rows;
+          tabled = data.map(row => {
+            let obj = {};
+            schema.forEach((col, index) => {
+              obj[col.name] = row[index];
+            });
+            return obj;          });
+        }
+      }
+      structuredOutput = { status, ods, log: log2html(log), listing: log2html(listing), tables: tables, output: output, tabled: tabled, notes: notes };
+    }
+    // add output tables next
+
+    // cleanup
+    await store.apiCall(computeSession.links('delete'));
+   
+    // return results in the format the LLM expects
+
+    return {
+      content: [{ type: 'text', text: JSON.stringify(structuredOutput) }],
+      structuredContent: structuredOutput
+    };
+  }
+  catch (error) {
+    // Oops! Something went wrong
+    console.error(`Error in _submitCode: ${JSON.stringify(error)}`);
+    let e = { error: error };
+    return { isError: true, content: [{ type: 'text', text: JSON.stringify(e) }], structuredContent: e };
+  }
+  function log2html(log) {
+    let logText = '';
+    // eslint-disable-next-line array-callback-return
+    log.map((data) => {
+      let line = data.line.replace(/(\r\n|\n|\r)/gm, "");
+      if (line.length === 0) {
+        logText = logText + '\n';
+      } else { }
+      logText = logText + line + '\n';
+    });
+    return logText;
+  };
+}
+
+export default _submitCode;

package/src/toolhelpers/_submitMacro.js

@@ -0,0 +1,24 @@
+/*
+ * Copyright © 2025, SAS Institute Inc., Cary, NC, USA.  All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import _submitCode from './_submitCode.js';
+
+async function _submitMacro(params) {
+    let {macro, scenario, _appContext} = params;
+	try {
+		let src = ` %${macro};$scenario; `; 
+		// setup
+		let iparams = {src: src, _appContext: _appContext};
+		return await _submitCode( iparams);
+	}
+	catch (error) {
+		// Oops! Something went wrong
+		console.error(`Error in _submitCode: ${JSON.stringify(error)}`);
+		return { isError: true, content: [{ type: 'text', text: JSON.stringify(error) }] }
+	}
+};
+
+
+export default _submitMacro;