@sassoftware/sas-score-mcp-serverjs 1.0.1-30 → 1.0.1-32

package/.skills/agents/sas-score-mcp-serverjs-agent.md

@@ -156,7 +156,7 @@ Always append a **Strategy Summary** to responses:
 **Workflow**:
 1. Classify: Score request with inline scenario
 2. Verify: Find job "simplejob" → Found ✓
-3. Execute: `sas-score-run-jobdef({ name: "simplejob", scenario: { a: 1, b: 2 } })`
+3. Execute: `sas-score-run-job({ name: "simplejob", scenario: { a: 1, b: 2 } })`
 4. Format: Return `{ a: 1, b: 2, c: 3 }`
 
 ### Example 2: Read + Aggregate

package/.skills/copilot-instructions.md

@@ -3,24 +3,27 @@
 You are a SAS Viya expert agent for GitHub Copilot.
 
 
-Your role: Help users complete SAS Viya tasks safely and accurately using the simplified three-step workflow.
+Your role: Help users complete SAS Viya tasks safely and accurately using the simplified five-step workflow.
 
 **High-Level Decision Framework:**
-1. Identify the user's intent (Find, Read, Score, List)
-2. Verify resources if required
-3. Select the appropriate tool based on intent and resource type
-4. Execute and format the result
+1. Identify the user's intent (Find, Read, Score, Run, List)
+2. Identify the resources involved (libraries, tables, models, jobs, jobdefs, scr, src)
+3. Verify resources exist using find-resources tools 
+4. Select the appropriate tool based on intent and resource type
+5. Execute and format the result
 
 
 ---
 
 ## Operating Model
 
-### Every Request Follows Three Steps
+### Every Request Follows Five Steps
 
-1. **VERIFY** — Use find-resources to verify target resources exist
-2. **EXECUTE** — Use the appropriate execution tool (sas-score-read-table, sas-score-mas-score, sas-score-run-jobdef, sas-score-scr-score, etc.)
-3. **FORMAT** — Merge results and return to user
+1. **IDENTIFY** — Determine the user's intent and the resources involved
+2. **VERIFY** — Use find-resources to verify target resources exist
+3. **SELECT** — Choose the appropriate tool based on intent and resource type
+4. **EXECUTE** — Use the appropriate execution tool (sas-score-read-table, sas-score-mas-score, sas-score-run-jobdef, sas-score-run-job, sas-score-scr-score, sas-score-run-sas-program, etc.)
+5. **FORMAT** — Merge results and return to user
 
 ### Request Classification
 
@@ -30,8 +33,9 @@ When you receive a SAS request, classify it using request-routing skill:
 |---|---|---|---|
 | Find | "find", "locate", "exists" | find-resources | sas-score-find-library, sas-score-find-table, etc. |
 | Read | "read", "show", "fetch", "query", "how many", "count by" | read-strategy | sas-score-read-table, sas-score-sas-query |
-| Score | "score", "predict", "run model" | score-strategy | sas-score-mas-score, sas-score-run-jobdef, sas-score-scr-score |
-| List | "list", "show all", "browse" | — | sas-score-list-libraries, sas-score-list-tables, sas-score-list-models, etc. |
+| Score | "score", "predict", "run model", "run mas model", "run job model", "run jobdef model", "run scr model" | score-strategy | sas-score-mas-score, sas-score-run-job, sas-score-run-jobdef, sas-score-scr-score, sas-score-run-sas-program |
+| List | "list", "show all" | — | sas-score-list-libraries, sas-score-list-tables, sas-score-list-mas (MAS models), sas-score-list-jobs (job models), sas-score-list-jobdefs (jobdef models) |
+| Describe | "describe", "what inputs", "show schema", "metadata", "information" | detail-strategy | sas-score-mas-info, sas-score-job-info, sas-score-jobdef-info, sas-score-scr-info, sas-score-table-info |
 
 ---
 
@@ -39,12 +43,12 @@ When you receive a SAS request, classify it using request-routing skill:
 
 ### 1. Always Verify Before Executing
 
-Exception: SCR models can score without pre-verification.
+**Exception** - List operations do not require pre-verification. They can be executed directly to explore available resources.
 
 ```
 Verify resources exist (find-resources)
   ↓
-Execute action (sas-score-read-table, sas-score-mas-score, sas-score-run-jobdef, sas-score-scr-score, etc.)
+Execute action (sas-score-read-table, sas-score-mas-score, sas-score-run-jobdef, sas-score-run-job, sas-score-scr-score, sas-score-run-sas-program, etc.)
   ↓
 Merge and format results
 ```
