@sassoftware/sas-score-mcp-serverjs 1.0.1-30 → 1.0.1-32

package/src/toolSet/findMas.js

@@ -0,0 +1,59 @@
+/*
+ * 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) {
+  let description = `
+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 list-mass), mas info/variables (use mas-info), score mas (use mas-score), find table/job/lib (use respective tools), scr mass (use scr-info/scr-score)
+
+PARAMETERS
+- name: string (required) — mas name to locate; if multiple supplied, use first
+
+ROUTING RULES
+- "find mas <name>" → { 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 list-mass instead
+- "describe mas / mas info" → use mas-info 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 list-mass)
+- "score mas mymas" (use mas-score)
+- "mas info for churnRisk" (use mas-info)
+
+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) => { 
+      let r = await _findmas(params);
+      return r;
+    }
+  }
+  return spec;
+}
+
+export default findMas;
+

package/src/toolSet/findTable.js

@@ -5,7 +5,7 @@
 
 import { z } from 'zod';
 //import debug from 'debug';
-import _listTables from '../toolHelpers/_listTables.js';
+import _findTable from '../toolHelpers/_findTable.js';
 
 function findTable(_appContext) {
   let description = `
@@ -54,7 +54,7 @@ Returns { tables: [] } if not found; { tables: [name, ...] } if found. Never hal
     
     handler: async (params) => {
       // Check if the params.scenario is a string and parse it
-      let r = await _listTables(params);
+      let r = await _findTable(params);
       return r;
     }
   }

package/src/toolSet/jobInfo.js

@@ -0,0 +1,59 @@
+/*
+ * Copyright © 2025, SAS Institute Inc., Cary, NC, USA.  All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { z } from 'zod';
+import _listJobs from '../toolHelpers/_listJobs.js';
+function jobInfo(_appContext) {
+  
+  let description = `
+job-info — return information about 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) — name of job whose details are being requested. Should be exact match to job name.
+
+ROUTING RULES
+- "describe job <name>" → { name: "<name>" }
+- "describe model <name.job>"
+- "info for job <name>" → { name: "<name>" }
+
+EXAMPLES
+- "describe job cars_job_v4" → { name: "cars_job_v4" }
+
+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 job metadata 
+  `;
+
+  let spec = {
+    name: 'job-info',
+    description: description,
+    inputSchema: z.object({
+      name: z.string()
+    }),
+    handler: async (params) => {
+      if (params.name != null) {
+        if (params.name.endsWith('.job'))   {
+          params.name = params.name.slice(0, -4);
+        }
+      }
+      // _listJobs can handle job lookup by name and will return an appropriate error message if not found, so we can rely on that for error handling here.
+      let r = await _listJobs(params);
+      return r;
+    }
+  }
+    
+
+  /* correct spec for registerTool with inputSchema */
+  
+  return spec;
+}
+export default jobInfo;
+

package/src/toolSet/jobdefInfo.js

@@ -0,0 +1,59 @@
+/*
+ * Copyright © 2025, SAS Institute Inc., Cary, NC, USA.  All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { z } from 'zod';
+import _listJobdefs from '../toolHelpers/_listJobdefs.js';
+function jobdefInfo(_appContext) {
+  
+  let description = `
+jobdef    -info — return information about a specific SAS Viya jobdef.
+
+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 lib/table/model (use respective tools)
+
+PARAMETERS
+- name: string (required) — name of jobdef whose details are being requested. Should be exact match to jobdef name.
+
+ROUTING RULES
+- "describe jobdef <name>" → { name: "<name>" }
+- "describe model <name.jobdef>"
+- "info for jobdef <name>" → { name: "<name>" }
+
+EXAMPLES
+- "describe jobdef cars_job_v4" → { name: "cars_job_v4" }
+
+NEGATIVE EXAMPLES (do not route here)
+- "list jobdefs" (use list-jobdefs)
+- "run jobdef cars_job_v4" (use run-jobdef)
+- "execute jobdef cars_job_v4" (use run-jobdef)
+
+ERRORS
+Returns job metadata 
+  `;
+
+  let spec = {
+    name: 'jobdef-info',
+    description: description,
+    inputSchema: z.object({
+      name: z.string()
+    }),
+    handler: async (params) => {
+      if (params.name != null) {
+        if (params.name.endsWith('.jobdef'))   {
+          params.name = params.name.slice(0, -7);
+        }
+      }
+      // _listJobs can handle job lookup by name and will return an appropriate error message if not found, so we can rely on that for error handling here.
+      let r = await _listJobdefs(params);
+      return r;
+    }
+  }
+    
+
+  /* correct spec for registerTool with inputSchema */
+  
+  return spec;
+}
+export default jobdefInfo;
+

package/src/toolSet/listJobdefs.js

