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

package/src/toolSet/devaScore.js

@@ -1,61 +1,66 @@
-/*
- * Copyright © 2025, SAS Institute Inc., Cary, NC, USA.  All Rights Reserved.
- * SPDX-License-Identifier: Apache-2.0
- */
-import { z } from 'zod';
-
-function devaScore(_appContext) {
-
-    let description = `
-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
-
-PARAMETERS
-- a: number (required) — first input value
-- b: number (required) — second input value
-
-FORMULA: (a + b) * 42
-
-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)
-
-EXAMPLES
-- "Calculate deva score for 5 and 10" → { a: 5, b: 10 } returns 630
-- "Score 1 and 2" → { a: 1, b: 2 } returns 126
-- "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)
-
-RESPONSE
-Returns { score: (a + b) * 42 }
-    `;
-    let spec = {
-        name: 'deva-score',
-        description: description,
-        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('deva score result', r);
-            return {
-                content: [{ type: 'text', text: 'deva score result: ' + JSON.stringify(r) }],
-                structuredContent: r
-            };
-        }
-    }
-
-    return spec;
-}
-export default devaScore;
-
+/*
+ * Copyright © 2025, SAS Institute Inc., Cary, NC, USA.  All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { z } from 'zod';
+
+function devaScore(_appContext) {
+  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 ${brand}model-score), statistical calculations, data lookup
+
+PARAMETERS
+- a: number (required) — first input value
+- b: number (required) — second input value
+
+FORMULA: (a + b) * 42
+
+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)
+
+EXAMPLES
+- "Calculate deva score for 5 and 10" → { a: 5, b: 10 } returns 630
+- "Score 1 and 2" → { a: 1, b: 2 } returns 126
+- "Deva score 20 and 30" → { a: 20, b: 30 } returns 2100
+
+NEGATIVE EXAMPLES (do not route here)
+- "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 }
+    `;
+    let spec = {
+        name: 'deva-score',
+        description: description,
+        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('deva score result', r);
+            return {
+                content: [{ type: 'text', text: 'deva score result: ' + JSON.stringify(r) }],
+                structuredContent: r
+            };
+        }
+    }
+
+    return spec;
+}
+export default devaScore;
+

package/src/toolSet/findJob.js

@@ -4,25 +4,34 @@
  */
 import { z } from 'zod';
 import _listJobs from '../toolHelpers/_listJobs.js';
+import _findJob from '../toolHelpers/_findJob.js';
 function findJob(_appContext) {
-  
-  let description = `
+  const isAgent = _appContext && _appContext.agent;
+  let description = isAgent ? `
+find-job — verify a Job model exists.
+PARAMS: name (string, required)
+RETURNS: job metadata if found, error if not found
+` : `
 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)
+DO NOT USE for: list jobs (use ${_appContext.brand}-list-jobs), score job (use ${_appContext.brand}-job-score), score jobdef (use ${_appContext.brand}-jobdef-score), find lib/table/model (use respective tools)
 
 PARAMETERS
 - name: string (required) — job name to locate; if multiple supplied, use first
 
+Naming Rules: 
+- If user provides name with "job" suffix ".job", strip the suffix (e.g., "cars_job_v4.job"), and look for "cars_job_v4".
+
 ROUTING RULES
 - "find job <name>" → { name: "<name>" }
+- "find name.job" → { 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
+- "find all jobs / list jobs" → use ${_appContext.brand}-list-jobs instead
+- "score job <name>" → use ${_appContext.brand}-job-score instead
 
 EXAMPLES
 - "find job cars_job_v4" → { name: "cars_job_v4" }
@@ -30,9 +39,9 @@ EXAMPLES
 - "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)
+- "list jobs" (use ${_appContext.brand}-list-jobs)
+- "score job cars_job_v4" (use ${_appContext.brand}-job-score)
+- "score jobdef cars_job_v4" (use ${_appContext.brand}-jobdef-score)
 
 ERRORS
 Returns { jobs: [] } if not found; { jobs: [name, ...] } if found. Never hallucinate job names.
@@ -45,7 +54,13 @@ Returns { jobs: [] } if not found; { jobs: [name, ...] } if found. Never halluci
       name: z.string()
     }),
     handler: async (params) => {
-      let r = await _listJobs(params);
+      if (params.name != null) {
+        if (params.name.endsWith('.job'))   {
+          params.name = params.name.slice(0, -4);
+        }
+      }
+      params.tool = 'find';
+      let r = await _findJob(params);
       return r;
     }
   }

package/src/toolSet/findJobdef.js

