@sassoftware/sas-score-mcp-serverjs 0.4.1-15 → 0.4.1-18

package/skills/sas-list-tables-smart/SKILL.md

@@ -1,123 +1,127 @@
----
-name: sas-list-tables-smart
-description: >
-  List all tables in a SAS Viya library with intelligent server detection. When the server is not
-  specified, automatically checks CAS first, then SAS if not found. Informs the user if the library
-  does not exist in either server. Use this skill when the user wants to browse or explore available
-  tables. Trigger phrases include: "list tables in", "show tables in", "what tables are in",
-  "browse tables in", "tables in library", "enumerate tables", or any request to explore data sources.
----
-
-# Smart Data Access in SAS Library (List, Read, Query)
-
-Intelligently enumerates tables in a SAS Viya library, automatically determining the correct server
-when not explicitly specified.
-
-**If the user specifies the server explicitly** (e.g., "list tables in Public in cas"):
-- Use the specified server: `server: "cas"` or `server: "sas"`
-- Proceed directly to listing tables
-
-**If the server is NOT specified:**
-1. **First attempt**: Check CAS (`server: "cas"`)
-2. **If no tables found in CAS**: Check SAS (`server: "sas"`)
-3. **If no tables found in either**:
-   - Inform user: *"The library '<lib>' was not found in CAS or SAS. Please verify the library name is correct."*
-   - Ask: *"Would you like to list available libraries?"* (suggest `list-libraries`)
-
----
-
-## Using list-tables
-
-**When:**
-- User wants to browse all tables in a library
-- User wants to see what data is available
-- User wants to explore library contents before querying
-
-**How:**
-```
-list-tables({
-  lib: "libraryname",           // required
-  server: "cas" or "sas",       // required; determined by server check
-  limit: 10,                    // optional; default 10, adjust for pagination
-  start: 1                      // optional; default 1, use for pagination
-})
-```
-
-**Rules:**
-- Always determine the correct server first (cas → sas → neither)
-- **For SAS server: always uppercase the library name** (e.g., "maps" → "MAPS")
-- If library name is missing, ask: *"Which library should I list tables from?"*
-- Default page size is 10; adjust based on user request ("show me all", "25 tables", etc.)
-- If returned table count equals the limit, suggest pagination: *"There may be more tables. Use `start: {next_offset}` to see more."*
-- If no tables are found despite library existing, report: *"No tables found in {lib} on {server} server."*
-- Return table names only; do not fetch table metadata unless explicitly requested
-
----
-
-## Smart server detection logic
-
-```
-IF server specified by user
-  → IF server is "sas"
-      → uppercase lib
-  → use that server
-ELSE
-  → TRY list-tables(lib, server="cas")
-    IF tables found
-      → success, return tables
-    ELSE
-      → uppercase lib
-      → TRY list-tables(lib.toUpperCase(), server="sas")
-        IF tables found
-          → success, return tables
-        ELSE
-          → inform user library not found in either server
-```
-
----
-
-## Common patterns
-
-**Pattern 1 — List tables, server unspecified**
-> "List tables in Public"
-
-1. Try CAS: `list-tables({ lib: "Public", server: "cas" })`
-2. If empty, try SAS with uppercase: `list-tables({ lib: "PUBLIC", server: "sas" })`
-3. If still empty → inform user
-
-**Pattern 2 — List tables with explicit server (SAS)**
-> "List tables in sashelp in sas"
-
-1. Skip server detection
-2. Call with uppercase lib: `list-tables({ lib: "SASHELP", server: "sas" })`
-
-**Pattern 3 — List tables with explicit server (CAS)**
-> "List tables in Public in cas"
-
-1. No uppercase needed for CAS
-2. Call: `list-tables({ lib: "Public", server: "cas" })`
-
-**Pattern 4 — Pagination**
-> "Show me 25 tables in Samples, then the next batch"
-
-1. First call: `list-tables({ lib: "Samples", limit: 25, start: 1 })`
-2. Next call: `list-tables({ lib: "Samples", limit: 25, start: 26 })`
-
-**Pattern 5 — Library not found**
-> "List tables in foo"
-
-1. Try CAS: empty
-2. Try SAS with uppercase: empty
-3. Response: *"The library 'foo' was not found in CAS or SAS. Please verify the library name."*
-
----
-
-## Error handling
-
-| Scenario | Action |
-|---|---|
-| Library not found in either server | Inform user and ask to verify library name |
-| Empty result on first server | Automatically check second server |
-| User specifies invalid server | Return error; ask user to clarify: `"cas"` or `"sas"` |
-| Missing library name | Ask: *"Which library should I list tables from?"* |
-
+---
+name: sas-list-tables-smart
+description: >
+  List all tables in a SAS Viya library with intelligent server detection. When the server is not
+  specified, automatically checks CAS first, then SAS if not found. Informs the user if the library
+  does not exist in either server. Use this skill when the user wants to browse or explore available
+  tables. Trigger phrases include: "list tables in", "show tables in", "what tables are in",
+  "browse tables in", "tables in library", "enumerate tables", or any request to explore data sources.
+---
+
+# Smart Data Access in SAS Library (List, Read, Query)
+
+Intelligently enumerates tables in a SAS Viya library, automatically determining the correct server
+when not explicitly specified.
+
+> **Pre-flight check**: Before listing tables, verify the library exists using the `sas-find-library-smart` skill.
+> This ensures consistent server detection across all data operations.
+
+**If the user specifies the server explicitly** (e.g., "list tables in Public in cas"):
+- Use the specified server: `server: "cas"` or `server: "sas"`
+- Proceed directly to listing tables
+
+**If the server is NOT specified:**
+1. **First attempt**: Check CAS (`server: "cas"`)
+2. **If no tables found in CAS**: Check SAS (`server: "sas"`)
+3. **If no tables found in either**:
+   - Inform user: *"The library '<lib>' was not found in CAS or SAS. Please verify the library name is correct."*
+   - Ask: *"Would you like to list available libraries?"* (suggest `sas-score-list-libraries`)
+
+---
+
+## Using sas-score-list-tables
+
+**When:**
+- User wants to browse all tables in a library
+- User wants to see what data is available
+- User wants to explore library contents before querying
+
+**How:**
+```
+sas-score-list-tables({
+  lib: "libraryname",           // required
+  server: "cas" or "sas",       // required; determined by server check
+  limit: 10,                    // optional; default 10, adjust for pagination
+  start: 1                      // optional; default 1, use for pagination
+})
+```
+
+**Rules:**
+- Always determine the correct server first (cas → sas → neither)
+- **For SAS server: always uppercase the library name** (e.g., "maps" → "MAPS")
+- If library name is missing, ask: *"Which library should I list tables from?"*
+- Default page size is 10; adjust based on user request ("show me all", "25 tables", etc.)
+- If returned table count equals the limit, suggest pagination: *"There may be more tables. Use `start: {next_offset}` to see more."*
+- If no tables are found despite library existing, report: *"No tables found in {lib} on {server} server."*
+- Return table names only; do not fetch table metadata unless explicitly requested
+
+---
+
+## Smart server detection logic
+
+```
+IF server specified by user
+  → IF server is "sas"
+      → uppercase lib
+  → use that server
+ELSE
+  → TRY sas-score-list-tables(lib, server="cas")
+    IF tables found
+      → success, return tables
+    ELSE
+      → uppercase lib
+      → TRY sas-score-list-tables(lib.toUpperCase(), server="sas")
+        IF tables found
+          → success, return tables
+        ELSE
+          → inform user library not found in either server
+```
+
+---
+
+## Common patterns
+
+**Pattern 1 — List tables, server unspecified**
+> "List tables in Public"
+
+1. Try CAS: `sas-score-list-tables({ lib: "Public", server: "cas" })`
+2. If empty, try SAS with uppercase: `sas-score-list-tables({ lib: "PUBLIC", server: "sas" })`
+3. If still empty → inform user
+
+**Pattern 2 — List tables with explicit server (SAS)**
+> "List tables in sashelp in sas"
+
+1. Skip server detection
+2. Call with uppercase lib: `sas-score-list-tables({ lib: "SASHELP", server: "sas" })`
+
+**Pattern 3 — List tables with explicit server (CAS)**
+> "List tables in Public in cas"
+
+1. No uppercase needed for CAS
+2. Call: `sas-score-list-tables({ lib: "Public", server: "cas" })`
+
+**Pattern 4 — Pagination**
+> "Show me 25 tables in Samples, then the next batch"
+
+1. First call: `sas-score-list-tables({ lib: "Samples", limit: 25, start: 1 })`
+2. Next call: `sas-score-list-tables({ lib: "Samples", limit: 25, start: 26 })`
+
+**Pattern 5 — Library not found**
+> "List tables in foo"
+
+1. Try CAS: empty
+2. Try SAS with uppercase: empty
+3. Response: *"The library 'foo' was not found in CAS or SAS. Please verify the library name."*
+
+---
+
+## Error handling
+
+| Scenario | Action |
+|---|---|
+| Library not found in either server | Inform user and ask to verify library name |
+| Empty result on first server | Automatically check second server |
+| User specifies invalid server | Return error; ask user to clarify: `"cas"` or `"sas"` |
+| Missing library name | Ask: *"Which library should I list tables from?"* |
+| Library verification needed | Use `sas-find-library-smart` skill to verify library exists first |
+

