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

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;
+

package/src/toolSet/jobdefScore.js

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

package/src/toolSet/listJobdefs.js

@@ -5,14 +5,19 @@
 import { z } from 'zod';
 import _listJobdefs from '../toolHelpers/_listJobdefs.js';
 function listJobdefs(_appContext) {
-
-  let description = `
+  const isAgent = _appContext && _appContext.agent;
+  let description = isAgent ? `
+list-jobdefs — list available JobDef models.
+PARAMS: intent ('list', required), start (number, default 1), limit (number, default 10)
+RETURNS: array of jobdef names and metadata
+` : `
 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)
+DO NOT USE for: find single jobdef (use ${_appContext.brand}-find-jobdef), score jobdef (use ${_appContext.brand}-jobdef-score), find job (use ${_appContext.brand}-find-job), sas code (use ${_appContext.brand}-program-score)
 
 PARAMETERS
+- intent: must be 'list' — only pass if user explicitly asked to list/enumerate jobdefs. Do NOT use for find, verify, or execute.
 - limit: number (default: 10) — number of jobdefs per page
 - start: number (default: 1) — 1-based page offset
 - where: string (default: '') — optional filter expression
@@ -28,10 +33,12 @@ EXAMPLES
 - 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)
+- find jobdef abc (use ${_appContext.brand}-find-jobdef)
+- does jobdef X exist (use ${_appContext.brand}-find-jobdef)
+- is jobdef X available (use ${_appContext.brand}-find-jobdef)
+- list jobs (use ${_appContext.brand}-list-jobs)
+- score jobdef abc (use ${_appContext.brand}-jobdef-score)
+- list models (use ${_appContext.brand}-list-models)
 
 PAGINATION
 If returned length === limit, hint: next start = start + limit. Empty result with start > 1 means paged past end.
@@ -44,6 +51,7 @@ Surface backend error directly; never fabricate jobdef names.
     name: 'list-jobdefs',
     description: description,
     inputSchema: z.object({
+      intent: z.literal('list'),
       limit: z.number().optional(),
       start: z.number().optional(),
       where: z.string().optional()
@@ -51,7 +59,8 @@ Surface backend error directly; never fabricate jobdef names.
   // No 'server' required; backend context is implicit in helper
     handler: async (params) => {
       // _listJobdefs handles all validation and defaults
-      const result = await _listJobdefs(params);
+      const { intent, ...rest } = params;
+      const result = await _listJobdefs(rest);
       return result;
     }
   }

package/src/toolSet/listJobs.js

@@ -5,14 +5,19 @@
 import { z } from 'zod';
 import _listJobs from '../toolHelpers/_listJobs.js';
 function listJobs(_appContext) {
-
-  let description = `
+  const isAgent = _appContext && _appContext.agent;
+  let description = isAgent ? `
+list-jobs — list available Job models.
+PARAMS: intent ('list', required), start (number, default 1), limit (number, default 10)
+RETURNS: array of job names and metadata
+` : `
 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)
+DO NOT USE for: find single job (use ${_appContext.brand}-find-job), score job (use ${_appContext.brand}-job-score), score jobdef (use ${_appContext.brand}-jobdef-score), sas code (use ${_appContext.brand}-program-score)
 
 PARAMETERS
+- intent: must be 'list' — only pass if user explicitly asked to list/enumerate jobs. Do NOT use for find, verify, or execute.
 - limit: number (default: 10) — number of jobs per page
 - start: number (default: 1) — 1-based page offset
 - where: string (default: '') — optional filter expression
@@ -28,10 +33,10 @@ EXAMPLES
 - 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)
+- find job abc (use ${_appContext.brand}-find-job)
+- score job abc (use ${_appContext.brand}-job-score)
+- list models (use ${_appContext.brand}-list-models)
+- list tables in lib xyz (use ${_appContext.brand}-list-tables)
 
 PAGINATION
 If returned length === limit, hint: next start = start + limit. Empty result with start > 1 means paged past end.
