@sassoftware/sas-score-mcp-serverjs 1.0.1-8 → 1.1.1

package/src/toolSet/findLibrary.js

@@ -1,40 +1,44 @@
-/*
- * Copyright © 2025, SAS Institute Inc., Cary, NC, USA.  All Rights Reserved.
+/*
+ * 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.
+  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 list-libraries), find table/job/jobdef/model (use respective tools), table structure (use table-info), create library (use run-sas-program)
+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' (default: 'cas') — target environment
+- 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 list-libraries instead
-- "tables in <lib>" → use list-tables instead
+- "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" }
+- "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)
+- "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.
@@ -57,7 +61,7 @@ Returns { libraries: [] } if not found; { libraries: [name, ...] } if found. Nev
       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;
     }
@@ -66,3 +70,4 @@ Returns { libraries: [] } if not found; { libraries: [name, ...] } if found. Nev
 }
 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;
+
+

package/src/toolSet/findTable.js

@@ -1,43 +1,48 @@
-/*
- * Copyright © 2025, SAS Institute Inc., Cary, NC, USA.  All Rights Reserved.
+/*
+ * Copyright © 2025, SAS Institute Inc., Cary, NC, USA.  All Rights Reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
 
 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 = `
-find-table — locate a specific table in a CAS or SAS library.
+  const isAgent = _appContext && _appContext.agent;
+  let description = isAgent ? `
+find-table — verify a table exists in a library.
+PARAMS: lib (string, required), name (string, required), server ('cas'|'sas', required)
+RETURNS: table metadata if found, error if not found
+` : `
+find-table — locate a specific table in a CAS or SAS library.
 
 USE when: find table, does table exist, is table in library, verify table exists, locate table
-DO NOT USE for: list tables (use list-tables), table schema/columns (use table-info), read table data (use read-table), find lib/job/model (use respective tools)
+DO NOT USE for: list tables (use ${_appContext.brand}-list-tables), table schema/columns (use ${_appContext.brand}-table-describe), read table data (use ${_appContext.brand}-read-table), find lib/job/model (use respective tools)
 
 PARAMETERS
-- lib: string (required) — library name (e.g., 'Public', 'sashelp')
-- name: string (required) — table name to locate
-- server: 'cas' | 'sas' . If not specified set it to 'cas' — target environment
+- lib: string (required) — library name (e.g., 'Public', 'sashelp')
+- name: string (required) — table name to locate
+- server: 'cas' | 'sas' (required) — target environment
 
 ROUTING RULES
-- "find table <name> in <lib>" → { lib: "<lib>", name: "<name>", server: "cas" }
-- "find table <name> in <lib> in sas" → { lib: "<lib>", name: "<name>", server: "sas" }
-- "does table <name> exist in <lib>" → { lib: "<lib>", name: "<name>", server: "cas" }
-- "find table" with missing lib → ask "Which library contains the table?"
-- "find table" with missing name → ask "Which table name would you like to find?"
-- "list tables in <lib>" → use list-tables instead
+- "find table <name> in <lib>" → { lib: "<lib>", name: "<name>", server: "cas" }
+- "find table <name> in <lib> in sas" → { lib: "<lib>", name: "<name>", server: "sas" }
+- "does table <name> exist in <lib>" → { lib: "<lib>", name: "<name>", server: "cas" }
+- "find table" with missing lib → ask "Which library contains the table?"
+- "find table" with missing name → ask "Which table name would you like to find?"
+- "list tables in <lib>" → use ${_appContext.brand}-list-tables instead
 
 EXAMPLES
-- "find table iris in Public" → { lib: "Public", name: "iris", server: "cas" }
-- "find table cars in sashelp in sas" → { lib: "sashelp", name: "cars", server: "sas" }
-- "does customers exist in mylib" → { lib: "mylib", name: "customers", server: "cas" }
-- "verify table orders in Samples" → { lib: "Samples", name: "orders", server: "cas" }
+- "find table iris in Public" → { lib: "Public", name: "iris", server: "cas" }
+- "find table cars in sashelp in sas" → { lib: "sashelp", name: "cars", server: "sas" }
+- "does customers exist in mylib" → { lib: "mylib", name: "customers", server: "cas" }
+- "verify table orders in Samples" → { lib: "Samples", name: "orders", server: "cas" }
 
 NEGATIVE EXAMPLES (do not route here)
-- "list tables in Public" (use list-tables)
-- "find library Public" (use find-library)
-- "what columns in cars?" (use table-info)
-- "read data from customers" (use read-table)
+- "list tables in Public" (use ${_appContext.brand}-list-tables)
+- "find library Public" (use ${_appContext.brand}-find-library)
+- "what columns in cars?" (use ${_appContext.brand}-table-describe)
+- "read data from customers" (use ${_appContext.brand}-read-table)
 
 ERRORS
 Returns { tables: [] } if not found; { tables: [name, ...] } if found. Never hallucinate table names.
@@ -47,14 +52,15 @@ Returns { tables: [] } if not found; { tables: [name, ...] } if found. Never hal
     name: 'find-table',
     description: description,
     inputSchema: z.object({
-      lib: z.string(),
-      name: z.string(),
-      server: z.string() 
+      lib: z.string().min(1),
+      name: z.string().min(1),
+      server: z.enum(['cas', 'sas'])
     }),
     
     handler: async (params) => {
       // Check if the params.scenario is a string and parse it
-      let r = await _listTables(params);
+      params.tool = 'find';
+      let r = await _findTable(params);
       return r;
     }
   }
@@ -63,3 +69,4 @@ Returns { tables: [] } if not found; { tables: [name, ...] } if found. Never hal
 
 export default findTable;
 
+

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 read-table), model info (use model-info), find/run job (use find-job/run-job), set context (use 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 set-context instead (no params)
-- "set <var> to <value>" → use set-context or run-sas-program 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 read-table)
-- "Get model details for myModel" (use model-info)
-- "Set the CAS server to finance-prod" (use 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;
+

package/src/toolSet/jobDescribe.js

@@ -0,0 +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;
+

package/src/toolSet/jobScore.js

@@ -0,0 +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;
+

package/src/toolSet/jobdefDescribe.js

@@ -0,0 +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;
+