package/skills/sas-read-and-score/SKILL.md

@@ -2,7 +2,7 @@
 name: sas-read-and-score
 description: >
   Guide the full read → score workflow in SAS Viya: reading records from a table and then scoring
-  them with a MAS model (using model-score). Use this skill whenever the user wants to score records
+  them with a MAS model (using sas-score-model-score). Use this skill whenever the user wants to score records
   from a table, run a model against query results, predict outcomes for a set of rows, or any
   combination of fetching data and scoring it. Trigger phrases include: "score these records",
   "score results of my query", "run the model on this table", "predict for these customers",
@@ -17,6 +17,17 @@ with a deployed MAS model.
 
 ---
 
+## Pre-flight verification
+
+**Before attempting to read or score table data:**
+1. **Verify library exists**: Use `sas-find-library-smart` to check the library in CAS first, then SAS if needed
+2. **Verify table exists**: Use `sas-score-find-table` to confirm the table is in the library
+3. **Confirm server location**: Ensure you know which server (CAS or SAS) contains the data
+
+This ensures consistent behavior with other data access operations.
+
+---
+
 ## Workflow overview
 
 The typical flow involves:
@@ -72,7 +83,7 @@ If the user specifies a model name that's new/unknown:
 ## Rules
 
 - Always validate table/library existence before attempting to read