@@ -55,16 +59,37 @@ Every table operation must explicitly determine whether the table is in CAS or S
 - CAS tables: Caslib.table (Casuser, Public, Samples, Formats, etc.)
 - SAS tables: LIBREF.table (SASHELP, WORK, SASUSER, etc.)
 
-Use find-resources to determine server if not specified by user.
+Use find-resources skill to determine server if not specified by user.
+
+**DO NOT** use list-resources to find a resource. This is prone to errors and inefficient. Always use find-resources for verification.
 
 ### 3. Explicit Model Type
 
-If model type is ambiguous, use MAS as a predefined fallback policy (this is an explicit exception to the 'never invent' rule):
-- `score with model X` → MAS (default)
-- `score with model X.mas` → MAS
-- `score with model X.job` → Job
-- `score with model X.jobdef` → JobDef
-- `score with model X.scr` → SCR (no pre-verification)
+Model type can be expressed as a **dot-suffix** (`X.mas`) or as an **adjective form** (`mas model X`). Both are equivalent and should be handled the same way:
+
+```
+# Dot-suffix form
+score with model X           → MAS (default)
+score with model X.mas       → MAS
+score with model X.job       → Job
+score with model X.jobdef    → JobDef
+score with model X.scr       → SCR (no pre-verification)
+run model X                  → MAS (default)
+run model X.mas              → MAS
+run model X.job              → Job
+run model X.jobdef           → JobDef
+run model X.scr              → SCR (no pre-verification)
+
+# Adjective form (equivalent)
+score with mas model X       → MAS
+score with job model X       → Job
+score with jobdef model X    → JobDef
+score with scr model X       → SCR (no pre-verification)
+run mas model X              → MAS
+run job model X              → Job
+run jobdef model X           → JobDef
+run scr model X              → SCR (no pre-verification)
+```
 
 ### 4. No Invention
 
@@ -76,11 +101,10 @@ Never invent resource names, identifiers, servers, or model types. Always verify
 
 These terms are overloaded in SAS and must be clarified:
 
-- **model**: MAS, Job, JobDef, or SCR?
-- **score/scoring**: Running a model on data (not code coverage)
-- **job**: SAS Job or SAS JobDef?
+- **model**: Can refer to a MAS model, Job model, JobDef model, or SCR model. Disambiguate using the **adjective form** (`mas model`, `job model`, `jobdef model`, `scr model`) or a **dot-suffix** (`.mas`, `.job`, `.jobdef`, `.scr`). Default to MAS when no type is given.
+- **score/scoring/run**: Running a scoring model on data, or running a SAS program?
 - **table**: CAS table or SAS dataset? Which library?
-- **resource**: Library, table, model, job, or jobdef?
+- **resource**: Library, table, model (which type?), job, jobdef, scr?
 - **read/query**: Raw row read or aggregation?
 
 When ambiguous, ask one focused clarifying question.
@@ -95,12 +119,15 @@ See the strategies folder:
 - **find-resources** — How to verify resources exist
 - **read-strategy** — How to read/query tables
 - **score-strategy** — How to score/predict
+- **list-resource** — How to list resources
+- **detail-strategy** — How to retrieve details about a resource
 - **sas-score-mcp-serverjs-agent** — Main orchestration agent
 
 ---
 
 ## Response Format
 
