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

package/src/toolSet/jobDescribe.js

@@ -1,65 +1,65 @@
-/*
- * Copyright © 2025, SAS Institute Inc., Cary, NC, USA.  All Rights Reserved.
- * SPDX-License-Identifier: Apache-2.0
- */
-import { z } from 'zod';
-import _findJob from '../toolHelpers/_findJob.js';
-function jobDescribe(_appContext) {
-  const isAgent = _appContext && _appContext.agent;
-  let description = isAgent ? `
-job-describe — return input schema for a Job model.
-PARAMS: intent ('describe', required), name (string, required)
-RETURNS: job input variable definitions
-` : `
-job-describe — return information about a specific SAS Viya job.
-
-USE when: describe job, show job details, what does job X do, job metadata, inputs/outputs for job
-DO NOT USE for: find job or verify it exists (use ${_appContext.brand}-find-job), list jobs (use ${_appContext.brand}-list-jobs), score job (use ${_appContext.brand}-job-score)
-
-PARAMETERS
-- intent: must be 'describe' — only pass if user explicitly asked to describe/inspect a job. Do NOT use for find or verify existence.
-- 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" }
-- "describe metricsRefresh.job" → { 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 job metadata 
-  `;
-
-  let spec = {
-    name: 'job-describe',
-    description: description,
-    inputSchema: z.object({
-      intent: z.literal('describe'),
-      name: z.string()
-    }),
-    handler: async (params) => {
-      const { intent, ...rest } = params;
-      if (rest.name != null && rest.name.endsWith('.job')) {
-        rest.name = rest.name.slice(0, -4);
-      }
-      rest.tool = 'describe';
-      let r = await _findJob(rest); 
-      return r;
-    }
-  }
-    
-
-  /* correct spec for registerTool with inputSchema */
-  
-  return spec;
-}
-export default jobDescribe;
-
+/*
+ * Copyright © 2025, SAS Institute Inc., Cary, NC, USA.  All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { z } from 'zod';
+import _findJob from '../toolHelpers/_findJob.js';
+function jobDescribe(_appContext) {
+  const isAgent = _appContext && _appContext.agent;
+  let description = isAgent ? `
+job-describe — return input schema for a Job model.
+PARAMS: intent ('describe', required), name (string, required)
+RETURNS: job input variable definitions
+` : `
+job-describe — return information about a specific SAS Viya job.
+
+USE when: describe job, show job details, what does job X do, job metadata, inputs/outputs for job
+DO NOT USE for: find job or verify it exists (use ${_appContext.brand}-find-job), list jobs (use ${_appContext.brand}-list-jobs), score job (use ${_appContext.brand}-job-score)
+
+PARAMETERS
+- intent: must be 'describe' — only pass if user explicitly asked to describe/inspect a job. Do NOT use for find or verify existence.
+- 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" }
+- "describe metricsRefresh.job" → { 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 job metadata 
+  `;
+
+  let spec = {
+    name: 'job-describe',
+    description: description,
+    inputSchema: z.object({
+      intent: z.literal('describe'),
+      name: z.string()
+    }),
+    handler: async (params) => {
+      const { intent, ...rest } = params;
+      if (rest.name != null && rest.name.endsWith('.job')) {
+        rest.name = rest.name.slice(0, -4);
+      }
+      rest.tool = 'describe';
+      let r = await _findJob(rest); 
+      return r;
+    }
+  }
+    
+
+  /* correct spec for registerTool with inputSchema */
+  
+  return spec;
+}
+export default jobDescribe;
+

package/src/toolSet/jobScore.js

