@sassoftware/sas-score-mcp-serverjs 1.1.1 → 1.1.3

package/src/toolSet/findJob.js

@@ -1,74 +1,74 @@
-/*
- * 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';
-import _findJob from '../toolHelpers/_findJob.js';
-function findJob(_appContext) {
-  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 ${_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 ${_appContext.brand}-list-jobs instead
-- "score job <name>" → use ${_appContext.brand}-job-score 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 ${_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.
-  `;
-
-  let spec = {
-    name: 'find-job',
-    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);
-        }
-      }
-      params.tool = 'find';
-      let r = await _findJob(params);
-      return r;
-    }
-  }
-    
-
-  /* correct spec for registerTool with inputSchema */
-  
-  return spec;
-}
-export default findJob;
-
+/*
+ * 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';
+import _findJob from '../toolHelpers/_findJob.js';
+function findJob(_appContext) {
+  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 ${_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 ${_appContext.brand}-list-jobs instead
+- "score job <name>" → use ${_appContext.brand}-job-score 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 ${_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.
+  `;
+
+  let spec = {
+    name: 'find-job',
+    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);
+        }
+      }
+      params.tool = 'find';
+      let r = await _findJob(params);
+      return r;
+    }
+  }
+    
+
+  /* correct spec for registerTool with inputSchema */
+  
+  return spec;
+}
+export default findJob;
+

package/src/toolSet/findJobdef.js

@@ -1,67 +1,67 @@
-/*
- * Copyright © 2025, SAS Institute Inc., Cary, NC, USA.  All Rights Reserved.
- * SPDX-License-Identifier: Apache-2.0
- */
-import { z } from 'zod';
-import _findJobdef from '../toolHelpers/_findJobdef.js';
-function findJobdef(_appContext) {
-  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 ${_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 ${_appContext.brand}-list-jobdefs instead
-- "score jobdef <name>" → use ${_appContext.brand}-jobdef-score instead
-
-EXAMPLES
-- "find jobdef cars_job_v4" → { name: "cars_job_v4" }
-- "does jobdef ETL exist" → { name: "ETL" }
-- "is there a jobdef named metricsRefresh" → { name: "metricsRefresh" }
-
-NEGATIVE EXAMPLES (do not route here)
-- "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.
-  `;
-
-  let spec = {
-    name: 'find-jobdef',
-    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);
-        }
-      }
-      params.tool = 'find';
-      let r = await _findJobdef(params);
-      return r;
-    }
-  }
-  return spec;
-}
-export default findJobdef;
-
+/*
+ * Copyright © 2025, SAS Institute Inc., Cary, NC, USA.  All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { z } from 'zod';
+import _findJobdef from '../toolHelpers/_findJobdef.js';
+function findJobdef(_appContext) {
+  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 ${_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 ${_appContext.brand}-list-jobdefs instead
+- "score jobdef <name>" → use ${_appContext.brand}-jobdef-score instead
+
+EXAMPLES
+- "find jobdef cars_job_v4" → { name: "cars_job_v4" }
+- "does jobdef ETL exist" → { name: "ETL" }
+- "is there a jobdef named metricsRefresh" → { name: "metricsRefresh" }
+
+NEGATIVE EXAMPLES (do not route here)
+- "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.
+  `;
+
+  let spec = {
+    name: 'find-jobdef',
+    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);
+        }
+      }
+      params.tool = 'find';
+      let r = await _findJobdef(params);
+      return r;
+    }
+  }
+  return spec;
+}
+export default findJobdef;
+

package/src/toolSet/findLibrary.js

@@ -1,73 +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) {
-  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;
-
-
+/*
+ * 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

@@ -4,7 +4,7 @@
  */
 
 import { z } from 'zod';
-import _findmas from '../toolHelpers/_findmas.js';
+import _findMas from '../toolHelpers/_findMas.js';
 
 
 function findMas(_appContext) {
@@ -60,7 +60,7 @@ Returns { mass: [] } if not found; { mass: [name, ...] } if found. Never halluci
         }
       }
       params.tool = 'find';
-      let r = await _findmas(params);
+      let r = await _findMas(params);
       return r;
     }
   }

package/src/toolSet/getEnv.js

