@sassoftware/sas-score-mcp-serverjs 1.0.1-19 → 1.0.1-21

package/.skills/skills/detail-strategy/SKILL.md

@@ -0,0 +1,234 @@
+---
+name: detail-strategy
+description: >
+  Unified detail/information retrieval strategy. Handles MAS models, SCR models, and tables.
+  Always verify resources exist using find-resources skill before retrieving details.
+---
+
+# Detail Strategy
+
+Use this strategy when the user requests information about a resource: model details, schema, metadata, inputs/outputs, or any descriptive information.
+
+## Prerequisites
+
+1. Verify the resource exists using find-resources skill
+2. Determine resource type (MAS model, SCR model, or table)
+
+---
+
+## Step 1: Identify Resource Type
+
+Classify the resource based on naming convention or context:
+
+```
+model X.mas                  → MAS model (default for "model X")
+model X.scr                  → SCR model
+table X in library Y         → CAS or SAS table
+```
+
+---
+
+## Step 2: Verify Resource Exists
+
+Use find-resources skill to confirm resource exists before retrieval:
+
+### Find MAS Model
+```
+find-resources skill → find-model
+Tool: sas-score-find-model({ name: "<model>" })
+```
+
+### Find SCR Model
+```
+find-resources skill → find-scr
+Tool: sas-score-find-scr({ url: "<scr-endpoint>" })
+```
+
+### Find Table
+```
+find-resources skill → find-table
+Tool: sas-score-find-table({ lib: "<library>", name: "<table>", server: "<cas|sas>" })
+```
+
+---
+
+## Step 3: Get Details
+
+### Option A: MAS Model Details
+
+**Trigger phrases**: "what inputs does model X need", "describe model X", "show variables for model X", "model X metadata", "model X information"
+
+**Tool**: `sas-score-model-info`
+
+**Parameters**:
+```
+sas-score-model-info({
+  model: "<model name>"
+})
+```
+
+**Returns**:
+- Input variables (name, type, role)
+- Output variables (name, type, possible_values)
+- Model type
+- Description
+
+**Example**:
+```
+User: "What inputs does model churnRisk need?"
+
+1. Find: sas-score-find-model({ name: "churnRisk" })
+2. Get info: sas-score-model-info({ model: "churnRisk" })
+3. Return: { inputs: [...], outputs: [...], description: "..." }
+```
+
+---
+
+### Option B: SCR Model Details
+
+**Trigger phrases**: "what does SCR model X need", "describe SCR model X", "SCR model X inputs", "SCR model X schema"
+
+**Tool**: `sas-score-scr-info`
+
+**Parameters**:
+```
+sas-score-scr-info({
+  url: "<scr endpoint>"
+})
+```
+
+**Returns**:
+- Input schema (variable names, types, required/optional)
+- Output schema (prediction, probabilities, scores)
+- Model metadata
+
+**Example**:
+```
+User: "Show inputs for SCR model at https://scr-host/models/loan"
+
+1. Get info: sas-score-scr-info({ url: "https://scr-host/models/loan" })
+2. Return: { inputs: [...], outputs: [...] }
+```
+
+**Note**: SCR models typically do not require pre-verification (can call scr-info directly)
+
+---
+
+### Option C: Table Details
+
+**Trigger phrases**: "what columns in table X", "describe table X", "show schema for table X", "table X structure", "table X metadata"
+
+**Tool**: `sas-score-table-info`
+
+**Parameters**:
+```
+sas-score-table-info({
+  lib: "<library>",
+  table: "<table name>",
+  server: "<cas|sas>"
+})
+```
+
+**Returns**:
+- Columns array (name, type, label, format, length)
+- Table info (rowCount, fileSize, created, modified)
+
+**Example**:
+```
+User: "What columns are in the customers table in Public?"
+
+1. Find: sas-score-find-table({ lib: "Public", name: "customers", server: "cas" })
+2. Get info: sas-score-table-info({ lib: "Public", table: "customers", server: "cas" })
+3. Return: { columns: [...], tableInfo: {...} }
+```
+
+---
+
+## Decision Tree
+
+```
+User requests information/details
+  ├─ About a MAS model?
+  │   → Find model (find-resources)
+  │   → Call: sas-score-model-info
+  │
+  ├─ About a SCR model?
+  │   → Call: sas-score-scr-info (can skip verification)
+  │
+  └─ About a table?
+      → Find table (find-resources, determine server)
+      → Call: sas-score-table-info
+```
+
+---
+
+## Implementation Checklist
+
+For each detail/information request:
+
+- [ ] **Classify** resource type (MAS/SCR/table)
+- [ ] **Verify** resource exists (use find-resources skill, except SCR)
+- [ ] **Determine** server for tables (CAS or SAS)
+- [ ] **Execute** appropriate detail tool
+- [ ] **Format** results (column alignment, readable structure)
+- [ ] **Append** Strategy Summary to response
+
+---
+
+## Response Format
+
+Always append a **Strategy Summary** to responses:
+
+```
+---
+
+**Strategy Summary:**
+- **Classification**: [Resource type identified]
+- **Verification**: [Resource found or skipped (SCR)]
+- **Tool Used**: [Detail tool invoked]
+- **Server**: [CAS/SAS for tables, N/A for models]
+```
+
+---
+
+## Error Recovery
+
+If a request fails:
+
+1. **Resource not found** → Ask user to verify name/spelling
+2. **Server mismatch** → Re-verify server location with find-resources
+3. **Invalid URL (SCR)** → Ask for correct SCR endpoint URL
+4. **Tool error** → Return error message verbatim and ask for clarification
+
+---
+
+## Examples
+
+### Example 1: Model Information
+
+**User**: "Describe model creditScore"
+
+**Workflow**:
+1. Classify: MAS model detail request
+2. Verify: Find model creditScore → Found ✓
+3. Execute: `sas-score-model-info({ model: "creditScore" })`
+4. Return: Model inputs, outputs, and description
+
+### Example 2: SCR Model Schema
+
+**User**: "What inputs does the SCR loan model need?"
+
+**Workflow**:
+1. Classify: SCR model detail request
+2. Execute: `sas-score-scr-info({ url: "https://scr-host/models/loan" })`
+3. Return: Input schema and output schema
+
+### Example 3: Table Columns
+
+**User**: "Show columns for customers in Public"
+
+**Workflow**:
+1. Classify: Table detail request
+2. Verify: Find table customers in Public → CAS ✓
+3. Execute: `sas-score-table-info({ lib: "Public", table: "customers", server: "cas" })`
+4. Return: Column names, types, and table metadata

