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

package/src/toolSet/findModel.js

@@ -1,60 +0,0 @@
-/*
- * 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 findModel(_appContext) {
-  let description = `
-find-model — locate a specific MAS model deployed to MAS server 
-
-USE when: find model, does model exist, is model deployed, lookup model, verify model exists
-DO NOT USE for: list models (use list-models), model info/variables (use model-info), score model (use model-score), find table/job/lib (use respective tools), scr models (use scr-info/scr-score)
-
-PARAMETERS
-- name: string (required) — model name to locate; if multiple supplied, use first
-
-ROUTING RULES
-- "find model <name>" → { name: "<name>" }
-- "does model <name> exist" → { name: "<name>" }
-- "is model <name> deployed" → { name: "<name>" }
-- "lookup/verify model <name>" → { name: "<name>" }
-- "find model" with no name → ask "Which model name would you like to find?"
-- "find all models / list models" → use list-models instead
-- "score model <name>" → use model-score instead
-- "describe model / model info" → use model-info instead
-
-EXAMPLES
-- "find model myModel" → { name: "myModel" }
-- "does model churn_score exist" → { name: "churn_score" }
-- "is model riskModel deployed" → { name: "riskModel" }
-- "lookup model claims_fraud_v1" → { name: "claims_fraud_v1" }
-
-NEGATIVE EXAMPLES (do not route here)
-- "list models" (use list-models)
-- "score model myModel" (use model-score)
-- "model info for churnRisk" (use model-info)
-
-ERRORS
-Returns { models: [] } if not found; { models: [name, ...] } if found. Never hallucinate model names.
-  `;
-
-  let spec = {
-    name: 'find-model',
-    description: description,
-    inputSchema: z.object({
-      name: z.string()
-    }),
-    handler: async (params) => { 
-      let r = await _listModels(params);
-      return r;
-    }
-  }
-  return spec;
-}
-
-export default findModel;
-

package/src/toolSet/listModels.js

@@ -1,56 +0,0 @@
-/*
- * 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/modelInfo.js

@@ -1,55 +0,0 @@
-/*
- * 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 _masDescribe from '../toolHelpers/_masDescribe.js';
-const log = debug('tools');
-
-function modelInfo(_appContext) {
-  let description = `
-model-info — retrieve detailed metadata for a deployed model.
-
-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
-
-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" }
-
-EXAMPLES
-- "What inputs does model churnRisk need?" → { model: "churnRisk" }
-- "Describe model 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)
-
-ERRORS
-Returns model metadata: inputs (name, type, role), outputs (name, type, possible_values), model_type, description.
-  `;
-
-  let spec = {
-    name: 'model-info',
-    description: description,
-    inputSchema: z.object({
-      model: z.string()
-    }),
-    handler: async (params) => {
-      let r = await _masDescribe(params);
-      return r;
-    }
-  }
-  return spec;
-}
-
-export default modelInfo;
-

package/src/toolSet/modelScore.js

@@ -1,89 +0,0 @@
-/*
- * 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 _masScoring from '../toolHelpers/_masScoring.js';
-const log = debug('tools');
-
-function modelScore(_appContext) {
-  let description = `
-mas-score — score data using a deployed model on MAS.
-
-USE when: score with model, predict using model, batch scoring, model predictions
-DO NOT USE for: find model, model metadata, list models, run programs/jobs, query tables
-
-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
-
-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 }
-
-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 }
-
-NEGATIVE EXAMPLES (do not route here)
-- "find model X" (use find-model)
-- "what inputs does model need" (use model-info)
-- "list models" (use list-models)
-- "run job X" (use run-job)
-
-ERRORS
-Returns predictions, probabilities, scores merged with input data. Returns error if model not found or scoring fails.
-  `;
-
- 
-  let spec = {
-    name: 'mas-score',
-    description: description,
-    inputSchema:z.object({
-      model: z.string(),
-      scenario: z.string(),
-      uflag: z.boolean().optional()
-    }),
-      
-    handler: async (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;
-      if (typeof scenario === 'object') {
-        scenarioObj = 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;
-      
-      // 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)
-      return r;
-    }
-  }
-  return spec;
-}
-
-export default modelScore;
-

package/src/toolSet/runCasProgram.js

@@ -1,98 +0,0 @@
-/*
- * Copyright © 2025, SAS Institute Inc., Cary, NC, USA.  All Rights Reserved.
- * SPDX-License-Identifier: Apache-2.0
- */
-
-import { z } from 'zod';
-import _submitCode from '../toolHelpers/_submitCode.js';
-
-function runCasProgram(_appContext) {
-  let description = `
-run-cas-program — execute a CAS program on SAS Viya server.
-
-USE when: run cas program, execute cas, submit cas, cas action
-DO NOT USE for: macros (use run-macro), sas code (use run-sas-program), jobs (use run-job), jobdefs (use run-jobdef)
-
-PARAMETERS
-- src: string (required) — CAS program to execute verbatim
-- scenario: string or object (optional) — input parameters
-- folder: string — server folder path for .sas files
-- output: string — table name to return in response
-- limit: number (default: 100) — max rows to return
-
-ROUTING RULES
-- run cas program action echo → { src: action echo }
-- execute cas action simple.summary → { src: action simple.summary }
-
-EXAMPLES
-- run cas program action echo → { src: action echo }
-- cas program sample folder=/Public/models → { src: sample, folder: /Public/models }
-
-NEGATIVE EXAMPLES (do not route here)
-- run sas macro (use run-macro)
-- submit sas code (use run-sas-program)
-- run job X (use run-job)
-
-NOTES
-Sends src verbatim without validation. For SAS macros use run-macro. For arbitrary SAS code use run-sas-program.
-
-RESPONSE
-Log output and CAS results. If output table specified, returned as markdown table.
-`;
-
-  let spec = {
-    name: 'run-cas-program',
-    description: description,
-    inputSchema:z.object({
-      src: z.string(),
-      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'.
-    handler: async (params) => {
-      let {src, folder, scenario, _appContext} = params;
-      // figure out src
-      let isrc = src;
-      if (folder != null && folder.trim().length > 0) {
-        if (isrc.indexOf('.sas') < 0) {
-          isrc = isrc + '.sas';
-        }
-        isrc = `
-          filename mcptemp filesrvc folderpath="${folder}";
-          %include mcptemp("${isrc}");
-          filename mcptemp clear;
-        `;
-      }
-      // figure out macros
-  
-      if (typeof scenario === 'string' && scenario.includes('=')) {
-        scenario = scenario.split(',').reduce((acc, pair) => {
-          const [k, ...rest] = pair.split('=');
-          if (!k) return acc;
-          acc[k.trim()] = rest.join('=').trim();
-          return acc;
-        }, {});
-      }
-      let iparms = {
-        args: scenario,
-        output: params.output,
-        limit: params.limit,
-        src: isrc,
-        _appContext: _appContext
-      }
-     // console.error('iparms', iparms);
-      let r = await _submitCode(iparms);
-      return r;
-    }
-  }
-  return spec;
-}
-
-export default runCasProgram;
-

package/src/toolSet/runJob.js

@@ -1,81 +0,0 @@
-/*
- * 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 — score with a deployed SAS Viya job.
-
-USE when: score with job, run job, execute job
-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;
-

package/src/toolSet/runJobdef.js

@@ -1,82 +0,0 @@
-/*
- * 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 runJobdef(_appContext) {
-  // JSON object for LLM/tooling
- 
-  let description = `
-run-jobdef — score with a deployed SAS Viya job definition.
-
-USE when: score with jobdef, run jobdef, execute jobdef
-DO NOT USE for: arbitrary SAS code (use run-sas-program), macros (use run-macro), list/find jobdefs
-
-PARAMETERS
-- name: string — jobdef name (required)
-- scenario: string | object — input parameters. Accepts: "x=1, y=2" or {x:1, y:2}
-
-ROUTING RULES
-- "run jobdef xyz" → { name: "xyz" }
-- "run jobdef xyz with param1=10, param2=val2" → { name: "xyz", scenario: {param1:10, param2:"val2"} }
-
-EXAMPLES
-- "run jobdef xyz" → { name: "xyz" }
-- "run jobdef monthly_report with month=10, year=2025" → { name: "monthly_report", 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 jobdefs" (use list-jobdefs)
-- "find jobdef X" (use find-jobdef)
-
-ERRORS
-Returns log output, listings, tables from jobdef. Error if jobdef not found.
-  `;
- 
-  let spec = {
-    name: 'run-jobdef',
-    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 = 'def';
-      params.scenario = scenarioObj;
-      // Provide runtime context for auth and server settings
-      let r = await _jobSubmit(params);
-      return r;
-    }
-  };
-  return spec;
-}
-
-export default runJobdef;
-

package/src/toolSet/scrInfo.js

@@ -1,52 +0,0 @@
-/*
- * Copyright © 2025, SAS Institute Inc., Cary, NC, USA.  All Rights Reserved.
- * SPDX-License-Identifier: Apache-2.0
- */
-
-import { z } from 'zod';
-import _scrInfo from '../toolHelpers/_scrInfo.js';
-
-function scrInfo(_appContext) {
-
-  let description = `
-## scr-info
-
-Purpose
-Return the input/output schema and metadata for an SCR (Score Code Runtime) model.
-
-Inputs
-- url (string): The SCR model identifier. 
-What it returns
-- A JSON object describing the model's interface, typically including:
-  - Input variables (names, types, required/optional)
-  - Output variables (predictions, probabilities, scores)
-  
-
-Usage notes
-- Ensure network connectivity and credentials for the remote SCR service when needed.
-- Use scr-score to score data after inspecting the schema.
-
-Examples
-- describe scr model "https://scr-host/models/loan"
-- info for scr model "https://scr-host/models/loan"
-`;
-
-  let spec = {
-    name: 'scr-info',
-    description: description,
-    inputSchema: z.object({
-      url: z.string()
-    }),
-    handler: async (params) => {
-      let {url, _appContext} = params;
-      if (url === null) {
-        return { status: { statusCode: 2, msg: `SCR model ${url} not found` }, results: {} };
-      }
-      let r = await _scrInfo({url, _appContext});
-      return r;
-    }
-  }
-  return spec;
-}
-
-export default scrInfo;

package/src/toolSet/tableInfo.js

@@ -1,58 +0,0 @@
-/*
- * 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 _tableInfo  from '../toolHelpers/_tableInfo.js';
-import { type } from 'node:os';
-function tableInfo(_appContext) {
-
-     let describe = `
-table-info — retrieve metadata about a table in a CAS or SAS library.
-
-USE when: what columns, describe structure, show schema, table statistics, column info
-DO NOT USE for: read data (use read-table), list tables (use list-tables), find table (use find-table), queries (use sas-query)
-
-PARAMETERS
-- table: string — table name (required)
-- lib: string — caslib or libref (required)
-- server: string (default: 'cas') — 'cas' or 'sas'
-
-ROUTING RULES
-- "what columns are in cars" → { table: "cars", lib: "<lib>", server: "cas" }
-- "describe table sales in Public" → { table: "sales", lib: "Public", server: "cas" }
-- "show schema for mylib.iris on sas" → { table: "iris", lib: "mylib", server: "sas" }
-
-EXAMPLES
-- "what columns in cars" → { table: "cars", lib: "<lib>", server: "cas" }
-- "describe structure of customers in Public" → { table: "customers", lib: "Public", server: "cas" }
-
-NEGATIVE EXAMPLES (do not route here)
-- "read table cars" (use read-table)
-- "list tables in Public" (use list-tables)
-- "does table exist" (use find-table)
-- "query table" (use sas-query)
-
-ERRORS
-Returns columns array (name, type, label, format, length) and tableInfo (rowCount, fileSize, created, modified).
-  `;
-   
-    let  specs = {
-      name: 'table-info',
-      description: describe,
-      inputSchema: z.object({
-        table: z.string(),
-        lib: z.string().optional(),
-        server: z.string().optional()
-      }),
-    handler: async (params) => {
-        params.describe = true;
-        let r = await _tableInfo(params);
-        return r;
-      }
-    }
-    return specs;
-}
-export default tableInfo;