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

package/openApi.yaml

@@ -1,121 +1,121 @@
-swagger: "2.0"
-info:
-  title: SAS Viya Sample MCP Server API
-  version: "1.0.0"
-  description: API for interacting with the SAS Viya Sample MCP Server.
-host: localhost:8080
-basePath: /
-schemes:
-  - http
-  - https
-consumes:
-  - application/json
-produces:
-  - application/json
-paths:
-  /health:
-    get:
-      summary: Health check
-      description: Returns health and version information.
-      responses:
-        200:
-          description: Health information
-          schema:
-            type: object
-            properties:
-              name:
-                type: string
-              version:
-                type: string
-              description:
-                type: string
-              endpoints:
-                type: object
-              usage:
-                type: string
-  /apiMeta:
-    get:
-      summary: API metadata
-      description: Returns the OpenAPI specification for this server.
-      responses:
-        200:
-          description: OpenAPI document
-          schema:
-            type: object
-  /mcp:
-    options:
-      summary: CORS preflight
-      description: CORS preflight endpoint.
-      responses:
-        204:
-          description: No Content
-    post:
-      summary: MCP request
-      description: Handles MCP JSON-RPC requests.
-      parameters:
-        - name: body
-          in: body
-          required: true
-          schema:
-            type: object
-        - name: Authorization
-          in: header
-          required: false
-          type: string
-          description: Bearer token for authentication
-        - name: X-VIYA-SERVER
-          in: header
-          required: false
-          type: string
-          description: Override VIYA server
-        - name: X-REFRESH-TOKEN
-          in: header
-          required: false
-          type: string
-          description: Refresh token for authentication
-        - name: mcp-session-id
-          in: header
-          required: false
-          type: string
-          description: Session ID
-      responses:
-        200:
-          description: MCP response
-          schema:
-            type: object
-        500:
-          description: Server error
-          schema:
-            type: object
-    get:
-      summary: Get MCP session
-      description: Retrieves information for an MCP session.
-      parameters:
-        - name: mcp-session-id
-          in: header
-          required: true
-          type: string
-          description: Session ID
-      responses:
-        200:
-          description: Session information
-          schema:
-            type: object
-        400:
-          description: Invalid or missing session ID
-    delete:
-      summary: Delete MCP session
-      description: Deletes an MCP session.
-      parameters:
-        - name: mcp-session-id
-          in: header
-          required: true
-          type: string
-          description: Session ID
-      responses:
-        200:
-          description: Session deleted
-          schema:
-            type: object
-        400:
-          description: Invalid or missing session ID
+swagger: "2.0"
+info:
+  title: SAS Viya Sample MCP Server API
+  version: "1.0.0"
+  description: API for interacting with the SAS Viya Sample MCP Server.
+host: localhost:8080
+basePath: /
+schemes:
+  - http
+  - https
+consumes:
+  - application/json
+produces:
+  - application/json
+paths:
+  /health:
+    get:
+      summary: Health check
+      description: Returns health and version information.
+      responses:
+        200:
+          description: Health information
+          schema:
+            type: object
+            properties:
+              name:
+                type: string
+              version:
+                type: string
+              description:
+                type: string
+              endpoints:
+                type: object
+              usage:
+                type: string
+  /apiMeta:
+    get:
+      summary: API metadata
+      description: Returns the OpenAPI specification for this server.
+      responses:
+        200:
+          description: OpenAPI document
+          schema:
+            type: object
+  /mcp:
+    options:
+      summary: CORS preflight
+      description: CORS preflight endpoint.
+      responses:
+        204:
+          description: No Content
+    post:
+      summary: MCP request
+      description: Handles MCP JSON-RPC requests.
+      parameters:
+        - name: body
+          in: body
+          required: true
+          schema:
+            type: object
+        - name: Authorization
+          in: header
+          required: false
+          type: string
+          description: Bearer token for authentication
+        - name: X-VIYA-SERVER
+          in: header
+          required: false
+          type: string
+          description: Override VIYA server
+        - name: X-REFRESH-TOKEN
+          in: header
+          required: false
+          type: string
+          description: Refresh token for authentication
+        - name: mcp-session-id
+          in: header
+          required: false
+          type: string
+          description: Session ID
+      responses:
+        200:
+          description: MCP response
+          schema:
+            type: object
+        500:
+          description: Server error
+          schema:
+            type: object
+    get:
+      summary: Get MCP session
+      description: Retrieves information for an MCP session.
+      parameters:
+        - name: mcp-session-id
+          in: header
+          required: true
+          type: string
+          description: Session ID
+      responses:
+        200:
+          description: Session information
+          schema:
+            type: object
+        400:
+          description: Invalid or missing session ID
+    delete:
+      summary: Delete MCP session
+      description: Deletes an MCP session.
+      parameters:
+        - name: mcp-session-id
+          in: header
+          required: true
+          type: string
+          description: Session ID
+      responses:
+        200:
+          description: Session deleted
+          schema:
+            type: object
+        400:
+          description: Invalid or missing session ID

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sassoftware/sas-score-mcp-serverjs",
-  "version": "1.0.1-8",
+  "version": "1.1.1",
   "description": "A mcp server for SAS Viya",
   "author": "Deva Kumar <deva.kumar@sas.com>",
   "license": "Apache-2.0",