@@ -44,6 +49,7 @@ Surface backend error directly; never fabricate job names.
     name: 'list-jobs',
     description: description,
     inputSchema: z.object({
+      intent: z.literal('list'),
       limit: z.number().optional(),
       start: z.number().optional(),
       where: z.string().optional()
@@ -51,7 +57,8 @@ Surface backend error directly; never fabricate job names.
   // No 'server' required; backend context is implicit in helper
     handler: async (params) => {
       // _listJob handles all validation and defaults
-      const result = await _listJobs(params);
+      const { intent, ...rest } = params;
+      const result = await _listJobs(rest);
       return result;
     }
   }

package/src/toolSet/listLibraries.js

@@ -5,13 +5,19 @@
 import { z } from 'zod';
 import _listLibrary from '../toolHelpers/_listLibrary.js';
 function listLibraries(_appContext) {
-  let description = `
+  const isAgent = _appContext && _appContext.agent;
+  let description = isAgent ? `
+list-libraries — list available libraries.
+PARAMS: intent ('list', required), server ('cas'|'sas'|'all', optional), start (number, default 1), limit (number, default 10)
+RETURNS: array of library names and server assignments
+` : `
 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.
+USE ONLY when: user explicitly asks to list, browse, or enumerate libraries — "list libraries", "show all libs", "browse libraries", "what libraries are available", "next page". Never use to verify if a specific library exists.
+DO NOT USE for: verify or check if a specific library exists (use ${_appContext.brand}-find-library instead), listing tables in a library (→ ${_appContext.brand}-list-tables), column/table metadata, job execution, models, scoring.
 
 PARAMETERS
+- intent: must be 'list' — only pass if user explicitly asked to list/enumerate libraries. Do NOT use for read, find, or verify.
 - server: 'cas' | 'sas' | 'all' (default: 'all')
 - limit: integer > 0 (default: 10)
 - start: 1-based offset (default: 1)
@@ -38,9 +44,9 @@ EXAMPLES
 - "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
+-- "list tables in SASHELP"      → ${_appContext.brand}-list-tables
+-- "list models / jobs / jobdefs"→ respective tools
+-- "score a program to create a lib" → ${_appContext.brand}-program-score
 
 PAGINATION
 If returned item count === limit, hint: next start = start + limit.
@@ -58,6 +64,7 @@ Return structured error with a message field. Never hallucinate library names.
     name: 'list-libraries',
     description: description,
     inputSchema: z.object({
+      intent: z.literal('list'),
       server: z.string().optional(),
       limit: z.number().optional(),
       start: z.number().optional(),
@@ -65,10 +72,9 @@ Return structured error with a message field. Never hallucinate library names.
     }),
     // '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);
+      const { intent, ...rest } = params;
+      rest.server = (rest.server || 'all').toLowerCase();
+      let r = await _listLibrary(rest);
       return r;
     }
   };

package/src/toolSet/listMas.js

@@ -0,0 +1,71 @@
+/*
+ * Copyright © 2025, SAS Institute Inc., Cary, NC, USA.  All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import { z } from 'zod';
+import _listMas from '../toolHelpers/_listMas.js';
+
+function listMas(_appContext) {
+  const isAgent = _appContext && _appContext.agent;
+  let description = isAgent ? `
+list-mas — list available MAS models.
+PARAMS: intent ('list', required), start (number, default 1), limit (number, default 10)
+RETURNS: array of MAS model names and metadata
+` : `
+list-mas — enumerate models published to MAS.
+
+USE ONLY when: user explicitly asks to browse or enumerate models — "list models", "show all models", "list mas", "next page". Never use to verify if a specific model exists.
+DO NOT USE for: verify or check if a specific model exists (use ${_appContext.brand}-find-mas or ${_appContext.brand}-find-model instead), find model, find mas, model metadata, score model, list jobs/tables/libraries
+
+PARAMETERS
+- intent: must be 'list' — only pass if user explicitly asked to list/enumerate MAS models. Do NOT use for read, find, or verify.
+- limit: number (default: 10) — page size
+- start: number (default: 1) — 1-based offset
+
+ROUTING RULES
+- "list models" → { start:1, limit:10 }
+- "list 25 models" → { start:1, limit:25 }
+- "next models" → { start: start+limit, limit:10 }
+- "list mas" → { start:1, limit:10 }
+- "list 25 mas" → { start:1, limit:25 }
+- "next mas" → { start: start+limit, limit:10 }
+
+EXAMPLES
+- "list models" → { start:1, limit:10 }
+- "list 25 models" → { start:1, limit:25 }
+- "list mas" → { start:1, limit:10 }
+- "list 25 mas" → { start:1, limit:25 }
+
+NEGATIVE EXAMPLES (do not route here)
+- "find model X" (use ${_appContext.brand}-find-mas)
+- "does model churn_predictor exist" (use ${_appContext.brand}-find-mas)
+- "is model X published to MAS" (use ${_appContext.brand}-find-mas)
+- "describe model X" (use ${_appContext.brand}-model-info)
+- "score model X" (use ${_appContext.brand}-model-score)
+- "list jobs" (use ${_appContext.brand}-list-jobs)
+
+ERRORS
+Returns empty array if no models found.
+  `;
+
+  let spec = {
+    name: 'list-mas',
+    description: description,
+    inputSchema: z.object({
+      intent: z.literal('list'),
+      limit: z.number().optional(),
+      start: z.number().optional()
+    }),
+    handler: async (params) => {
+      const { intent, ...rest } = params;
+      let r = await _listMas(rest);
+      return r;
+    }
+  }
+  
+  return spec;
+}
+
+export default listMas;
+