@sassoftware/sas-score-mcp-serverjs 0.3.29-0 → 0.4.1-1

package/src/openApi.yaml

@@ -1,121 +1,121 @@
-swagger: "2.0"
-info:
-  title: SAS Viya Sample MCP Server API
-  version: "1.0.0"
-  description: API for interacting with the SAS Viya Sample MCP Server.
-host: localhost:8080
-basePath: /
-schemes:
-  - http
-  - https
-consumes:
-  - application/json
-produces:
-  - application/json
-paths:
-  /health:
-    get:
-      summary: Health check
-      description: Returns health and version information.
-      responses:
-        200:
-          description: Health information
-          schema:
-            type: object
-            properties:
-              name:
-                type: string
-              version:
-                type: string
-              description:
-                type: string
-              endpoints:
-                type: object
-              usage:
-                type: string
-  /apiMeta:
-    get:
-      summary: API metadata
-      description: Returns the OpenAPI specification for this server.
-      responses:
-        200:
-          description: OpenAPI document
-          schema:
-            type: object
-  /mcp:
-    options:
-      summary: CORS preflight
-      description: CORS preflight endpoint.
-      responses:
-        204:
-          description: No Content
-    post:
-      summary: MCP request
-      description: Handles MCP JSON-RPC requests.
-      parameters:
-        - name: body
-          in: body
-          required: true
-          schema:
-            type: object
-        - name: Authorization
-          in: header
-          required: false
-          type: string
-          description: Bearer token for authentication
-        - name: X-VIYA-SERVER
-          in: header
-          required: false
-          type: string
-          description: Override VIYA server
-        - name: X-REFRESH-TOKEN
-          in: header
-          required: false
-          type: string
-          description: Refresh token for authentication
-        - name: mcp-session-id
-          in: header
-          required: false
-          type: string
-          description: Session ID
-      responses:
-        200:
-          description: MCP response
-          schema:
-            type: object
-        500:
-          description: Server error
-          schema:
-            type: object
-    get:
-      summary: Get MCP session
-      description: Retrieves information for an MCP session.
-      parameters:
-        - name: mcp-session-id
-          in: header
-          required: true
-          type: string
-          description: Session ID
-      responses:
-        200:
-          description: Session information
-          schema:
-            type: object
-        400:
-          description: Invalid or missing session ID
-    delete:
-      summary: Delete MCP session
-      description: Deletes an MCP session.
-      parameters:
-        - name: mcp-session-id
-          in: header
-          required: true
-          type: string
-          description: Session ID
-      responses:
-        200:
-          description: Session deleted
-          schema:
-            type: object
-        400:
-          description: Invalid or missing session ID
+swagger: "2.0"
+info:
+  title: SAS Viya Sample MCP Server API
+  version: "1.0.0"
+  description: API for interacting with the SAS Viya Sample MCP Server.
+host: localhost:8080
+basePath: /
+schemes:
+  - http
+  - https
+consumes:
+  - application/json
+produces:
+  - application/json
+paths:
+  /health:
+    get:
+      summary: Health check
+      description: Returns health and version information.
+      responses:
+        200:
+          description: Health information
+          schema:
+            type: object
+            properties:
+              name:
+                type: string
+              version:
+                type: string
+              description:
+                type: string
+              endpoints:
+                type: object
+              usage:
+                type: string
+  /apiMeta:
+    get:
+      summary: API metadata
+      description: Returns the OpenAPI specification for this server.
+      responses:
+        200:
+          description: OpenAPI document
+          schema:
+            type: object
+  /mcp:
+    options:
+      summary: CORS preflight
+      description: CORS preflight endpoint.
+      responses:
+        204:
+          description: No Content
+    post:
+      summary: MCP request
+      description: Handles MCP JSON-RPC requests.
+      parameters:
+        - name: body
+          in: body
+          required: true
+          schema:
+            type: object
+        - name: Authorization
+          in: header
+          required: false
+          type: string
+          description: Bearer token for authentication
+        - name: X-VIYA-SERVER
+          in: header
+          required: false
+          type: string
+          description: Override VIYA server
+        - name: X-REFRESH-TOKEN
+          in: header
+          required: false
+          type: string
+          description: Refresh token for authentication
+        - name: mcp-session-id
+          in: header
+          required: false
+          type: string
+          description: Session ID
+      responses:
+        200:
+          description: MCP response
+          schema:
+            type: object
+        500:
+          description: Server error
+          schema:
+            type: object
+    get:
+      summary: Get MCP session
+      description: Retrieves information for an MCP session.
+      parameters:
+        - name: mcp-session-id
+          in: header
+          required: true
+          type: string
+          description: Session ID
+      responses:
+        200:
+          description: Session information
+          schema:
+            type: object
+        400:
+          description: Invalid or missing session ID
+    delete:
+      summary: Delete MCP session
+      description: Deletes an MCP session.
+      parameters:
+        - name: mcp-session-id
+          in: header
+          required: true
+          type: string
+          description: Session ID
+      responses:
+        200:
+          description: Session deleted
+          schema:
+            type: object
+        400:
+          description: Invalid or missing session ID