@@ -15,22 +15,27 @@
     "test": "cd test && node",
     "debug": "cross-env NODE_TLS_REJECT_UNAUTHORIZED=0  node --inspect-brk cli.js",
     "getViyatls": "bash ./scripts/getViyaca.sh",
-    "deploy": "bash ./deploy.sh",
-    "push2acr": "cd docker && bash ./push2acr.sh",
+    "push2acr": "bash ./push2acr.sh",
+    "push2ghcr": "bash ./push2ghcr.sh",
     "bump": "npm version prerelease",
-    "pub": "npm publish --tag dev --access public",
-    "setup-skills": "node scripts/setup-skills.js"
+    "pub": "npm publish --tag dev --access public"
   },
   "repository": "https://github.com/sassoftware/sas-score-mcp-serverjs",
+  "bugs": {
+    "url": "https://github.com/sassoftware/sas-score-mcp-serverjs/issues"
+  },
   "keywords": [
     "SAS Viya",
     "mcp-serverjs",
-    "Agentic AI",
+    "SAS Viya scoring",
     "Viya actions",
     "restaf",
     "restafedit",
     "restaflib",
-    "model context protocol"
+    "model context protocol",
+    "skills",
+    "agent",
+    "Agentic AI"
   ],
   "main": "./cli.js",
   "bin": {
@@ -42,8 +47,6 @@
     "openApi.json",
     "openApi.yaml",
     "scripts",
-    ".skills_github",
-    ".skills_claude",
     ".skills"
   ],
   "dependencies": {
@@ -51,8 +54,7 @@
     "@sassoftware/restaf": "^5.7.2",
     "@sassoftware/restafedit": "^3.10.5",
     "@sassoftware/restaflib": "^5.7.2",
-    "@sassoftware/viya-serverjs": "^0.6.3-0",
-    "axios": "^1.13.2",
+    "axios": "^1.13.5",
     "body-parser": "^2.2.1",
     "cors": "^2.8.5",
     "cross-env": "^10.1.0",
@@ -64,8 +66,8 @@
     "node-cache": "^5.1.2",
     "open": "^11.0.0",
     "selfsigned": "^5.2.0",
-    "undici": "^7.16.0",
-    "uuid": "^13.0.0",
+    "undici": "^7.24.0",
+    "uuid": "^14.0.0",
     "zod": "^4.2.1"
   },
   "devDependencies": {

package/scripts/docs/SCORE_SKILL_REFERENCE.md

@@ -1,4 +1,4 @@
-# Score Skill Documentation
+# Score Skill Documentation
 
 ## Overview
 The `score` skill is a generic scoring interface that automatically routes scoring requests to the appropriate tool based on the model type specified in the request.
@@ -10,11 +10,11 @@ score <name>.<type> [scenario =<key=value pairs>]
 ```
 
 ## Supported Types
-- **job** — Route to `run-job` for job-based scoring
-- **jobdef** — Route to `run-jobdef` for job definition-based scoring
-- **mas** — Route to `model-score` (Model Aggregation Service)
-- **scr** — Route to `scr-score` (Score Code Runtime container)
-- **sas** — Route to `run-sas-program` (arbitrary SAS/SQL scoring)
+- **job** — Route to `job-score` for job-based scoring
+- **jobdef** — Route to `jobdef-score` for job definition-based scoring
+- **mas** — Route to `mas-score` (Model Aggregation Service)
+- **scr** — Route to `scr-score` (Score Code Runtime container)
+- **sas** — Route to `program-score` (arbitrary SAS/SQL scoring)
 
 ## Usage Examples
 
@@ -23,21 +23,21 @@ score <name>.<type> [scenario =<key=value pairs>]
 score with model churn.mas where scenario =age=45,income=60000
 score mymodel.mas using age=45, income=60000
 ```
-Routes to: `model-score` with model name and scenario parameters
+Routes to: `mas-score` with model name and scenario parameters
 
 ### Job-Based Scoring
 ```
 score with model monthly_scorer.job scenario =month=10,year=2025
 score mymodel.job with month=10, year=2025
 ```
-Routes to: `run-job` with job name and parameters
+Routes to: `job-score` with job name and parameters
 
 ### Job Definition Scoring
 ```
 score fraud_detector.jobdef using amount=500,merchant=online
 score predictions.jobdef where scenario =x=1,y=2
 ```
-Routes to: `run-jobdef` with jobdef name and parameters
+Routes to: `jobdef-score` with jobdef name and parameters
 
 ### SCR (Score Code Runtime) Scoring
 ```
@@ -51,7 +51,7 @@ Routes to: `scr-score` with SCR URL and scenario
 score predictions.sas where scenario =x=1,y=2
 score my_scoring_code.sas using month=10,year=2025
 ```
-Routes to: `run-sas-program` with scenario parameters
+Routes to: `program-score` with scenario parameters
 
 ## Parameter Details
 
@@ -89,11 +89,11 @@ age=45,income=60000,credit=700
 The skill automatically infers the type from the model name:
 
 ```
-mymodel.mas    → type = "mas"
-scorer.job     → type = "job"
-detector.jobdef → type = "jobdef"
-risk.scr       → type = "scr"
-predict.sas    → type = "sas"
+mymodel.mas    → type = "mas"
+scorer.job     → type = "job"
+detector.jobdef → type = "jobdef"
+risk.scr       → type = "scr"
+predict.sas    → type = "sas"
 ```
 
 If the type is not specified in the model name or as a parameter, the skill will ask for clarification:
@@ -134,9 +134,10 @@ All responses include metadata indicating which tool was invoked.
 
 The skill is defined in `src/toolSet/scoreSkill.js` and:
 - Parses model name to extract type
-- Normalizes type names (e.g., `jobs` → `job`)
+- Normalizes type names (e.g., `jobs` → `job`)
 - Routes to appropriate tool handler
 - Attaches scoring metadata to response
 - Handles errors from backend tools
 
 The skill is automatically registered in `makeTools.js` and available alongside other MCP tools.
+

package/scripts/docs/TOOL_DESCRIPTION_TEMPLATE.md

@@ -147,11 +147,11 @@ Before marking a tool as conforming to the template:
 
 ## Tools Updated to Template
 
-- [x] listModels.js - ✅ Already conforms
-- [x] findModel.js - 🔧 Needs cleanup (remove redundancy)
+- [x] listMas.js - ✅ Already conforms
+- [x] findMas.js - 🔧 Needs cleanup (remove redundancy)
 - [ ] deval.js - 🔧 Needs major expansion
 - [ ] devaScore.js - 🔧 Needs expansion
 - [ ] setContext.js - 🔧 Needs expansion
-- [ ] modelInfo.js - 🔧 Needs expansion
+- [ ] masDescribe.js - 🔧 Needs expansion
 - [ ] readTable.js - ✅ Mostly conforms (minor tweaks)
 - [ ] ... (other tools)

package/scripts/docs/TOOL_UPDATES_SUMMARY.md

@@ -1,4 +1,4 @@
-# Tool Description Standardization - Update Summary
+# Tool Description Standardization - Update Summary
 
 ## Overview
 All tool descriptions have been standardized to follow a consistent template format. This ensures:
@@ -14,72 +14,72 @@ See `TOOL_DESCRIPTION_TEMPLATE.md` for the complete template specification and v
 
 ## Tools Updated
 
-### ✅ Tools Fully Conforming to Template
+### ✅ Tools Fully Conforming to Template
 
 #### Major Updates (5 tools)
 
-1. **findModel.js** - Cleaned up and standardized
-   - ✂️ Removed redundant JSON metadata object
-   - ✂️ Removed confusing/error lines (41-47) that listed find lib/table/job incorrectly
-   - ✅ Now has all required template sections
-   - ✅ Clear LLM invocation guidance
+1. **findMas.js** - Cleaned up and standardized
+   - ✂️ Removed redundant JSON metadata object
+   - ✂️ Removed confusing/error lines (41-47) that listed find lib/table/job incorrectly
+   - ✅ Now has all required template sections
+   - ✅ Clear LLM invocation guidance
 
 2. **deval.js** - Expanded from 2 lines to comprehensive format
-   - ➕ Added "LLM Invocation Guidance" section with 4 use cases
-   - ➕ Added "Do NOT use this tool for" section (4 items)
-   - ➕ Added clear "Purpose" statement
-   - ➕ Added "Parameters" documentation
-   - ➕ Added "Response Contract" describing return format
-   - ➕ Added "Disambiguation & Clarification" section
-   - ➕ Added 3 real-world "Examples" with parameter mappings
-   - ➕ Added "Negative Examples" section
-   - ➕ Added "Related Tools" section
+   - âž• Added "LLM Invocation Guidance" section with 4 use cases
+   - âž• Added "Do NOT use this tool for" section (4 items)
+   - âž• Added clear "Purpose" statement
+   - âž• Added "Parameters" documentation
+   - âž• Added "Response Contract" describing return format
+   - âž• Added "Disambiguation & Clarification" section
+   - âž• Added 3 real-world "Examples" with parameter mappings
+   - âž• Added "Negative Examples" section
+   - âž• Added "Related Tools" section
 
 3. **setContext.js** - Expanded with comprehensive guidance
-   - ➕ Added "LLM Invocation Guidance" section with 4 use cases
-   - ➕ Added "Do NOT use" section
-   - ➕ Added detailed "Purpose" explaining session context switching
-   - ➕ Enhanced "Parameters" with real server examples
-   - ➕ Added "Response Contract" with detailed structure
-   - ➕ Added "Disambiguation & Clarification" for edge cases
-   - ➕ Added 4 real-world "Examples" with parameter mappings
-   - ➕ Added "Negative Examples" section
-   - ➕ Added "Related Tools" section
+   - âž• Added "LLM Invocation Guidance" section with 4 use cases
+   - âž• Added "Do NOT use" section
+   - âž• Added detailed "Purpose" explaining session context switching
+   - âž• Enhanced "Parameters" with real server examples
+   - âž• Added "Response Contract" with detailed structure
+   - âž• Added "Disambiguation & Clarification" for edge cases
+   - âž• Added 4 real-world "Examples" with parameter mappings
+   - âž• Added "Negative Examples" section
+   - âž• Added "Related Tools" section
 
 4. **devaScore.js** - Reformatted with template structure
-   - 🔄 Restructured from instruction-heavy to template format
-   - ➕ Added "LLM Invocation Guidance" section
-   - ➕ Added "Do NOT use" section
-   - ➕ Added clear parameter documentation
-   - ➕ Added "Response Contract" section
-   - ➕ Added "Examples" and "Negative Examples" sections
-   - ➕ Added "Notes" section explaining left-to-right fold
-
-5. **modelInfo.js** - Expanded with comprehensive structure
-   - ➕ Added "LLM Invocation Guidance" with 4 use cases
-   - ➕ Added "Do NOT use" section
-   - ➕ Enhanced "Purpose" statement
-   - ➕ Added detailed "Response Contract" describing metadata fields
-   - ➕ Added "Disambiguation & Clarification" section
-   - ➕ Added 4 real-world "Examples" with parameter mappings
-   - ➕ Added "Negative Examples" section
-   - ➕ Added "Related Tools" showing workflow chain
+   - 🔄 Restructured from instruction-heavy to template format
+   - âž• Added "LLM Invocation Guidance" section
+   - âž• Added "Do NOT use" section
+   - âž• Added clear parameter documentation
+   - âž• Added "Response Contract" section
+   - âž• Added "Examples" and "Negative Examples" sections
+   - âž• Added "Notes" section explaining left-to-right fold
+
+5. **masDescribe.js** - Expanded with comprehensive structure
+   - âž• Added "LLM Invocation Guidance" with 4 use cases
+   - âž• Added "Do NOT use" section
+   - âž• Enhanced "Purpose" statement
+   - âž• Added detailed "Response Contract" describing metadata fields
+   - âž• Added "Disambiguation & Clarification" section
+   - âž• Added 4 real-world "Examples" with parameter mappings
+   - âž• Added "Negative Examples" section
+   - âž• Added "Related Tools" showing workflow chain
 
 #### Moderate Updates (1 tool)
 
 6. **readTable.js** - Enhanced to fully conform to template
-   - 🔄 Restructured sections for template consistency
-   - ➕ Enhanced "LLM Invocation Guidance" with 5 specific use cases
-   - ➕ Improved "Do NOT use" section with explanation
-   - ➕ Clarified "Parameters" format and added constraints
-   - 🔄 Renamed "Output" to "Response Contract" per template
-   - ➕ Added "Pagination & Filtering" section with examples
-   - ➕ Enhanced "Examples" with 5 detailed parameter mappings
-   - ➕ Added comprehensive "Related Tools" section
+   - 🔄 Restructured sections for template consistency
+   - âž• Enhanced "LLM Invocation Guidance" with 5 specific use cases
+   - âž• Improved "Do NOT use" section with explanation
+   - âž• Clarified "Parameters" format and added constraints
+   - 🔄 Renamed "Output" to "Response Contract" per template
+   - âž• Added "Pagination & Filtering" section with examples
+   - âž• Enhanced "Examples" with 5 detailed parameter mappings
+   - âž• Added comprehensive "Related Tools" section
 
 #### Already Conforming (1 tool)
 
-7. **listModels.js** - ✅ Already fully compliant
+7. **listMas.js** - ✅ Already fully compliant
    - Already had comprehensive template format
    - No changes needed
 
@@ -110,11 +110,11 @@ Clear list of what NOT to do and which tools to use instead. Prevents misuse.
 - How to clarify ambiguous requests
 - Exact clarification questions to ask
 
-### 7. Examples (→ mapped params)
+### 7. Examples (→ mapped params)
 - Real-world user phrases
 - Parameter mappings shown
 - Includes various parameter combinations
-- Format: `"user input" → { param: value }`
+- Format: `"user input" → { param: value }`
 
 ### 8. Negative Examples (should NOT call toolName)
 - Common mistakes showing what NOT to do
@@ -160,12 +160,12 @@ Clear list of what NOT to do and which tools to use instead. Prevents misuse.
 
 ## Files Modified
 
-1. `src/toolSet/findModel.js` - Cleaned up redundancy
-2. `src/toolSet/deval.js` - Expanded description (2 → 47 lines)
-3. `src/toolSet/setContext.js` - Expanded description (9 → 60 lines)
-4. `src/toolSet/devaScore.js` - Reformatted (12 → 54 lines)
-5. `src/toolSet/modelInfo.js` - Expanded description (12 → 69 lines)
-6. `src/toolSet/readTable.js` - Enhanced description (56 → 80 lines)
+1. `src/toolSet/findMas.js` - Cleaned up redundancy
+2. `src/toolSet/deval.js` - Expanded description (2 → 47 lines)
+3. `src/toolSet/setContext.js` - Expanded description (9 → 60 lines)
+4. `src/toolSet/devaScore.js` - Reformatted (12 → 54 lines)
+5. `src/toolSet/masDescribe.js` - Expanded description (12 → 69 lines)
+6. `src/toolSet/readTable.js` - Enhanced description (56 → 80 lines)
 
 ## Files Created
 
@@ -183,11 +183,11 @@ Consider updating remaining tools in the toolSet directory to match this templat
 - `findTable.js`
 - `job.js`
 - `jobdef.js`
-- `tableInfo.js`
+- `tableDescribe.js`
 - `program.js`
 - `sasQuery.js`
-- `modelScore.js`
-- `scrInfo.js`
+- `masScore.js`
+- `scrDescribe.js`
 - `scrScore.js`
 - And any others...
 
@@ -201,8 +201,10 @@ To verify a tool conforms to the template, check:
 - [ ] Has "Parameters" section with type, default, and description for each param
 - [ ] Has "Response Contract" describing the return format
 - [ ] Has "Disambiguation & Clarification" section for edge cases
-- [ ] Has "Examples (→ mapped params)" section with 3+ real-world examples
+- [ ] Has "Examples (→ mapped params)" section with 3+ real-world examples
 - [ ] Has "Negative Examples (should NOT call...)" section with what NOT to do
 - [ ] Has "Related Tools" section showing workflow context
 - [ ] Uses proper markdown formatting (## headers, - bullets, `code`)
 - [ ] Consistent formatting and tone throughout
+
+

package/scripts/docs/oauth-http-transport.md

@@ -5,7 +5,7 @@
 
 TBD
 
-## VSCODE Githu Copilot
+## VSCODE Github Copilot
 
 ### Scenario:
 
@@ -35,7 +35,7 @@ It appears that the / at the end of the redirect URI is important]
 }
 ```
 
-### pkce clientid when mcp server does teh oauth flow
+### pkce clientid when mcp server does the oauth flow
 
 ```js