@@ -1,90 +1,90 @@
-/*
- * 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 jobScore(_appContext) {
-  const isAgent = _appContext && _appContext.agent;
-
-  let description = isAgent ? `
-job-score — score by executing a SAS Viya Job model.
-PARAMS: name (string, required), scenario (object, optional)
-RETURNS: job log, ODS output, and any result tables
-` : `
-job-score — score with a deployed SAS Viya job model.
-
-USE when: score with job, run job, execute job model
-DO NOT USE for: arbitrary SAS code (use program-score), macros (use macro-score), list/find jobs
-
-PARAMETERS
-- name: string — job name (required)
-- scenario: object — input parameters as JSON (optional, defaults to {}). Example: {month:10, year:2025}
-
-ROUTING RULES
-- "score with job xyz" → { name: "xyz" }
-- "score with job xyz with param1=10, param2=val2" → { name: "xyz", scenario: {param1:10, param2:"val2"} }
-- "run job xyz" → { name: "xyz" }
-- "run job xyz with param1=10, param2=val2" → { name: "xyz", scenario: {param1:10, param2:"val2"} }
-
-EXAMPLES
-- "score with job xyz" → { name: "xyz" }
-- "score with job monthly_etl with month=10, year=2025" → { name: "monthly_etl", scenario: {month:10, year:2025} }
-- "score with monthly_etl.job with month=10, year=2025" → { name: "monthly_etl", scenario: {month:10, year:2025} }
-- "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 program-score)
-- "score macro X" (use macro-score)
-- "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: 'job-score',
-    description: description,
-    inputSchema: z.object({
-      name: z.string(),
-      scenario: z.any()
-    }),
-    handler: async (params) => {
-      let {scenario, name} = params;
-
-      if(name.endsWith('.job')) {
-        params.name = name.slice(0, -4);
-      }
-      // 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;
-      params.type = 'job';
-      // Provide runtime context for auth and server settings
-      let r = await _jobSubmit(params);
-      return r;
-    }
-  };
-  return spec;
-}
-
-export default jobScore;
-
+/*
+ * 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 jobScore(_appContext) {
+  const isAgent = _appContext && _appContext.agent;
+
+  let description = isAgent ? `
+job-score — score by executing a SAS Viya Job model.
+PARAMS: name (string, required), scenario (object, optional)
+RETURNS: job log, ODS output, and any result tables
+` : `
+job-score — score with a deployed SAS Viya job model.
+
+USE when: score with job, run job, execute job model
+DO NOT USE for: arbitrary SAS code (use program-score), macros (use macro-score), list/find jobs
+
+PARAMETERS
+- name: string — job name (required)
+- scenario: object — input parameters as JSON (optional, defaults to {}). Example: {month:10, year:2025}
+
+ROUTING RULES
+- "score with job xyz" → { name: "xyz" }
+- "score with job xyz with param1=10, param2=val2" → { name: "xyz", scenario: {param1:10, param2:"val2"} }
+- "run job xyz" → { name: "xyz" }
+- "run job xyz with param1=10, param2=val2" → { name: "xyz", scenario: {param1:10, param2:"val2"} }
+
+EXAMPLES
+- "score with job xyz" → { name: "xyz" }
+- "score with job monthly_etl with month=10, year=2025" → { name: "monthly_etl", scenario: {month:10, year:2025} }
+- "score with monthly_etl.job with month=10, year=2025" → { name: "monthly_etl", scenario: {month:10, year:2025} }
+- "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 program-score)
+- "score macro X" (use macro-score)
+- "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: 'job-score',
+    description: description,
+    inputSchema: z.object({
+      name: z.string(),
+      scenario: z.any()
+    }),
+    handler: async (params) => {
+      let {scenario, name} = params;
+
+      if(name.endsWith('.job')) {
+        params.name = name.slice(0, -4);
+      }
+      // 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;
+      params.type = 'job';
+      // Provide runtime context for auth and server settings
+      let r = await _jobSubmit(params);
+      return r;
+    }
+  };
+  return spec;
+}
+
+export default jobScore;
+

package/src/toolSet/jobdefDescribe.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 jobdefDescribe(_appContext) {
-  const isAgent = _appContext && _appContext.agent;
-  let description = isAgent ? `
-jobdef-describe — return input schema for a JobDef model.
-PARAMS: intent ('describe', required), name (string, required)
-RETURNS: jobdef input variable definitions
-` : `
-jobdef-describe — return information about a specific SAS Viya jobdef.
-
-USE when: describe jobdef, show jobdef details, what does jobdef X do, jobdef metadata, inputs/outputs for jobdef
-DO NOT USE for: find jobdef or verify it exists (use ${_appContext.brand}-find-jobdef), list jobdefs (use ${_appContext.brand}-list-jobdefs), score jobdef (use ${_appContext.brand}-jobdef-score)
-
-PARAMETERS
-- intent: must be 'describe' — only pass if user explicitly asked to describe/inspect a jobdef. Do NOT use for find or verify existence.
-- 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 <name.jobdef>"  
-- "describe model <name.jobdef>"
-- "info for jobdef <name>" → { name: "<name>" }
-
-EXAMPLES
-- "describe jobdef cars_job_v4" → { name: "cars_job_v4" }
-- "describe metricsRefresh.jobdef" → { name: "metricsRefresh" }
-- "info for jobdef ETL" → { name: "ETL" }
-
-NEGATIVE EXAMPLES (do not route here)
-- "list jobdefs" (use ${_appContext.brand}-list-jobdefs)
-- "score jobdef cars_job_v4" (use ${_appContext.brand}-jobdef-score)
-- "execute jobdef cars_job_v4" (use ${_appContext.brand}-jobdef-score)
-
-ERRORS
-Returns job metadata 
-  `;
-
-  let spec = {
-    name: 'jobdef-describe',
-    description: description,
-    inputSchema: z.object({
-      intent: z.literal('describe'),
-      name: z.string()
-    }),
-    handler: async (params) => {
-      const { intent, ...rest } = params;
-      if (rest.name != null && rest.name.endsWith('.jobdef')) {
-        rest.name = rest.name.slice(0, -7);
-      }
-      rest.tool = 'describe';
-      let r = await _findJobdef(rest);
-      return r;
-    }
-  }
-    
-
-  /* correct spec for registerTool with inputSchema */
-  
-  return spec;
-}
-export default jobdefDescribe;
-
+/*
+ * 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 jobdefDescribe(_appContext) {
+  const isAgent = _appContext && _appContext.agent;
+  let description = isAgent ? `
+jobdef-describe — return input schema for a JobDef model.
+PARAMS: intent ('describe', required), name (string, required)
+RETURNS: jobdef input variable definitions
+` : `
+jobdef-describe — return information about a specific SAS Viya jobdef.
+
+USE when: describe jobdef, show jobdef details, what does jobdef X do, jobdef metadata, inputs/outputs for jobdef
+DO NOT USE for: find jobdef or verify it exists (use ${_appContext.brand}-find-jobdef), list jobdefs (use ${_appContext.brand}-list-jobdefs), score jobdef (use ${_appContext.brand}-jobdef-score)
+
+PARAMETERS
+- intent: must be 'describe' — only pass if user explicitly asked to describe/inspect a jobdef. Do NOT use for find or verify existence.
+- 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 <name.jobdef>"  
+- "describe model <name.jobdef>"
+- "info for jobdef <name>" → { name: "<name>" }
+
+EXAMPLES
+- "describe jobdef cars_job_v4" → { name: "cars_job_v4" }
+- "describe metricsRefresh.jobdef" → { name: "metricsRefresh" }
+- "info for jobdef ETL" → { name: "ETL" }
+
+NEGATIVE EXAMPLES (do not route here)
+- "list jobdefs" (use ${_appContext.brand}-list-jobdefs)
+- "score jobdef cars_job_v4" (use ${_appContext.brand}-jobdef-score)
+- "execute jobdef cars_job_v4" (use ${_appContext.brand}-jobdef-score)
+
+ERRORS
+Returns job metadata 
+  `;
+
+  let spec = {
+    name: 'jobdef-describe',
+    description: description,
+    inputSchema: z.object({
+      intent: z.literal('describe'),
+      name: z.string()
+    }),
+    handler: async (params) => {
+      const { intent, ...rest } = params;
+      if (rest.name != null && rest.name.endsWith('.jobdef')) {
+        rest.name = rest.name.slice(0, -7);
+      }
+      rest.tool = 'describe';
+      let r = await _findJobdef(rest);
+      return r;
+    }
+  }
+    
+
+  /* correct spec for registerTool with inputSchema */
+  
+  return spec;
+}
+export default jobdefDescribe;
+