@@ -1,57 +1,57 @@
-/*
- * Copyright © 2025, SAS Institute Inc., Cary, NC, USA.  All Rights Reserved.
- * SPDX-License-Identifier: Apache-2.0
- */
-
-import {z} from 'zod';
-import _getEnv from '../toolHelpers/_getEnv.js';
-function getEnv(_appContext) {
-    let description = `
-get-env — retrieve a variable value from the runtime environment.
-
-USE when: what is the value of, get me, show current, what's the, retrieve environment variable
-DO NOT USE for: read table data (use ${_appContext.brand}-read-table), model info (use ${_appContext.brand}-model-info), find/score job (use ${_appContext.brand}-find-job/${_appContext.brand}-job-score), set context (use ${_appContext.brand}-set-context)
-
-PARAMETERS
-- name: string (required) — variable name to retrieve (case-sensitive)
-
-ROUTING RULES
-- "what is the value of <var>" → { name: "<var>" }
-- "get me <var>" → { name: "<var>" }
-- "show <var>" → { name: "<var>" }
-- "get" with no variable → ask "Which variable would you like to retrieve?"
-    - "what context am I using" → use ${_appContext.brand}-set-context instead (no params)
-    - "set <var> to <value>" → use ${_appContext.brand}-set-context or ${_appContext.brand}-program-score instead
-
-EXAMPLES
-- "What's the value of myVar" → { name: "myVar" }
-- "Get me the configuration variable" → { name: "configuration" }
-- "Show the current server setting" → { name: "server" }
-
-NEGATIVE EXAMPLES (do not route here)
--- "Read rows from customers" (use ${_appContext.brand}-read-table)
--- "Get model details for myModel" (use ${_appContext.brand}-model-info)
--- "Set the CAS server to finance-prod" (use ${_appContext.brand}-set-context)
-
-ERRORS
-Returns variable name with current value, or null if not found. Return structured error with message field.
-    `;
-  
-    let spec = {
-    name: 'get-env',
-    description: description,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                name: { type: 'string' }
-            },
-            required: ['name']
-        },
-    handler: async (params) => {
-            return await _getEnv(params);
-        }
-    }
-    return spec;
-}
-export default getEnv;
-
+/*
+ * Copyright © 2025, SAS Institute Inc., Cary, NC, USA.  All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import {z} from 'zod';
+import _getEnv from '../toolHelpers/_getEnv.js';
+function getEnv(_appContext) {
+    let description = `
+get-env — retrieve a variable value from the runtime environment.
+
+USE when: what is the value of, get me, show current, what's the, retrieve environment variable
+DO NOT USE for: read table data (use ${_appContext.brand}-read-table), model info (use ${_appContext.brand}-model-info), find/score job (use ${_appContext.brand}-find-job/${_appContext.brand}-job-score), set context (use ${_appContext.brand}-set-context)
+
+PARAMETERS
+- name: string (required) — variable name to retrieve (case-sensitive)
+
+ROUTING RULES
+- "what is the value of <var>" → { name: "<var>" }
+- "get me <var>" → { name: "<var>" }
+- "show <var>" → { name: "<var>" }
+- "get" with no variable → ask "Which variable would you like to retrieve?"
+    - "what context am I using" → use ${_appContext.brand}-set-context instead (no params)
+    - "set <var> to <value>" → use ${_appContext.brand}-set-context or ${_appContext.brand}-program-score instead
+
+EXAMPLES
+- "What's the value of myVar" → { name: "myVar" }
+- "Get me the configuration variable" → { name: "configuration" }
+- "Show the current server setting" → { name: "server" }
+
+NEGATIVE EXAMPLES (do not route here)
+-- "Read rows from customers" (use ${_appContext.brand}-read-table)
+-- "Get model details for myModel" (use ${_appContext.brand}-model-info)
+-- "Set the CAS server to finance-prod" (use ${_appContext.brand}-set-context)
+
+ERRORS
+Returns variable name with current value, or null if not found. Return structured error with message field.
+    `;
+  
+    let spec = {
+    name: 'get-env',
+    description: description,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                name: { type: 'string' }
+            },
+            required: ['name']
+        },
+    handler: async (params) => {
+            return await _getEnv(params);
+        }
+    }
+    return spec;
+}
+export default getEnv;
+