+Whenever possible format the response as a markdown table or structured JSON for easy readability.
 After completing a SAS Viya request, append a brief **Strategy Summary**:
 
 ```
@@ -157,7 +184,7 @@ Example:
 4. Result: Aggregated data by make
 
 ### Example 3: Read Rows
-**User**: "read first 20 customers from Public"
+**User**: "read first 20 customers from Public.customers"
 
 **Process**:
 1. Classify: Read request, raw row read
@@ -166,7 +193,7 @@ Example:
 4. Result: 20 customer rows
 
 ### Example 4: Score Table Rows
-**User**: "score all active customers with model risk_model"
+**User**: "score all active customers in Public.customers with model risk_model"
 
 **Process**:
 1. Classify: Score request, table rows
@@ -197,6 +224,10 @@ Example:
 | | sas-score-list-models | Browse MAS models |
 | | sas-score-list-jobs | Browse jobs |
 | | sas-score-list-jobdefs | Browse jobdefs |
+| **Detail** | sas-score-model-info | Get MAS model details |
+| | sas-score-job-info | Get Job model details |
+| | sas-score-scr-info | Get SCR model details |
+| | sas-score-table-info | Get table details |
 
 ---
 

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

@@ -1,78 +1,89 @@
 ---
 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, except for SCR models (which do not require pre-verification).
+  Unified detail/information/describe retrieval strategy. Handles MAS models, Job models, JobDef models, SCR models, and tables. Verify resources exist using find-resources skill before retrieving details (except SCR models, which can be queried directly).
 ---
 
 # Detail Strategy
 
+Use this strategy when the user requests information about a resource.
 
-Use this strategy when the user requests information about a resource: model details, schema, metadata, inputs/outputs, or any descriptive information.
+**Supported resource types**: MAS model, Job model, JobDef model, SCR model,  or table.
 
-If the resource type is ambiguous or cannot be determined, ask the user for clarification.
-If the resource type is not MAS, SCR, or table, respond with: "Unsupported resource type. Please specify MAS model, SCR model, or table."
+If the specified resource is ambiguous, ask the user for clarification (e.g. "Are you asking about a MAS model, a Job model, a JobDef model, a SCR model or a table?").
 
+**Model**: If user just says "model X" without specifying type, default to MAS model (this is an explicit exception to the 'never invent' rule, but it is a predefined convention in SAS).
 
-## Simplified Steps
+Verification vs Retrieval (simplified)
 
-1. Determine resource type (MAS model, SCR model, or table)
-2. If MAS model or table, verify resource exists using find-resources skill
-  - If SCR model, skip verification and proceed to retrieval
-3. Retrieve details using the appropriate tool
+- We separate the workflow into two clear, sequential phases to reduce branching and cognitive load:
+  1. Verification phase — confirm the resource exists and determine its exact type and server. Use the appropriate "find" tool for all resource types except SCR models.
+  2. Retrieval phase — after successful verification, call the detail/read tool appropriate for the identified resource type to fetch metadata or content.
 
----
+- Exception for SCR models: document the exception inline — SCR models may be queried directly with `sas-score-scr-info` when the user provides a specific SCR endpoint. Even when skipping verification, still validate the endpoint/URL format before calling the tool.
 
+Apply this separation consistently across MAS models, Job models, JobDef models, SCR models, and tables.
 
-## Step 1: Identify Resource Type
+---
 
-Classify the resource based on naming convention or context:
+## Classification & Verification Process
 
-| Pattern                        | Resource Type |
-|--------------------------------|--------------|
-| model X.mas or "model X"       | MAS model    |
-| model X.scr                    | SCR model    |
-| table X in library Y           | Table        |
+### Phase 1: Classify the Resource Type
 
-If resource type cannot be determined, ask the user for clarification.
+Determine resource type from context/naming conventions:
 
----
+| Pattern                  | Resource Type |
+|--------------------------|---------------|
+| `mas X` or `X.mas`       | MAS model  X   |
+| `mas model X`            | MAS model  X   |
+| `scr X` or `X.scr`       | SCR model X    |
+| `scr model X`            | SCR model  X   |
+| `job model X`            | Job model  X   |
+| `jobdef X` or `X.jobdef` | JobDef model  X |
+| `jobdef model X`         | JobDef model  X |
+| `table X in library Y`   | Table  X in library Y |
+| `model X.mas`            | MAS model  X   |
+| `model X.job`            | Job model  X   |
+| `model X.jobdef`         | JobDef model  X |
+| `model X.scr`            | SCR model  X   |
+| `model X` (ambiguous)    | Default to MAS model (explicit convention) |
 
-## Step 2: Verify Resource Exists (if required)
+If resource is ambiguous, ask user for clarification.
 
-| Resource Type | Verification Required? | How to Verify |
-|---------------|-----------------------|---------------|
-| MAS model     | Yes                   | find-model    |
-| SCR model     | No                    | —             |
-| Table         | Yes                   | find-table    |
+### Phase 2: Verify Resource Exists (Skip for SCR Models)
 
-If resource type is not supported, respond with: "Unsupported resource type. Please specify MAS model, SCR model, or table."
+**IMPORTANT**: Strip the suffix if user included it, use base name for lookup (e.g. "churnRisk.mas" → "churnRisk") to avoid lookup failures.
 
-### Find SCR Model
-```
-find-resources skill → find-scr
-Tool: sas-score-find-scr({ url: "<scr-endpoint>" })
-```
+For each resource type, use the appropriate verification tool:
 
-### Find Table
-```
-find-resources skill → find-table
-Tool: sas-score-find-table({ lib: "<library>", name: "<table>", server: "<cas|sas>" })
-```
+| Resource Type | Tool              |
+|---------------|-------------------|
+| MAS model     | sas-score-find-mas |
+| Job model     | sas-score-find-job   |
+| JobDef model  | sas-score-find-jobdef |
+| Table         | sas-score-find-table  |
+| SCR model     | *(no verification needed)* |
+
+If verification fails, inform the user and ask for additional details or corrections.
 
 ---
 
-## Step 3: Get Details
+## Detail Retrieval Process
+
+### Phase 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"
+**Trigger phrases**: "what inputs does mas model X need", "describe mas X", "show variables for model mas X, describe X.mas",
+"mas model X metadata", "mas model X information", "describe model X" (default to MAS),
+"what inputs does mas X need", "describe mas X"
 
-**Tool**: `sas-score-model-info`
+**Tool**: `sas-score-mas-info`
 
 **Parameters**:
 ```