package/src/toolSet/jobdefScore.js

@@ -1,85 +1,85 @@
-/*
- * 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 jobdefScore(_appContext) {
-  // JSON object for LLM/tooling
-  const isAgent = _appContext && _appContext.agent;
-  let description = isAgent ? `
-jobdef-score — score by executing a SAS Viya JobDef model.
-PARAMS: name (string, required), scenario (object, optional)
-RETURNS: jobdef log, ODS output, and any result tables
-` : `
-jobdef-score — score with a deployed SAS Viya job definition model.
-
-USE when: score with jobdef, run jobdef, execute jobdef model
-DO NOT USE for: arbitrary SAS code (use program-score), macros (use macro-score), list/find jobdefs
-
-PARAMETERS
-- name: string — jobdef name (required)
-- scenario: object — input parameters as JSON (optional, defaults to {}). Example: {month:10, year:2025}
-
-ROUTING RULES
-- "score jobdef xyz" → { name: "xyz" }
-- "score jobdef xyz with param1=10, param2=val2" → { name: "xyz", scenario: {param1:10, param2:"val2"} }
-
-EXAMPLES
-- "score jobdef xyz" → { name: "xyz" }
-- "score 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 program-score)
-- "score macro X" (use macro-score)
-- "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: 'jobdef-score',
-    description: description,
-    inputSchema: z.object({
-      name: z.string(),
-      scenario: z.any()
-    }),
-    handler: async (params) => {
-      let {scenario, name} = params;
-
-      if (name.endsWith('.job')) {
-        params.name = name.slice(0, -4);
-      }
-      // 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;      
-      params.type = 'def';
-      // Provide runtime context for auth and server settings
-      let r = await _jobSubmit(params);
-      return r;
-    }
-  };
-  return spec;
-}
-
-export default jobdefScore;
-
+/*
+ * 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 jobdefScore(_appContext) {
+  // JSON object for LLM/tooling
+  const isAgent = _appContext && _appContext.agent;
+  let description = isAgent ? `
+jobdef-score — score by executing a SAS Viya JobDef model.
+PARAMS: name (string, required), scenario (object, optional)
+RETURNS: jobdef log, ODS output, and any result tables
+` : `
+jobdef-score — score with a deployed SAS Viya job definition model.
+
+USE when: score with jobdef, run jobdef, execute jobdef model
+DO NOT USE for: arbitrary SAS code (use program-score), macros (use macro-score), list/find jobdefs
+
+PARAMETERS
+- name: string — jobdef name (required)
+- scenario: object — input parameters as JSON (optional, defaults to {}). Example: {month:10, year:2025}
+
+ROUTING RULES
+- "score jobdef xyz" → { name: "xyz" }
+- "score jobdef xyz with param1=10, param2=val2" → { name: "xyz", scenario: {param1:10, param2:"val2"} }
+
+EXAMPLES
+- "score jobdef xyz" → { name: "xyz" }
+- "score 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 program-score)
+- "score macro X" (use macro-score)
+- "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: 'jobdef-score',
+    description: description,
+    inputSchema: z.object({
+      name: z.string(),
+      scenario: z.any()
+    }),
+    handler: async (params) => {
+      let {scenario, name} = params;
+
+      if (name.endsWith('.job')) {
+        params.name = name.slice(0, -4);
+      }
+      // 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;      
+      params.type = 'def';
+      // Provide runtime context for auth and server settings
+      let r = await _jobSubmit(params);
+      return r;
+    }
+  };
+  return spec;
+}
+
+export default jobdefScore;
+