@@ -1,61 +1,61 @@
-/*
- * Copyright © 2025, SAS Institute Inc., Cary, NC, USA.  All Rights Reserved.
- * SPDX-License-Identifier: Apache-2.0
- */
-import { z } from 'zod';
-import _listJobdefs from '../toolHelpers/_listJobdefs.js';
-function listJobdefs(_appContext) {
-
-  let description = `
-list-jobdefs — enumerate SAS Viya job definitions (jobdefs) assets.
-
-USE when: list jobdefs, show jobdefs, browse jobdefs, list available jobdefs, next page
-DO NOT USE for: find single jobdef (use find-jobdef), execute jobdef (use run-jobdef), find job (use find-job), sas code (use run-sas-program)
-
-PARAMETERS
-- limit: number (default: 10) — number of jobdefs per page
-- start: number (default: 1) — 1-based page offset
-- where: string (default: '') — optional filter expression
-
-ROUTING RULES
-- list jobdefs → { start: 1, limit: 10 }
-- show me 25 jobdefs → { start: 1, limit: 25 }
-- next jobdefs → { start: previousStart + previousLimit, limit: previousLimit }
-
-EXAMPLES
-- list jobdefs → { start: 1, limit: 10 }
-- list 25 jobdefs → { start: 1, limit: 25 }
-- next jobdefs → { start: 11, limit: 10 }
-
-NEGATIVE EXAMPLES (do not route here)
-- find jobdef abc (use find-jobdef)
-- list jobs (use list-jobs)
-- run jobdef abc (use run-jobdef)
-- list models (use list-models)
-
-PAGINATION
-If returned length === limit, hint: next start = start + limit. Empty result with start > 1 means paged past end.
-
-ERRORS
-Surface backend error directly; never fabricate jobdef names.
-  `;
-
-  let spec = {
-    name: 'list-jobdefs',
-    description: description,
-    inputSchema: z.object({
-      limit: z.number().optional(),
-      start: z.number().optional(),
-      where: z.string().optional()
-    }),
-  // No 'server' required; backend context is implicit in helper
-    handler: async (params) => {
-      // _listJobdefs handles all validation and defaults
-      const result = await _listJobdefs(params);
-      return result;
-    }
-  }
-  return spec;
-}
-export default listJobdefs;
-
+/*
+ * Copyright © 2025, SAS Institute Inc., Cary, NC, USA.  All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { z } from 'zod';
+import _listJobdefs from '../toolHelpers/_listJobdefs.js';
+function listJobdefs(_appContext) {
+
+  let description = `
+list-jobdefs — enumerate SAS Viya job definitions (jobdefs) assets.
+
+USE when: list jobdefs, show jobdefs, browse jobdefs, list available jobdefs, next page
+DO NOT USE for: find single jobdef (use find-jobdef), execute jobdef (use run-jobdef), find job (use find-job), sas code (use run-sas-program)
+
+PARAMETERS
+- limit: number (default: 10) — number of jobdefs per page
+- start: number (default: 1) — 1-based page offset
+- where: string (default: '') — optional filter expression
+
+ROUTING RULES
+- list jobdefs → { start: 1, limit: 10 }
+- show me 25 jobdefs → { start: 1, limit: 25 }
+- next jobdefs → { start: previousStart + previousLimit, limit: previousLimit }
+
+EXAMPLES
+- list jobdefs → { start: 1, limit: 10 }
+- list 25 jobdefs → { start: 1, limit: 25 }
+- next jobdefs → { start: 11, limit: 10 }
+
+NEGATIVE EXAMPLES (do not route here)
+- find jobdef abc (use find-jobdef)
+- list jobs (use list-jobs)
+- run jobdef abc (use run-jobdef)
+- list models (use list-models)
+
+PAGINATION
+If returned length === limit, hint: next start = start + limit. Empty result with start > 1 means paged past end.
+
+ERRORS
+Surface backend error directly; never fabricate jobdef names.
+  `;
+
+  let spec = {
+    name: 'list-jobdefs',
+    description: description,
+    inputSchema: z.object({
+      limit: z.number().optional(),
+      start: z.number().optional(),
+      where: z.string().optional()
+    }),
+  // No 'server' required; backend context is implicit in helper
+    handler: async (params) => {
+      // _listJobdefs handles all validation and defaults
+      const result = await _listJobdefs(params);
+      return result;
+    }
+  }
+  return spec;
+}
+export default listJobdefs;
+

package/src/toolSet/listJobs.js

@@ -1,61 +1,61 @@
-/*
- * Copyright © 2025, SAS Institute Inc., Cary, NC, USA.  All Rights Reserved.
- * SPDX-License-Identifier: Apache-2.0
- */
-import { z } from 'zod';
-import _listJobs from '../toolHelpers/_listJobs.js';
-function listJobs(_appContext) {
-
-  let description = `
-list-jobs — enumerate SAS Viya job assets.
-
-USE when: list jobs, show jobs, browse jobs, list available jobs, next page
-DO NOT USE for: find single job (use find-job), execute job (use run-job), run job def (use run-jobdef), sas code (use run-sas-program)
-
-PARAMETERS
-- limit: number (default: 10) — number of jobs per page
-- start: number (default: 1) — 1-based page offset
-- where: string (default: '') — optional filter expression
-
-ROUTING RULES
-- list jobs → { start: 1, limit: 10 }
-- show me 25 jobs → { start: 1, limit: 25 }
-- next jobs → { start: previousStart + previousLimit, limit: previousLimit }
-
-EXAMPLES
-- list jobs → { start: 1, limit: 10 }
-- list 25 jobs → { start: 1, limit: 25 }
-- next jobs → { start: 11, limit: 10 }
-
-NEGATIVE EXAMPLES (do not route here)
-- find job abc (use find-job)
-- run job abc (use run-job)
-- list models (use list-models)
-- list tables in lib xyz (use list-tables)
-
-PAGINATION
-If returned length === limit, hint: next start = start + limit. Empty result with start > 1 means paged past end.
-
-ERRORS
-Surface backend error directly; never fabricate job names.
-  `;
-
-  let spec = {
-    name: 'list-jobs',
-    description: description,
-    inputSchema: z.object({
-      limit: z.number().optional(),
-      start: z.number().optional(),
-      where: z.string().optional()
-    }),
-  // No 'server' required; backend context is implicit in helper
-    handler: async (params) => {
-      // _listJob handles all validation and defaults
-      const result = await _listJobs(params);
-      return result;
-    }
-  }
-  return spec;
-}
-export default listJobs;
-
+/*
+ * Copyright © 2025, SAS Institute Inc., Cary, NC, USA.  All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { z } from 'zod';
+import _listJobs from '../toolHelpers/_listJobs.js';
+function listJobs(_appContext) {
+
+  let description = `
+list-jobs — enumerate SAS Viya job assets.
+
+USE when: list jobs, show jobs, browse jobs, list available jobs, next page
+DO NOT USE for: find single job (use find-job), execute job (use run-job), run job def (use run-jobdef), sas code (use run-sas-program)
+
+PARAMETERS
+- limit: number (default: 10) — number of jobs per page
+- start: number (default: 1) — 1-based page offset
+- where: string (default: '') — optional filter expression
+
+ROUTING RULES
+- list jobs → { start: 1, limit: 10 }
+- show me 25 jobs → { start: 1, limit: 25 }
+- next jobs → { start: previousStart + previousLimit, limit: previousLimit }
+
+EXAMPLES
+- list jobs → { start: 1, limit: 10 }
+- list 25 jobs → { start: 1, limit: 25 }
+- next jobs → { start: 11, limit: 10 }
+
+NEGATIVE EXAMPLES (do not route here)
+- find job abc (use find-job)
+- run job abc (use run-job)
+- list models (use list-models)
+- list tables in lib xyz (use list-tables)
+
+PAGINATION
+If returned length === limit, hint: next start = start + limit. Empty result with start > 1 means paged past end.
+
+ERRORS
+Surface backend error directly; never fabricate job names.
+  `;
+
+  let spec = {
+    name: 'list-jobs',
+    description: description,
+    inputSchema: z.object({
+      limit: z.number().optional(),
+      start: z.number().optional(),
+      where: z.string().optional()
+    }),
+  // No 'server' required; backend context is implicit in helper
+    handler: async (params) => {
+      // _listJob handles all validation and defaults
+      const result = await _listJobs(params);
+      return result;
+    }
+  }
+  return spec;
+}
+export default listJobs;
+

package/src/toolSet/listLibraries.js

@@ -1,78 +1,78 @@
-/*
- * 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 listLibraries(_appContext) {
-  let description = `
-list-libraries — enumerate CAS or SAS libraries.
-
-USE when user asks to: list/show/enumerate libraries, caslibs, sas libs, or available libraries.
-DO NOT USE for: listing tables in a library (→ list-tables), column/table metadata, job execution, models, scoring.
-
-PARAMETERS
-- server: 'cas' | 'sas' | 'all' (default: 'all')
-- limit: integer > 0 (default: 10)
-- start: 1-based offset (default: 1)
-- where: optional filter expression (default: '')
-
-ROUTING RULES
-- "cas libs / cas libraries / in cas"         → { server: 'cas' }
-- "sas libs / sas libraries / in sas"         → { server: 'sas' }
-- "all libs / all libraries"                  → { server: 'all' }
-- "list tables in <libname>"                  → route to list-tables, NOT here
-- server unspecified                          → default { server: 'all' }
-- "all cas libs" with no limit specified      → { server: 'cas', limit: 50 } + paging note
-- "next" after prior call (start:S, limit:L) → { start: S + L, limit: L }
-- ambiguous "list" or "libs" with no context → assume { server: 'cas' }
-
-EXAMPLES
-- "list libraries"              → { server: 'all', start: 1, limit: 10 }
-- "list libs     "              → { server: 'all', start: 1, limit: 10 }
-
-- "list all libs"               → { server: 'all', start: 1, limit: 10 }
-- "list cas libraries"          → { server: 'cas', start: 1, limit: 10 }
-- "show me 25 sas libs"         → { server: 'sas', limit: 25, start: 1 }
-- "next" (prev: start:1,limit:10) → { server: <same>, start: 11, limit: 10 }
-- "filter cas libs" (no filter given) → ask: "What filter expression should I apply?"
-
-NEGATIVE EXAMPLES (do not route here)
-- "list tables in SASHELP"      → list-tables
-- "list models / jobs / jobdefs"→ respective tools
-- "run a program to create a lib" → run-sas-program
-
-PAGINATION
-If returned item count === limit, hint: next start = start + limit.
-If start > 1 and result is empty, note paging may have exceeded available items.
-
-ERRORS
-Return structured error with a message field. Never hallucinate library names.
-`;
-
-
-  // Canonical kebab-case tool name; legacy aliases preserved for compatibility
-  
- 
-  let spec = {
-    name: 'list-libraries',
-    description: description,
-    inputSchema: z.object({
-      server: z.string().optional(),
-      limit: z.number().optional(),
-      start: z.number().optional(),
-      where: z.string().optional()
-    }),
-    // 'server' has a default so we don't mark it required
-    handler: async (params) => {
-      // normalize server just in case caller sends 'CAS'/'SAS'
-      params.server = (params.server || 'all').toLowerCase();
-      
-      let r = await _listLibrary(params);
-      return r;
-    }
-  };
-  return spec;
-}
-export default listLibraries;
-     
+/*
+ * 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 listLibraries(_appContext) {
+  let description = `
+list-libraries — enumerate CAS or SAS libraries.
+
+USE when user asks to: list/show/enumerate libraries, caslibs, sas libs, or available libraries.
+DO NOT USE for: listing tables in a library (→ list-tables), column/table metadata, job execution, models, scoring.
+
+PARAMETERS
+- server: 'cas' | 'sas' | 'all' (default: 'all')
+- limit: integer > 0 (default: 10)
+- start: 1-based offset (default: 1)
+- where: optional filter expression (default: '')
+
+ROUTING RULES
+- "cas libs / cas libraries / in cas"         → { server: 'cas' }
+- "sas libs / sas libraries / in sas"         → { server: 'sas' }
+- "all libs / all libraries"                  → { server: 'all' }
+- "list tables in <libname>"                  → route to list-tables, NOT here
+- server unspecified                          → default { server: 'all' }
+- "all cas libs" with no limit specified      → { server: 'cas', limit: 50 } + paging note
+- "next" after prior call (start:S, limit:L) → { start: S + L, limit: L }
+- ambiguous "list" or "libs" with no context → assume { server: 'cas' }
+
+EXAMPLES
+- "list libraries"              → { server: 'all', start: 1, limit: 10 }
+- "list libs     "              → { server: 'all', start: 1, limit: 10 }
+
+- "list all libs"               → { server: 'all', start: 1, limit: 10 }
+- "list cas libraries"          → { server: 'cas', start: 1, limit: 10 }
+- "show me 25 sas libs"         → { server: 'sas', limit: 25, start: 1 }
+- "next" (prev: start:1,limit:10) → { server: <same>, start: 11, limit: 10 }
+- "filter cas libs" (no filter given) → ask: "What filter expression should I apply?"
+
+NEGATIVE EXAMPLES (do not route here)
+- "list tables in SASHELP"      → list-tables
+- "list models / jobs / jobdefs"→ respective tools
+- "run a program to create a lib" → run-sas-program
+
+PAGINATION
+If returned item count === limit, hint: next start = start + limit.
+If start > 1 and result is empty, note paging may have exceeded available items.
+
+ERRORS
+Return structured error with a message field. Never hallucinate library names.
+`;
+
+
+  // Canonical kebab-case tool name; legacy aliases preserved for compatibility
+  
+ 
+  let spec = {
+    name: 'list-libraries',
+    description: description,
+    inputSchema: z.object({
+      server: z.string().optional(),
+      limit: z.number().optional(),
+      start: z.number().optional(),
+      where: z.string().optional()
+    }),
+    // 'server' has a default so we don't mark it required
+    handler: async (params) => {
+      // normalize server just in case caller sends 'CAS'/'SAS'
+      params.server = (params.server || 'all').toLowerCase();
+      
+      let r = await _listLibrary(params);
+      return r;
+    }
+  };
+  return spec;
+}
+export default listLibraries;
+