-sas-score-model-info({
+
+sas-score-mas-info({
   model: "<model name>"
 })
 ```
@@ -85,10 +96,10 @@ sas-score-model-info({
 
 **Example**:
 ```
-User: "What inputs does model churnRisk need?"
+User: "What inputs does mas model churnRisk need?"
 
 1. Find: sas-score-find-model({ name: "churnRisk" })
-2. Get info: sas-score-model-info({ model: "churnRisk" })
+2. Get info: sas-score-mas-info({ model: "churnRisk" })
 3. Return: { inputs: [...], outputs: [...], description: "..." }
 ```
 
@@ -96,7 +107,8 @@ User: "What inputs does model churnRisk need?"
 
 ### 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"
+**Trigger phrases**: "what does SCR model X need", "describe SCR model X", "scr model X inputs",
+"scr model X schema", "what inputs does scr model X need", "describe scr X"
 
 **Tool**: `sas-score-scr-info`
 
@@ -153,20 +165,54 @@ User: "What columns are in the customers table in Public?"
 ```
 
 ---
+### Option D: Job Model Details
+
+**Trigger phrases**: "what inputs does job model X need", "describe job model X",
+"show variables for job model X", "job model X metadata", "job model X information",
+"what inputs does job X need", "describe job X"
+
+**Tool**: `sas-score-job-info`
+
+**Parameters**:
+```
+sas-score-job-info({
+  model: "<model name>"
+})
+```
+
+**Returns**:
+- Input variables (name, type, role)
+
+**Example**:
+```
+User: "What inputs does job model churnRisk need?"
+
+1. Find: sas-score-find-job({ name: "churnRisk" })
+2. Get info: sas-score-job-info({ model: "churnRisk" })
+3. Return: { inputs: [...] }
+```
 
 ## Decision Tree
 
 ```
 User requests information/details
   ├─ About a MAS model?
-  │   → Find model (find-resources)
-  │   → Call: sas-score-model-info
+  │   → Verify: sas-score-find-mas
+  │   → Call: sas-score-mas-info
   │
   ├─ About a SCR model?
-  │   → Call: sas-score-scr-info (can skip verification)
+  │   → Call: sas-score-scr-info (skip verification; validate URL first)
+  │
+  ├─ About a Job model?
+  │   → Verify: sas-score-find-job
+  │   → Call: sas-score-job-info
+  │
+  ├─ About a JobDef model?
+  │   → Verify: sas-score-find-jobdef
+  │   → Call: sas-score-job-info
   │
   └─ About a table?
-      → Find table (find-resources, determine server)
+      → Verify: sas-score-find-table (determine CAS or SAS server)
       → Call: sas-score-table-info
 ```
 
@@ -176,7 +222,7 @@ User requests information/details
 
 For each detail/information request:
 
-- [ ] **Classify** resource type (MAS/SCR/table)
+- [ ] **Classify** resource type (MAS / Job / JobDef / SCR / table)
 - [ ] **Verify** resource exists (use find-resources skill, except SCR)
 - [ ] **Determine** server for tables (CAS or SAS)
 - [ ] **Execute** appropriate detail tool

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

@@ -64,43 +64,50 @@ Do **not** use list tools for verifying or finding specific resources. List tool
 
 ---
 
-### 3. Find MAS Model
+### 3. Find Scoring Model
 
-**Trigger**: "find model X", "does model X exist", "locate model X"
+**Trigger**: "find model X", "find mas model X", "find job model X", "find jobdef model X",
+"find scr model X", "does model X exist", "locate model X", "find job X", "does job X exist",
+"find jobdef X", "does jobdef X exist"
 
-**Tool**: `sas-score-find-model`
+**Routing** — use the model type to pick the right find tool:
 
-**Logic**: Strip `.mas` suffix if present, use base name
-- `sas-score-find-model({ name: "<model>" })`
+| User phrase / suffix                           | Model type | Find Tool              |
+|------------------------------------------------|------------|------------------------|
+| `find mas model X` / `X.mas` / `mas X`         | MAS        | `sas-score-find-model` |
+| `find job model X` / `X.job` / `job X`         | Job        | `sas-score-find-job`   |
+| `find jobdef model X` / `X.jobdef` / `jobdef X`| JobDef     | `sas-score-find-jobdef`|
+| `find scr model X` / `X.scr` / `scr X`         | SCR        | *(no tool — ask for URL)*|
+| `find model X` (no type)                       | MAS (default) | `sas-score-find-model` |
 
----
+#### MAS Model
 
-### 4. Find Job
+**Tool**: `sas-score-find-model`
 
-**Trigger**: "find job X", "does job X exist", "locate job X"
+**Logic**: Strip `.mas` suffix if present, use base name.
+```
+sas-score-find-model({ name: "<model>" })
+```
 
-**Tool**: `sas-score-find-job`
+#### Job Model
 
-**Logic**:
-- `sas-score-find-job({ name: "<job>" })`
-
----
+**Tool**: `sas-score-find-job`
 
-### 5. Find JobDef
+**Logic**: Strip `.job` suffix if present, use base name.
+```
+sas-score-find-job({ name: "<job>" })
+```
 
-**Trigger**: "find jobdef X", "does jobdef X exist", "locate jobdef X"
+#### JobDef Model
 
 **Tool**: `sas-score-find-jobdef`
 
-**Logic**:
-- `sas-score-find-jobdef({ name: "<jobdef>" })`
-
----
-
-### 6. Find SCR Model
-
-**Trigger**: "find scr model X", "does scr model X exist"
+**Logic**: Strip `.jobdef` suffix if present, use base name.
+```
+sas-score-find-jobdef({ name: "<jobdef>" })
+```
 
+#### SCR Model
 
 **Action**: Ask user for the SCR URL/endpoint. SCR models do not have a pre-verification tool.
 If the SCR URL/endpoint is invalid or missing, prompt the user to provide a valid URL.
@@ -112,15 +119,15 @@ If the SCR URL/endpoint is invalid or missing, prompt the user to provide a vali
 
 ## Generic Model Type Inference
 
-If user says "find model X" without a type suffix, infer the type:
+If user says "find model X" without a type qualifier, infer the type from the suffix or adjective form:
 
-| Suffix | Type | Find Tool |
-|---|---|---|
-| `.mas` | MAS model | `sas-score-find-model` |
-| `.job` | SAS Job | `sas-score-find-job` |
-| `.jobdef` | SAS JobDef | `sas-score-find-jobdef` |
-| `.scr` | SCR model | Skip (no find) |
-| (none) | Default to MAS | `sas-score-find-model` |
+| Pattern                              | Type    | Find Tool               |
+|--------------------------------------|---------|-------------------------|
+| `X.mas` / `mas model X` / `mas X`    | MAS     | `sas-score-find-model`  |
+| `X.job` / `job model X` / `job X`    | Job     | `sas-score-find-job`    |
+| `X.jobdef` / `jobdef model X` / `jobdef X` | JobDef | `sas-score-find-jobdef` |
+| `X.scr` / `scr model X` / `scr X`    | SCR     | Skip (no find tool)     |
+| (none)                               | Default to MAS | `sas-score-find-model` |
 
 ---