@@ -3,34 +3,31 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import { z } from 'zod';
-import _listJobdefs from '../toolHelpers/_listJobdefs.js';
+import _findJobdef from '../toolHelpers/_findJobdef.js';
 function findJobdef(_appContext) {
-  let llmDescription= {
-  "purpose": "Map natural language requests to find a jobdef (job definition) in SAS Viya and return structured results.",
-  "param_mapping": {
-    "name": "required - single name. If missing, ask 'Which jobdef name would you like to find?'.",
-
-  },
-  "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 = `
+  const isAgent = _appContext && _appContext.agent;
+  let description = isAgent ? `
+find-jobdef — verify a JobDef model exists.
+PARAMS: name (string, required)
+RETURNS: jobdef metadata if found, error if not found
+` : `
 find-jobdef — locate a specific SAS Viya job definition.
 
 USE when: find jobdef, does jobdef exist, is there a jobdef named, lookup jobdef, verify jobdef exists
-DO NOT USE for: list jobdefs (use list-jobdefs), run jobdef (use run-jobdef), find job/lib/table/model (use respective tools)
+DO NOT USE for: list jobdefs (use ${_appContext.brand}-list-jobdefs), score jobdef (use ${_appContext.brand}-jobdef-score), find job/lib/table/model (use respective tools)
 
 PARAMETERS
 - name: string (required) — jobdef name to locate; if multiple supplied, use first
 
 ROUTING RULES
 - "find jobdef <name>" → { name: "<name>" }
+- "find name.jobdef" → { name: "<name>" }
 - "does jobdef <name> exist" → { name: "<name>" }
 - "is there a jobdef named <name>" → { name: "<name>" }
 - "lookup/verify jobdef <name>" → { name: "<name>" }
 - "find jobdef" with no name → ask "Which jobdef name would you like to find?"
-- "find all jobdefs / list jobdefs" → use list-jobdefs instead
-- "run jobdef <name>" → use run-jobdef instead
+- "find all jobdefs / list jobdefs" → use ${_appContext.brand}-list-jobdefs instead
+- "score jobdef <name>" → use ${_appContext.brand}-jobdef-score instead
 
 EXAMPLES
 - "find jobdef cars_job_v4" → { name: "cars_job_v4" }
@@ -38,10 +35,10 @@ EXAMPLES
 - "is there a jobdef named metricsRefresh" → { name: "metricsRefresh" }
 
 NEGATIVE EXAMPLES (do not route here)
-- "list jobdefs" (use list-jobdefs)
-- "run jobdef cars_job_v4" (use run-jobdef)
-- "find job ETL" (use find-job)
-- "find table cars" (use find-table)
+- "list jobdefs" (use ${_appContext.brand}-list-jobdefs)
+- "score jobdef cars_job_v4" (use ${_appContext.brand}-jobdef-score)
+- "find job ETL" (use ${_appContext.brand}-find-job)
+- "find table cars" (use ${_appContext.brand}-find-table)
 
 ERRORS
 Returns { jobdefs: [] } if not found; { jobdefs: [name, ...] } if found. Never hallucinate jobdef names.
@@ -54,7 +51,13 @@ Returns { jobdefs: [] } if not found; { jobdefs: [name, ...] } if found. Never h
         name: z.string()
     }),
     handler: async (params) => {
-      let r = await _listJobdefs(params);
+      if (params.name != null) {
+        if (params.name.endsWith('.jobdef'))   {
+          params.name = params.name.slice(0, -7);
+        }
+      }
+      params.tool = 'find';
+      let r = await _findJobdef(params);
       return r;
     }
   }

package/src/toolSet/findLibrary.js

@@ -1,68 +1,73 @@
-/*
- * Copyright © 2025, SAS Institute Inc., Cary, NC, USA.  All Rights Reserved.
- * SPDX-License-Identifier: Apache-2.0
- */
-import { z } from 'zod';
-import _listLibrary from '../toolHelpers/_listLibrary.js';
-function findLibrary(_appContext) {
-  
-  let description = `
-find-library — locate a specific CAS or SAS library.
-
-USE when: find library, find lib, does library exist, is library available, lookup library
-DO NOT USE for: list libraries (use list-libraries), find table/job/jobdef/model (use respective tools), table structure (use table-info), create library (use run-sas-program)
-
-PARAMETERS
-- name: string (required) — library/caslib name; if multiple supplied, use first
-- server: 'cas' | 'sas' (default: 'cas') — target environment
-
-ROUTING RULES
-- "find lib <name>" → { name: "<name>", server: "cas" }
-- "find lib <name> in cas" → { name: "<name>", server: "cas" }
-- "find library <name> in sas" → { name: "<name>", server: "sas" }
-- "does library <name> exist" → { name: "<name>", server: "cas" }
-- "find lib" with no name → ask "Which library name would you like to find?"
-- "list libraries / list libs" → use list-libraries instead
-- "tables in <lib>" → use list-tables instead
-
-EXAMPLES
-- "find lib Public" → { name: "Public", server: "cas" }
-- "find library sasuser in sas" → { name: "sasuser", server: "sas" }
-- "does library Formats exist" → { name: "Formats", server: "cas" }
-
-NEGATIVE EXAMPLES (do not route here)
-- "list libs" (use list-libraries)
-- "show tables in Public" (use list-tables)
-- "find table cars in sashelp" (use find-table)
-- "find job cars_job" (use find-job)
-
-ERRORS
-Returns { libraries: [] } if not found; { libraries: [name, ...] } if found. Never hallucinate library names.
-  `;
-
-  let spec = {
-    name: 'find-library',
-    description: description,
-    inputSchema: z.object({
-      name: z.string(),
-      server: z.string().optional()
-    }),
-    
-    handler: async (params) => {
-      // normalize server to lowercase & default
-      if (!params.server) params.server = 'cas';
-      params.server = params.server.toLowerCase();
-
-      // If multiple names passed (comma or space separated), take the first token (defensive)
-      if (params.name && /[,\s]+/.test(params.name.trim())) {
-        params.name = params.name.split(/[,\s]+/).filter(Boolean)[0];
-      }
-
-      let r = await _listLibrary(params);
-      return r;
-    }
-  }
-  return spec;
-}
-export default findLibrary;
-
+/*
+ * Copyright © 2025, SAS Institute Inc., Cary, NC, USA.  All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { z } from 'zod';
+import _listLibrary from '../toolHelpers/_listLibrary.js';
+function findLibrary(_appContext) {
+  const isAgent = _appContext && _appContext.agent;
+  let description = isAgent ? `
+find-library — verify a library exists.
+PARAMS: name (string, required), server ('cas'|'sas', required)
+RETURNS: library metadata if found, error if not found
+` : `
+find-library — locate a specific CAS or SAS library.
+
+USE when: find library, find lib, does library exist, is library available, lookup library
+DO NOT USE for: list libraries (use ${_appContext.brand}-list-libraries), find table/job/jobdef/model (use respective tools), table structure (use ${_appContext.brand}-table-describe), create library (use ${_appContext.brand}-program-score)
+
+PARAMETERS
+- name: string (required) — library/caslib name; if multiple supplied, use first
+- server: 'cas' | 'sas' (required) — target environment
+
+ROUTING RULES
+- "find lib <name>" → { name: "<name>", server: "cas" }
+- "find lib <name> in cas" → { name: "<name>", server: "cas" }
+- "find library <name> in sas" → { name: "<name>", server: "sas" }
+- "does library <name> exist" → { name: "<name>", server: "cas" }
+- "find lib" with no name → ask "Which library name would you like to find?"
+- "list libraries / list libs" → use ${_appContext.brand}-list-libraries instead
+- "tables in <lib>" → use ${_appContext.brand}-list-tables instead
+
+EXAMPLES
+- "find lib Public" → { name: "Public", server: "cas" }
+- "find library sasuser in sas" → { name: "sasuser", server: "sas" }
+- "does library Formats exist" → { name: "Formats", server: "cas" }
+
+NEGATIVE EXAMPLES (do not route here)
+- "list libs" (use ${_appContext.brand}-list-libraries)
+- "show tables in Public" (use ${_appContext.brand}-list-tables)
+- "find table cars in sashelp" (use ${_appContext.brand}-find-table)
+- "find job cars_job" (use ${_appContext.brand}-find-job)
+
+ERRORS
+Returns { libraries: [] } if not found; { libraries: [name, ...] } if found. Never hallucinate library names.
+  `;
+
+  let spec = {
+    name: 'find-library',
+    description: description,
+    inputSchema: z.object({
+      name: z.string(),
+      server: z.string().optional()
+    }),
+    
+    handler: async (params) => {
+      // normalize server to lowercase & default
+      if (!params.server) params.server = 'cas';
+      params.server = params.server.toLowerCase();
+
+      // If multiple names passed (comma or space separated), take the first token (defensive)
+      if (params.name && /[,\s]+/.test(params.name.trim())) {
+        params.name = params.name.split(/[,\s]+/).filter(Boolean)[0];
+      }
+      params.tool = 'find';
+      let r = await _listLibrary(params);
+      return r;
+    }
+  }
+  return spec;
+}
+export default findLibrary;
+
+

package/src/toolSet/findMas.js

@@ -0,0 +1,72 @@
+/*
+ * Copyright © 2025, SAS Institute Inc., Cary, NC, USA.  All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import { z } from 'zod';
+import _findMas from '../toolHelpers/_findMas.js';
+
+
+function findMas(_appContext) {
+  const isAgent = _appContext && _appContext.agent;
+  let description = isAgent ? `
+find-mas — verify a MAS model exists.
+PARAMS: name (string, required)
+RETURNS: model metadata if found, error if not found
+` : `
+find-mas — locate a specific MAS mas deployed to MAS server 
+
+USE when: find mas, does mas exist, is mas deployed, lookup mas, verify mas exists
+DO NOT USE for: list mass (use ${_appContext.brand}-list-mass), mas info/variables (use ${_appContext.brand}-mas-describe), score mas (use ${_appContext.brand}-mas-score), find table/job/lib (use respective tools), scr mass (use ${_appContext.brand}-scr-describe/${_appContext.brand}-scr-score)
+
+PARAMETERS
+- name: string (required) — mas name to locate; if multiple supplied, use first
+
+ROUTING RULES
+- "find mas <name>" → { name: "<name>" }
+- "find name.mas" → { name: "<name>" }
+- "does mas <name> exist" → { name: "<name>" }
+- "is mas <name> deployed" → { name: "<name>" }
+- "lookup/verify mas <name>" → { name: "<name>" }
+- "find mas" with no name → ask "Which mas name would you like to find?"
+- "find all mass / list mass" → use ${_appContext.brand}-list-mas instead
+- "describe mas / mas info" → use ${_appContext.brand}-mas-describe instead
+
+EXAMPLES
+- "find mas mymas" → { name: "mymas" }
+- "does mas churn_score exist" → { name: "churn_score" }
+- "is mas riskmas deployed" → { name: "riskmas" }
+- "lookup mas claims_fraud_v1" → { name: "claims_fraud_v1" }
+
+NEGATIVE EXAMPLES (do not route here)
+- "list mass" (use ${_appContext.brand}-list-mas)
+- "score mas mymas" (use ${_appContext.brand}-mas-score)
+- "mas info for churnRisk" (use ${_appContext.brand}-mas-describe)
+
+ERRORS
+Returns { mass: [] } if not found; { mass: [name, ...] } if found. Never hallucinate mas names.
+  `;
+
+  let spec = {
+    name: 'find-mas',
+    description: description,
+    inputSchema: z.object({
+      name: z.string()
+    }),
+    handler: async (params) => { 
+      if (params.name != null) {
+        if (params.name.endsWith('.mas'))   {
+          params.name = params.name.slice(0, -4);
+        }
+      }
+      params.tool = 'find';
+      let r = await _findMas(params);
+      return r;
+    }
+  }
+  return spec;
+}
+
+export default findMas;
+
+

package/src/toolSet/findScr.js

@@ -0,0 +1,69 @@
+/*
+ * Copyright © 2025, SAS Institute Inc., Cary, NC, USA.  All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import { z } from 'zod';
+import _findScr from '../toolHelpers/_findScr.js';
+
+
+function findScr(_appContext) {
+  const isAgent = _appContext && _appContext.agent;
+  let description = isAgent ? `
+find-scr — verify an SCR model exists.
+PARAMS: name (string, required)
+RETURNS: SCR model metadata if found, error if not found
+` : `
+find-scr — locate a specific SCR scr deployed to SCR server 
+
+USE when: find scr, does scr exist, is scr deployed, lookup scr, verify scr exists
+DO NOT USE for: list scrs (use list-scr), scr info/variables (use scr-describe), score scr (use scr-score), find table/job/lib (use respective tools), mas scr (use mas-describe/mas-score)
+
+
+PARAMETERS
+- name: string (required) — scr name to locate; if multiple supplied, use first
+
+ROUTING RULES
+- "find scr <name>" → { name: "<name>" }
+- "does scr <name> exist" → { name: "<name>" }
+- "is scr <name> deployed" → { name: "<name>" }
+- "lookup/verify scr <name>" → { name: "<name>" }
+- "find scr" with no name → ask "Which scr name would you like to find?"
+- "describe scr / scr info" → use scr-describe instead
+
+EXAMPLES
+- "find scr myscr" → { name: "myscr" }
+- "does scr churn_score exist" → { name: "churn_score" }
+- "is scr riskscr deployed" → { name: "riskscr" }
+- "lookup scr claims_fraud_v1" → { name: "claims_fraud_v1" }
+
+NEGATIVE EXAMPLES (do not route here)
+- "list scr" (use ${_appContext.brand}-list-scr)
+- "score scr myscr" (use ${_appContext.brand}-scr-score)
+- "scr info for churnRisk" (use ${_appContext.brand}-scr-describe)
+
+ERRORS
+Returns { scr: [] } if not found; { scr: [name, ...] } if found. Never hallucinate scr urls.
+  `;
+
+  let spec = {
+    name: 'find-scr',
+    description: description,
+    inputSchema: z.object({
+      name: z.string()
+    }),
+    handler: async (params) => { 
+      if (params.name.endsWith('.scr')) {
+        params.name = params.name.slice(0, -4);
+      }
+      params.tool = 'find';
+      let r = await _findScr(params);
+      return r;
+    }
+  }
+  return spec;
+}
+
+export default findScr;
+
+