package/src/toolHelpers/_jobSubmit.js

@@ -12,6 +12,8 @@ async function _jobSubmit(params) {
   // setup
   if (name === 'program') {
     let src = `
+      cas mycas;
+      caslib _all_ assign;
      proc sql;
      create table work.query_results as
      ${scenario.sql};

package/src/toolHelpers/_listLibrary.js

@@ -6,53 +6,70 @@
 import restafedit from '@sassoftware/restafedit';
 import deleteSession from './deleteSession.js';
 
-async function _listLibrary(params ){
+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
-  };
-  let appControl;
-  try {
-    // setup request control
-    appControl = await restafedit.setup(
-      _appContext.logonPayload,
-      config
-      ,null,{},'user',{}, {}, _appContext.storeConfig
-    );
-    
-    // query parameters
-    let payload = {
-      qs: {
-        limit: (limit != null) ? limit : 10,
-        start: start - 1
-      }
+ 
+  const _ilistLibrary = async (params) => {
+    let { server, limit, start, name, _appContext } = params;
+    console.error(_appContext);
+    let config = {
+      casServerName: _appContext.cas,
+      computeContext: _appContext.sas,
+      source: (server === 'sas') ? 'compute' : server,
+      table: null
     };
+    let appControl;
+    try {
+      // setup request control
+      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}')`
+      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));
-    if (appControl != null) {
+
+      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));
+      if (appControl != null) {
+        await deleteSession(appControl);
+      }
+      return { isError: true, content: [{ type: 'text', text: JSON.stringify(err) }] };
     }
-    return { isError: true, content: [{ type: 'text', text: JSON.stringify(err) }] };
   }
+
+  let source = (server === 'all') ? ['sas', 'cas'] : [server];
+  let response = {};
+
+  for (let i = 0; i < source.length; i++) {
+    let liblist = await _ilistLibrary({ server: source[i], limit, start, name, _appContext });
+    response[source[i]] = liblist.structuredContent;
+  }
+  return {
+    content: [{ type: 'text', text: JSON.stringify(response) }],
+    structuredContent: response
+  };
 }
 
 export default _listLibrary;

package/src/toolHelpers/readCerts.js

@@ -9,23 +9,23 @@ function getCerts(tlsdir) {
         return null;
     }
 
-    console.log(`[Note] Reading certs from directory: ` + tlsdir);
+    console.error(`[Note] Reading certs from directory: ` + tlsdir);
     if (fs.existsSync(tlsdir) === false) {
         console.error("[Warning] Specified cert dir does not exist: " + tlsdir);
         return null;
     }
 
     let listOfFiles = fs.readdirSync(tlsdir);
-    console.log("[Note] TLS/SSL files found: " + listOfFiles);
+    console.error("[Note] TLS/SSL files found: " + listOfFiles);
     let options = {};
     for(let i=0; i < listOfFiles.length; i++) {
         let fname = listOfFiles[i];
         let name = tlsdir + '/' + listOfFiles[i];
         let key = fname.split('.')[0];
-        console.log('Reading TLS file: ' + name + ' as key: ' + key);
+        console.error('Reading TLS file: ' + name + ' as key: ' + key);
         options[key] = fs.readFileSync(name, { encoding: 'utf8' });
     }
-    console.log('cert files', Object.keys(options));
+    console.error('cert files', Object.keys(options));
     
     return options;
    

package/src/toolSet/devaScore.js

@@ -2,73 +2,60 @@
  * Copyright © 2025, SAS Institute Inc., Cary, NC, USA.  All Rights Reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