-- Always check model exists before invoking `model-score`
+- Always check model exists before invoking `sas-score-model-score`
 - Match table columns to model input variables; warn on mismatch
 - If multiple records: score batch if possible; fall back to row-by-row
 - Merge predictions with original data using row index or key column
@@ -90,3 +101,11 @@ If the user specifies a model name that's new/unknown:
 | Scoring error | Return structured error, suggest checking model inputs |
 | Empty read result | Inform user, ask if they want to adjust the query/filter |
 | Data type mismatch | Warn user about type conversion, proceed or ask for clarification |
+
+---
+
+## Integration with other skills
+
+- **Before this workflow**: Use `sas-find-library-smart` to verify the library exists
+- **For data retrieval**: Use `sas-read-strategy` to choose the right read tool (read-table vs sas-query)
+- **For scoring**: Use `sas-score-workflow` for advanced scoring options beyond MAS models

package/skills/sas-read-strategy/SKILL.md

@@ -1,8 +1,8 @@
 ---
 name: sas-read-strategy
 description: >
-  Guide the user in choosing the right data retrieval tool: read-table (for raw row access with filters)
-  or sas-query (for analytical queries, aggregations, joins). Use this skill when the user wants to
+  Guide the user in choosing the right data retrieval tool: sas-score-read-table (for raw row access with filters)
+  or sas-score-sas-query (for analytical queries, aggregations, joins). Use this skill when the user wants to
   fetch records from a SAS/CAS table. Trigger phrases include: "read records from", "get data where",
   "fetch rows from", "query the table", "give me the first N records", "aggregate by", "join tables",
   or any request that starts with data retrieval.
@@ -10,19 +10,25 @@ description: >
 
 # SAS Read Strategy
 
-Guides the decision between `read-table` and `sas-query` based on the user's intent and the nature
+Guides the decision between `sas-score-read-table` and `sas-score-sas-query` based on the user's intent and the nature
 of the data operation. Determines which server contains the data and which retrieval tool is most appropriate.
 
 ## Determine the server location
 
-Before retrieving data, check which server(s) contain the table:
+Before retrieving data, verify the library and determine which server(s) contain the table:
 
-1. **Check both servers**: Use `find-table` to check if the table exists in CAS and/or SAS
-2. **Decide server placement**:
-   - If table exists **only in CAS** → set `server: "cas"`
-   - If table exists **only in SAS** → set `server: "sas"`
-   - If table exists **in both** → ask the user: *"The table exists in both CAS and SAS. Which server would you prefer to query from?"*
-   - If table exists **in neither** → inform user and ask which library to search in
+**Step 1: Verify library existence**
+- Use `sas-find-library-smart` skill to check the library in CAS first, then SAS if needed
+- This establishes the correct server and uppercase convention for SAS libraries
+- Informs the user which server contains the library
+
+**Step 2: Locate the specific table**
+- Use `sas-score-find-table` to check if the table exists in the library
+- Possible outcomes:
+  - If table exists **only in CAS** → set `server: "cas"`
+  - If table exists **only in SAS** → set `server: "sas"`
+  - If table exists **in both** → ask the user: *"The table exists in both CAS and SAS. Which server would you prefer to query from?"*
+  - If table exists **in neither** → inform user and suggest verifying the table name
 
 ---
 