package/.skills/skills/find-resources/SKILL.md

@@ -9,6 +9,8 @@ description: >
 
 Use this strategy to verify that a resource exists before executing any action.
 
+Do **not** use list tools for finding specific resources. List tools are for listing available resources  and exploration, not verification.
+
 ## Resource Types and Find Tools
 
 ### 1. Find Library

package/.skills/skills/score-strategy/SKILL.md

@@ -12,7 +12,7 @@ Use this strategy when the user requests model scoring, predictions, or running
 ## Prerequisites
 
 1. Verify the model/job exists using find-resources skill
-2. If scoring table rows: Verify the table exists and determine server
+2. If scoring table rows: Verify the table exists and determine server using find-resources skill
 3. If scoring with inline scenario: Parse the scenario data
 
 ---
@@ -50,12 +50,12 @@ score results of query...    → Query results
 
 **Tools**:
 - MAS: `sas-score-mas-score`
-- Job: `sas-score-run-jobdef`
+- Job: `sas-score-run-job`
 - JobDef: `sas-score-run-jobdef`
 - SCR: `sas-score-scr-score`
 
 **Flow**:
-1. Find model/job (find-resources)
+1. Find model (find-resources)
 2. Score with inline data
 3. Return prediction + input data merged
 
@@ -66,11 +66,18 @@ sas-score-mas-score({
   model: "<model name>",
   scenario: { a: 1, b: 2 }  
 ```
+**Parameters** (job):                                           ):
+```
+sas-score-run-job({
+  name: "<job name>",
+  scenario: { a: 1, b: 2 }
+})
+```
 
-**Parameters** (Job/JobDef):
+**Parameters** (jobdef):
 ```
 sas-score-run-jobdef({
-  name: "<job or jobdef name>",
+  name: "<jobdef name>",
   scenario: { a: 1, b: 2 }
 })
 ```
@@ -178,20 +185,20 @@ If table columns don't match model input variable names:
 
 ### Example 1: Score with inline scenario
 **Request**: "score a=1, b=2 with model simplejob.job"
-1. Find job simplejob → Found
+1. Find job simplejob using find-resources strategy
 2. Run: `sas-score-run-jobdef({ name: "simplejob", scenario: { a: 1, b: 2 } })`
 3. Return: `{ c: 3 }`
 
 ### Example 2: Score with MAS model
 **Request**: "predict churn for age=45, income=60000 with model churn_predictor"
-1. Find model churn_predictor → MAS
+1. Find model churn_predictor.mas using find-resources strategy
 2. Score: `sas-score-mas-score({ model: "churn_predictor", scenario: { age: 45, income: 60000 } })`
 3. Return: `{ age: 45, income: 60000, churn_probability: 0.23, prediction: "no_churn" }`
 
 ### Example 3: Score table rows
-**Request**: "score all active customers with model risk_model"
-1. Find model risk_model → MAS
-2. Find table customers in Public → CAS
+**Request**: "score all active customers with model risk_model and table Public.customers"
+1. Find model risk_model.mad using find-resources strategy
+2. Find table Public.customers using find-resources strategy
 3. Read: `sas-score-read-table({ lib: "Public", table: "customers", server: "cas", where: "status='active'" })`
 4. Score each row with risk_model
 5. Return: customers with risk_score appended

package/README.md

@@ -196,7 +196,15 @@ NODE_EXTRA_CA_CERTS=c:\Users\<your_username>\AppData\Local\mkcert\rootCA.pem
 ```
 
 ## License
-This project is licensed under the [Apache 2.0 license](LICENSE).
+
+
+This project is licensed under the Apache License 2.0. See LICENSE.
+
+The container image published from this repository also includes third-party software, each component under its own license:
+
+The npm dependencies that ship with this project, along with their respective licenses, are listed in LICENSES.json.
+The container is built from the 25-alpine base image; license texts for its included software ship inside the image itself.  License information for each Alpine package is available at pkgs.alpinelinux.org.
+As with any container image, direct and indirect dependencies are governed by their own licenses. Users of the published container image are responsible for ensuring that their use complies with all applicable licenses.
 
 ## Additional Resources
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sassoftware/sas-score-mcp-serverjs",
-  "version": "1.0.1-19",
+  "version": "1.0.1-21",
   "description": "A mcp server for SAS Viya",
   "author": "Deva Kumar <deva.kumar@sas.com>",
   "license": "Apache-2.0",

package/src/toolSet/findJobdef.js

@@ -18,7 +18,7 @@ function findJobdef(_appContext) {
 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 list-jobdefs), run jobdef (use run-jobdef), find job/lib/table/model (use respective tools)
+DO NOT USE for: list jobdefs (use sas-score-list-jobdefs), run jobdef (use sas-score-run-jobdef), find job/lib/table/model (use respective tools)
 
 PARAMETERS
 - name: string (required) — jobdef name to locate; if multiple supplied, use first
@@ -38,10 +38,10 @@ EXAMPLES
 - "is there a jobdef named metricsRefresh" → { name: "metricsRefresh" }
 
 NEGATIVE EXAMPLES (do not route here)
-- "list jobdefs" (use list-jobdefs)
-- "run jobdef cars_job_v4" (use run-jobdef)
-- "find job ETL" (use find-job)
-- "find table cars" (use find-table)
+- "list jobdefs" (use sas-score-list-jobdefs)
+- "run jobdef cars_job_v4" (use sas-score-run-jobdef)
+- "find job ETL" (use sas-score-find-job)
+- "find table cars" (use sas-score-find-table)
 
 ERRORS
 Returns { jobdefs: [] } if not found; { jobdefs: [name, ...] } if found. Never hallucinate jobdef names.

package/src/toolSet/modelScore.js

@@ -44,16 +44,31 @@ Returns predictions, probabilities, scores merged with input data. Returns error
     description: description,
     inputSchema: z.object({
       model: z.string(),
-      scenario: z.union([z.record(z.any()), z.string()]).optional()
+      scenario: z.any()
     }),
       
     handler: async (iparams) => {
       let params = {...iparams};
-      if (typeof params.scenario === 'string') {
-        try { params.scenario = JSON.parse(params.scenario); } catch { params.scenario = {}; }
+      let scenario = params.scenario;
+
+      // 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 = (params.scenario != null && typeof params.scenario === 'object') ? params.scenario : {};
-      
+      params.scenario = scenarioObj;
       // Drop model extension (e.g., .job, .model)
       if (params.model && params.model.includes('.')) {
         params.model = params.model.substring(0, params.model.lastIndexOf('.'));

package/src/toolSet/runCasProgram.js

@@ -45,10 +45,10 @@ Log output and CAS results. If output table specified, returned as markdown tabl
     description: description,
     inputSchema:z.object({
       src: z.string(),
-      scenario: z.string(),
-      output: z.string().optional,
-      folder: z.string().optional,
-      limit: z.number().optional
+      scenario: z.any(),
+      output: z.string().optional(),
+      folder: z.string().optional(),
+      limit: z.number().optional()
     }),
     
   // NOTE: Previously 'required' incorrectly listed 'program' which does not
@@ -70,15 +70,26 @@ Log output and CAS results. If output table specified, returned as markdown tabl
         `;
       }
       // figure out macros
-  
-      if (typeof scenario === 'string' && scenario.includes('=')) {
-        scenario = scenario.split(',').reduce((acc, pair) => {
-          const [k, ...rest] = pair.split('=');
-          if (!k) return acc;
-          acc[k.trim()] = rest.join('=').trim();
+
+      // 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;
+  
       let iparms = {
         args: scenario,
         output: params.output,

package/src/toolSet/runJob.js

@@ -41,13 +41,29 @@ Returns log output, listings, tables from job. Error if job not found.
     description: description,
     inputSchema: z.object({
       name: z.string(),
-      scenario: z.union([z.record(z.any()), z.string()]).optional()
+      scenario: z.any()
     }),
     handler: async (params) => {
-      if (typeof params.scenario === 'string') {
-        try { params.scenario = JSON.parse(params.scenario); } catch { params.scenario = {}; }
+      let scenario = params.scenario;
+
+      // 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 = (params.scenario != null && typeof params.scenario === 'object') ? params.scenario : {};
+      params.scenario = scenarioObj; 
       params.type = 'job';
       // Provide runtime context for auth and server settings
       let r = await _jobSubmit(params);

package/src/toolSet/runJobdef.js

@@ -42,13 +42,29 @@ Returns log output, listings, tables from jobdef. Error if jobdef not found.
     description: description,
     inputSchema: z.object({
       name: z.string(),
-      scenario: z.union([z.record(z.any()), z.string()]).optional()
+      scenario: z.any()
     }),
     handler: async (params) => {
-      if (typeof params.scenario === 'string') {
-        try { params.scenario = JSON.parse(params.scenario); } catch { params.scenario = {}; }
+      let scenario = params.scenario;
+
+      // 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 = (params.scenario != null && typeof params.scenario === 'object') ? params.scenario : {};
+      params.scenario = scenarioObj;      
       params.type = 'def';
       // Provide runtime context for auth and server settings
       let r = await _jobSubmit(params);