-import {z} from 'zod';
+import { z } from 'zod';
 
 function devaScore(_appContext) {
 
     let description = `
-## deva-score — compute a numeric score based on two input values
+deva-score — compute a numeric score based on two input values.
 
-LLM Invocation Guidance (When to use)
-Use THIS tool when:
-- User wants to calculate the deva score: "Calculate deva score for 5 and 10"
-- User provides two numbers for scoring: "Score these values: 3 and 7"
-- User wants to compute a score in a series: "Calculate scores for [list of numbers]"
+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 this tool for:
-- Scoring models (use model-score)
-- Statistical calculations beyond deva scoring
-- Looking up data or metadata
+PARAMETERS
+- a: number (required) — first input value
+- b: number (required) — second input value
 
-Purpose
-Compute a numeric deva score by applying the formula (a + b) * 42 to two input numbers. For scoring more than two numbers, call this tool multiple times using the previous result as the first input (left-to-right fold).
+FORMULA: (a + b) * 42
 
-Parameters
-- a (number, required): First numeric input value
-- b (number, required): Second numeric input value
+ROUTING RULES
+- "calculate deva score for 5 and 10" → { a: 5, b: 10 }
+- "score 1 and 2" → { a: 1, b: 2 }
+- "deva score a=3, b=7" → { a: 3, b: 7 }
+- Multiple numbers → chain calls left-to-right: call(first, second), then call(result, third)
 
-Response Contract
-Returns a numeric result: (a + b) * 42
-The result is always a number representing the computed deva score.
-
-Disambiguation & Clarification
-- If user provides more than two numbers without clear instructions: "Do you want to calculate the deva score by combining these numbers left-to-right?"
-- If user provides non-numeric input: "Please provide numeric values"
-
-Examples (→ mapped params)
+EXAMPLES
 - "Calculate deva score for 5 and 10" → { a: 5, b: 10 } returns 630
 - "Score 1 and 2" → { a: 1, b: 2 } returns 126
-- For multiple numbers, chain calls: devaScore(1,2)→126, then devaScore(126,3)→5418
-
-Negative Examples (should NOT call deva-score)
-- "Score this customer with the credit model" (use model-score instead)
-- "Calculate the mean of these values" (use run-sas-program or sas-query instead)
+- "Deva score 20 and 30" → { a: 20, b: 30 } returns 2100
 
-Related Tools
-- None directly related (this is a specialized scoring tool)
+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)
 
-Notes
-For sequences of numbers, use a left-to-right fold: call devaScore(first, second), then use that result as the first parameter for devaScore(result, third), and so on.
-`;
+RESPONSE
+Returns { score: (a + b) * 42 }
+    `;
     let spec = {
         name: 'deva-score',
-        aliases: ['devaScore','deva score','deva_score'],
         description: description,
-        schema: {
+        inputSchema: z.object({
             a: z.number(),
             b: z.number()
-        },
+        }),
         handler: async ({ a, b }) => {
-            console.error( a, b);
-            let r = {score: (a + b) * 42};
+            console.error(a, b);
+            let r = { score: (a + b) * 42 };
             console.error('deva score result', r);
             return {
-                content: [{type: 'text', text: 'deva score result: ' + JSON.stringify(r)}],
+                content: [{ type: 'text', text: 'deva score result: ' + JSON.stringify(r) }],
                 structuredContent: r
-             };
-            }
+            };
         }
-        
+    }
+
     return spec;
 }
 export default devaScore;
+

package/src/toolSet/findJob.js

@@ -5,88 +5,55 @@
 import { z } from 'zod';
 import _listJobs from '../toolHelpers/_listJobs.js';
 function findJob(_appContext) {
-  let llmDescription= {
-  "purpose": "Map natural language requests to find a job in SAS Viya and return structured results.",
-  "param_mapping": {
-    "name": "required - single name. If missing, ask 'Which job name would you like to find?'.",
-    "_userPrompt": "the original user prompt that triggered this tool."
-
-  },
-  "response_schema": "{ jobs: Array<string|object> }",
-  "behavior": "Return only JSON matching response_schema when invoked by an LLM. If no matches, return { jobs: [] }"
-};
+  
   let description = `
-  ## find-job — locate a specific SAS Viya job
-
-  LLM Invocation Guidance
-  Use THIS tool when the user intent is to check if ONE job exists or retrieve its metadata:
-  - "find job cars_job_v4"
-  - "does job sales_summary exist"
-  - "is there a job named churnScorer"
-  - "lookup job forecast_monthly"
-  - "verify job ETL_Daily" 
-
-  Do NOT use this tool when the user asks for:
-  - A list or browse of many jobs (use listJobs)
-  - Do not use this tool if the user want to find lib, find table, find model and similar requests
-  - Executing a job (use job)
-  - Running a job definition (use jobdef)
-  - Submitting arbitrary code (use program)
-
-  Purpose
-  Quickly determine whether a named job asset is present in the Viya environment and return its entry (or an empty result if not found).
-
-  Parameters
-  - name (string, required): Exact job name (case preserved). If multiple tokens/names supplied, take the first and ignore the rest; optionally ask for a single name.
-
-  Behavior & Matching
-  - Attempt exact match first (backend determines sensitivity).
-  - Returns { jobs: [...] } where array length is 0 (not found) or 1+ (if backend returns multiple with the same display name).
-  - No fuzzy guesses—never fabricate a job.
-  - If no name provided: ask "Which job name would you like to find?".
-
-  Response Contract
-  - Always: { jobs: Array<string|object> }
-  - On error: propagate structured server error (do not wrap in prose when invoked programmatically).
-
-  Disambiguation Rules
-  - Input only "find job" → ask for missing name.
-  - Input contains verbs like "run" or "execute" → use run-job or run-jobdef instead.
-  - Input requesting many (e.g., "find all jobs") → use list-jobs.
-
-  Examples (→ mapped params)
-  - "find job cars_job_v4" → { name: "cars_job_v4" }
-  - "does job ETL exist" → { name: "ETL" }
-  - "is there a job named metricsRefresh" → { name: "metricsRefresh" }
-
-  Negative Examples (should NOT call find-job)
-  - "list jobs" (list-jobs)
-  - "run job cars_job_v4" (run-job)
-  - "execute jobdef cars_job_v4" (run-jobdef)
-
-  Clarifying Question Template
-  - Missing name: "Which job name would you like to find?"
-  - Multiple names: "Please provide just one job name (e.g. 'cars_job_v4')."
-
-  Notes
-  - For bulk existence checks loop over names and call find-job per name.
-  - Combine with run-job tool if user wants to execute after confirming existence.
+find-job — locate a specific SAS Viya job.
+
+USE when: find job, does job exist, is there a job named, lookup job, verify job exists
+DO NOT USE for: list jobs (use list-jobs), run job (use run-job), execute jobdef (use run-jobdef), find lib/table/model (use respective tools)
+
+PARAMETERS
+- name: string (required) — job name to locate; if multiple supplied, use first
+
+ROUTING RULES
+- "find job <name>" → { name: "<name>" }
+- "does job <name> exist" → { name: "<name>" }
+- "is there a job named <name>" → { name: "<name>" }
+- "lookup/verify job <name>" → { name: "<name>" }
+- "find job" with no name → ask "Which job name would you like to find?"
+- "find all jobs / list jobs" → use list-jobs instead
+- "run job <name>" → use run-job instead
+
+EXAMPLES
+- "find job cars_job_v4" → { name: "cars_job_v4" }
+- "does job ETL exist" → { name: "ETL" }
+- "is there a job named metricsRefresh" → { name: "metricsRefresh" }
+
+NEGATIVE EXAMPLES (do not route here)
+- "list jobs" (use list-jobs)
+- "run job cars_job_v4" (use run-job)
+- "execute jobdef cars_job_v4" (use run-jobdef)
+
+ERRORS
+Returns { jobs: [] } if not found; { jobs: [name, ...] } if found. Never hallucinate job names.
   `;
 
   let spec = {
     name: 'find-job',
-    aliases: ['findJob','find job','find_job'],
     description: description,
-    schema: {
+    inputSchema: z.object({
       name: z.string(),
-      _userPrompt: z.string()
-    },
-    required: ['name'],
+    }),
     handler: async (params) => {
       let r = await _listJobs(params);
       return r;
     }
   }
+    
+
+  /* correct spec for registerTool with inputSchema */
+  
   return spec;
 }
 export default findJob;
+