@@ -35,8 +41,8 @@ Ask yourself: does the user already have the data in hand?
 
 | User's Intent | Tool | Example |
 |---|---|---|
-| Get specific raw rows, apply simple filter, retrieve first N records | `read-table` | "Show me 10 rows from customers where status='active'" |
-| Aggregate/summarize, calculate, join tables, analytical question | `sas-query` | "Average salary by department", "Count orders by region" |
+| Get specific raw rows, apply simple filter, retrieve first N records | `sas-score-read-table` | "Show me 10 rows from customers where status='active'" |
+| Aggregate/summarize, calculate, join tables, analytical question | `sas-score-sas-query` | "Average salary by department", "Count orders by region" |
 
 ---
 
@@ -49,17 +55,17 @@ Ask yourself: does the user already have the data in hand?
 
 **How:**
 ```
-read-table({
+sas-score-read-table({
   table: "tablename",
   lib: "libraryname",
-  server: "cas" or "sas",  // determined from find-table check
+  server: "cas" or "sas",  // determined from sas-score-find-table check
   limit: N,        // default 10, adjust based on user request
   where: "..."     // optional SQL WHERE clause
 })
 ```
 
 **Rules:**
-- Always determine the server first using `find-table`
+- Always determine the server first using `sas-score-find-table`
 - Keep batch size ≤ 50 rows unless the user explicitly requests more
 - If table name is missing, ask: *"Which table should I read from? (format: lib.tablename)"*
 - If library is missing, ask: *"Which library contains the table?"*
@@ -85,7 +91,7 @@ sas-query({
 ```
 
 **Rules:**
-- Check which server(s) contain the table using `find-table` first
+- Check which server(s) contain the table using `sas-score-find-table` first
 - If table exists in both CAS and SAS, ask user which to query from
 - Parse the user's natural language question into a PROC SQL SELECT statement
 - Ensure SELECT statement is valid SQL syntax
@@ -100,22 +106,22 @@ sas-query({
 **Pattern A — Raw row retrieval**
 > "Show me the first 5 rows from Public.customers"
 
-→ `read-table({ table: "customers", lib: "Public", limit: 5 })`
+→ `sas-score-read-table({ table: "customers", lib: "Public", limit: 5 })`
 
 **Pattern B — Filtered retrieval**
 > "Get all high-value orders (amount > 5000) from mylib.orders"
 
-→ `read-table({ table: "orders", lib: "mylib", where: "amount > 5000" })`
+→ `sas-score-read-table({ table: "orders", lib: "mylib", where: "amount > 5000" })`
 
 **Pattern C — Aggregation**
 > "What is the average price by make in Public.cars?"
 
-→ `sas-query({ table: "Public.cars", query: "average price by make", sql: "SELECT make, AVG(msrp) AS avg_price FROM Public.cars GROUP BY make" })`
+→ `sas-score-sas-query({ table: "Public.cars", query: "average price by make", sql: "SELECT make, AVG(msrp) AS avg_price FROM Public.cars GROUP BY make" })`
 
 **Pattern D — Join + analysis**
 > "Show me total sales by customer in the sales and customers tables"
 
-→ `sas-query()` with a JOIN in the generated SQL
+→ `sas-score-sas-query()` with a JOIN in the generated SQL
 
 ---
 
@@ -123,16 +129,23 @@ sas-query({
 
 | Problem | Action |
 |---|---|
-| Table not found in either server | Inform user and ask: *"Which library contains this table? (e.g., Public, Samples, mylib)"* |
+| Library not found | Use `sas-find-library-smart` skill to verify the library exists |
+| Table not found in either server | Inform user and suggest checking the table name |
 | Table exists in both CAS and SAS | Ask: *"The table exists in both servers. Which would you prefer: CAS or SAS?"* |
 | Table exists only in one server | Use that server automatically in your request |
-| Library not found | Inform user and ask to verify the library name |
 | Table name missing entirely | Ask: *"Which table should I read from?"* |
 | Ambiguous intent (raw vs aggregate) | Ask: *"Do you want individual rows or a summary by some field?"* |
 | Empty result | Inform user, ask to adjust filter or query |
 
 ---
 
+## Integration with other skills
+
+- **Before this skill**: Use `sas-find-library-smart` to verify and locate the library
+- **After this skill**: Use `sas-read-and-score` to score the retrieved data
+
+---
+
 ## Next steps
 
 Once data is retrieved, typical follow-ups include: