@sassoftware/sas-score-mcp-serverjs 0.4.1-20 → 0.4.1-22

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/cli.js CHANGED
@@ -23,6 +23,7 @@ import readCerts from './src/toolHelpers/readCerts.js';
23
23
  import { fileURLToPath } from 'url';
24
24
  import { dirname, join } from 'path';
25
25
  import os from 'os';
26
+ import setupSkills from './src/setupSkills.js';
26
27
  import { parseArgs } from "node:util";
27
28
 
28
29
  import NodeCache from 'node-cache';
@@ -213,11 +214,21 @@ if (args.values.version) {
213
214
  // the -client indicates the current mcp client
214
215
  console.error(`[Note] MCP client set to: ${process.env.CLIENT}`);
215
216
 
217
+
216
218
  let client = process.env.CLIENT;
219
+ if (client !== 'none') {
220
+ console.error(`[Note] Setting up skills for client: ${client}...`);
221
+ setupSkills(client);
222
+ } else {
223
+ console.error(`[Note] No client specified, skipping skill setup...`);
224
+ }
225
+
226
+
227
+ /*
217
228
  if (client !== 'none') {
218
229
  let destdir = '.' + client;
219
230
  let skillsDest = join(os.homedir(), destdir,'skills');
220
- const skillsSrc = join(__dirname, 'skills');
231
+ const skillsSrc = join(__dirname, '.github');
221
232
  if (!fs.existsSync(skillsSrc)) {
222
233
  console.error('No skills directory found in this package.');
223
234
  process.exit(1);
@@ -244,6 +255,7 @@ if (client !== 'none') {
244
255
 
245
256
  }
246
257
  }
258
+ */
247
259
 
248
260
 
249
261
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@sassoftware/sas-score-mcp-serverjs",
3
- "version": "0.4.1-20",
3
+ "version": "0.4.1-22",
4
4
  "description": "A mcp server for SAS Viya",
5
5
  "author": "Deva Kumar <deva.kumar@sas.com>",
6
6
  "license": "Apache-2.0",
@@ -42,9 +42,8 @@
42
42
  "cli.js",
43
43
  "openApi.json",
44
44
  "openApi.yaml",
45
- "skills",
46
45
  "scripts",
47
- ".claude"
46
+ ".github"
48
47
  ],
49
48
  "dependencies": {
50
49
  "@modelcontextprotocol/sdk": "^1.29.0",
@@ -1,78 +1,32 @@
1
1
  #!/usr/bin/env node
2
-
3
2
  import fs from 'fs';
4
3
  import path from 'path';
5
4
  import { fileURLToPath } from 'url';
6
- import { parseArgs } from "node:util";
7
-
8
- const __filename = fileURLToPath(import.meta.url);
9
- const __dirname = path.dirname(__filename);
10
-
11
- // Recursive copy function
12
- function copyRecursiveSync(src, dest) {
13
- const stat = fs.statSync(src);
14
-
15
- if (stat.isDirectory()) {
16
- if (!fs.existsSync(dest)) {
17
- fs.mkdirSync(dest, { recursive: true });
18
- }
19
- const files = fs.readdirSync(src);
20
- files.forEach(file => {
21
- copyRecursiveSync(path.join(src, file), path.join(dest, file));
5
+ const __dirname = path.dirname(fileURLToPath(import.meta.url));
6
+ // Paths
7
+ let client = (process.env.CLIENTNAME == null) ? '.github' : `.${process.env.CLIENTNAME.toLowerCase()}`;
8
+ const source = path.join(__dirname, `.skills`);
9
+ const destination = path.join(process.cwd(), client);
10
+ console.error(`📁 Copying ${source} to ${destination}...`);
11
+ function copyFolderSync(from, to) {
12
+ if (!fs.existsSync(from)) return;
13
+ if (!fs.existsSync(to)) fs.mkdirSync(to, { recursive: true });
14
+ console.error(`📁 Copying folder: ${from} to ${to}`);
15
+ fs.readdirSync(from).forEach(element => {
16
+ const fromPath = path.join(from, element);
17
+ const toPath = path.join(to, element);
18
+ if (fs.lstatSync(fromPath).isFile()) {
19
+ fs.copyFileSync(fromPath, toPath);
20
+ } else if (fs.lstatSync(fromPath).isDirectory()) {
21
+ copyFolderSync(fromPath, toPath);
22
+ }
22
23
  });
23
- } else {
24
- fs.copyFileSync(src, dest);
25
- }
26
- }
27
-
28
- // Get folder name from command line arguments or environment variable
29
- const args = parseArgs({
30
- options: {
31
- 'skills-folder': {
32
- type: 'string',
33
- short: 'f',
34
- description: 'Skills folder name'
35
- }
36
- }});
37
-
38
- let folderName = args.values['skills-folder'] || process.env.SKILLS_FOLDER_NAME;
39
- if (folderName == null) {
40
- folderName = '.github';
41
- }
42
- folderName = folderName + '/skills';
43
- // If no folder name provided, show usage
44
- if (!folderName) {
45
- console.error('Usage:');
46
- console.error(' npm run setup-skills -f <folder-name>');
47
- console.error(' or set SKILLS_FOLDER_NAME environment variable');
48
- console.error('\nExample:');
49
- console.error(' npm run setup-skills -f my-skills-folder');
50
- process.exit(0);
51
- }
52
- console.error(`Setting up skills in folder: ${folderName}`);
53
- // Resolve paths
54
- const skillsSourcePath = path.join(__dirname, '../skills');
55
- const targetPath = path.join(process.cwd(), folderName);
56
-
57
- // Check if skills folder exists
58
- if (!fs.existsSync(skillsSourcePath)) {
59
- console.error(`Error: Skills folder not found at ${skillsSourcePath}`);
60
- process.exit(1);
61
24
  }
62
25
 
63
26
  try {
64
- // Create target directory if it doesn't exist
65
- if (!fs.existsSync(targetPath)) {
66
- fs.mkdirSync(targetPath, { recursive: true });
67
- console.error(`✓ Created folder: ${targetPath}`);
68
- } else {
69
- console.error(`✓ Folder already exists: ${targetPath}`);
70
- }
71
-
72
- // Copy skills folder contents to target
73
- copyRecursiveSync(skillsSourcePath, targetPath);
74
- console.error(`✓ Successfully copied skills to: ${targetPath}`);
75
- } catch (error) {
76
- console.error('Error during setup:', error.message);
77
- process.exit(1);
27
+ copyFolderSync(source, destination);
28
+ console.error(`✅ Success: ${destination} folder is now in your project root.`);
29
+ } catch (err) {
30
+ console.error('❌ Error copying files:', err.message);
78
31
  }
32
+ process.exit(0);
@@ -0,0 +1,37 @@
1
+ #!/usr/bin/env node
2
+ import fs from 'fs';
3
+ import path from 'path';
4
+ import os from 'os';
5
+ import { fileURLToPath } from 'url';
6
+
7
+ function setupSkills(clientName) {
8
+ const __dirname = path.dirname(fileURLToPath(import.meta.url));
9
+ // Paths
10
+ let client = (clientName == null) ? '.github' : `.${clientName.toLowerCase()}`;
11
+ const source = path.join(__dirname, `../.skills`);
12
+ const destination = path.join(os.homedir(), client);
13
+ console.error(`📁 Copying ${source} to ${destination}...`);
14
+ function copyFolderSync(from, to) {
15
+ if (!fs.existsSync(from)) return;
16
+ if (!fs.existsSync(to)) fs.mkdirSync(to, { recursive: true });
17
+ console.error(`📁 Copying folder: ${from} to ${to}`);
18
+ fs.readdirSync(from).forEach(element => {
19
+ console.error(`📁 Processing: ${element}`);
20
+ const fromPath = path.join(from, element);
21
+ const toPath = path.join(to, element);
22
+ if (fs.lstatSync(fromPath).isFile()) {
23
+ fs.copyFileSync(fromPath, toPath);
24
+ } else if (fs.lstatSync(fromPath).isDirectory()) {
25
+ copyFolderSync(fromPath, toPath);
26
+ }
27
+ });
28
+ }
29
+
30
+ try {
31
+ copyFolderSync(source, destination);
32
+ console.error(`✅ Success: ${destination} folder is now in your project root.`);
33
+ } catch (err) {
34
+ console.error('❌ Error copying files:', err.message);
35
+ }
36
+ }
37
+ export default setupSkills;
@@ -9,7 +9,7 @@ import _listModels from '../toolHelpers/_listModels.js';
9
9
 
10
10
  function findModel(_appContext) {
11
11
  let description = `
12
- find-model — locate a specific model deployed to MAS (Model Aggregation Service).
12
+ find-model — locate a specific MAS model deployed to MAS server
13
13
 
14
14
  USE when: find model, does model exist, is model deployed, lookup model, verify model exists
15
15
  DO NOT USE for: list models (use list-models), model info/variables (use model-info), score model (use model-score), find table/job/lib (use respective tools), scr models (use scr-info/scr-score)
@@ -47,8 +47,8 @@ Returns { tables: [] } if not found; { tables: [name, ...] } if found. Never hal
47
47
  name: 'find-table',
48
48
  description: description,
49
49
  inputSchema: z.object({
50
- name: z.string(),
51
50
  lib: z.string(),
51
+ name: z.string(),
52
52
  server: z.string()
53
53
  }),
54
54
 
@@ -10,7 +10,7 @@ const log = debug('tools');
10
10
 
11
11
  function modelScore(_appContext) {
12
12
  let description = `
13
- model-score — score data using a deployed model on MAS.
13
+ mas-score — score data using a deployed model on MAS.
14
14
 
15
15
  USE when: score with model, predict using model, batch scoring, model predictions
16
16
  DO NOT USE for: find model, model metadata, list models, run programs/jobs, query tables
@@ -40,7 +40,7 @@ Returns predictions, probabilities, scores merged with input data. Returns error
40
40
 
41
41
 
42
42
  let spec = {
43
- name: 'model-score',
43
+ name: 'mas-score',
44
44
  description: description,
45
45
  inputSchema:z.object({
46
46
  model: z.string(),
@@ -9,9 +9,9 @@ import _jobSubmit from '../toolHelpers/_jobSubmit.js';
9
9
  function runJob(_appContext) {
10
10
 
11
11
  let description = `
12
- run-job — execute a deployed SAS Viya job.
12
+ run-job — score with a deployed SAS Viya job.
13
13
 
14
- USE when: run job, execute job, run with parameters
14
+ USE when: score with job, run job, execute job
15
15
  DO NOT USE for: arbitrary SAS code (use run-sas-program), macros (use run-macro), list/find jobs
16
16
 
17
17
  PARAMETERS
@@ -10,9 +10,9 @@ function runJobdef(_appContext) {
10
10
  // JSON object for LLM/tooling
11
11
 
12
12
  let description = `
13
- run-jobdef — execute a SAS Viya job definition.
13
+ run-jobdef — score with a deployed SAS Viya job definition.
14
14
 
15
- USE when: run jobdef, execute jobdef, run with parameters
15
+ USE when: score with jobdef, run jobdef, execute jobdef
16
16
  DO NOT USE for: arbitrary SAS code (use run-sas-program), macros (use run-macro), list/find jobdefs
17
17
 
18
18
  PARAMETERS
@@ -1,129 +0,0 @@
1
- ---
2
- name: mcp-tool-description-optimizer
3
- description: >
4
- Optimize MCP (Model Context Protocol) tool descriptions for token efficiency and LLM routing accuracy.
5
- Use this skill whenever a user shares a raw, verbose, or poorly structured MCP tool description and wants
6
- it improved, rewritten, or reviewed. Trigger on phrases like: "optimize this tool description",
7
- "rewrite my MCP tool description", "make this tool description more efficient", "clean up my tool spec",
8
- "improve how Claude picks my tool", or when a user pastes a JavaScript/TypeScript tool description string
9
- and asks for help with it. Also trigger when the user mentions token efficiency, tool routing,
10
- or LLM disambiguation in the context of MCP servers.
11
- ---
12
-
13
- # MCP Tool Description Optimizer
14
-
15
- Rewrites verbose or poorly structured MCP tool descriptions into compact, signal-rich versions that
16
- improve LLM tool selection accuracy while reducing token usage.
17
-
18
- ## Why this matters
19
-
20
- Claude and other LLMs select MCP tools based entirely on the `description` field. Descriptions that are
21
- too long, redundant, or badly structured waste context tokens and reduce routing precision.
22
- A well-optimized description:
23
- - States what the tool does and when to use it upfront
24
- - Eliminates redundancy (same info repeated across sections)
25
- - Uses a compact, scannable format (labeled blocks, not nested markdown)
26
- - Includes clear negative examples to prevent mis-routing
27
- - Keeps parameters terse — name, type, default, one-line purpose
28
-
29
- ---
30
-
31
- ## Optimization Process
32
-
33
- ### Step 1 — Analyze the input description
34
-
35
- Before rewriting, identify these problems in the original:
36
-
37
- | Problem | Example |
38
- |---|---|
39
- | **Redundancy** | Trigger phrases listed in 3+ places |
40
- | **Filler sections** | "Rationale", "Behavior Summary", "Response Contract" with no routing signal |
41
- | **Orphaned syntax** | Arrows (`→`) or bullets with no target |
42
- | **Overlong examples** | Long prose examples when one-liners suffice |
43
- | **Heavy markdown** | `##` headers for every minor point |
44
- | **Duplicated parameter docs** | Same param described in both a table and prose |
45
-
46
- Call out 2–4 of the most impactful issues before writing the new version.
47
-
48
- ### Step 2 — Rewrite using the standard template
49
-
50
- Use this exact block structure for the output. Omit blocks that don't apply.
51
-
52
- ```
53
- <tool-name> — <one-line purpose>.
54
-
55
- USE when: <comma-separated user intents or trigger phrases>
56
- DO NOT USE for: <comma-separated anti-patterns with → redirect where applicable>
57
-
58
- PARAMETERS
59
- - <name>: <type> (default: <val>) — <one-line purpose>
60
- ...
61
-
62
- ROUTING RULES
63
- - "<trigger phrase>" → { param: value }
64
- - "<trigger phrase>" → { param: value }
65
- - <ambiguous case> → <ask for clarification | default behavior>
66
-
67
- EXAMPLES
68
- - "<user utterance>" → { param: value, ... }
69
- - "<user utterance>" → { param: value, ... }
70
-
71
- NEGATIVE EXAMPLES (do not route here)
72
- - "<user utterance>" → <correct tool>
73
-
74
- PAGINATION (include only if tool is paginated)
75
- If returned count === limit → hint: next start = start + limit.
76
- If start > 1 and result empty → note paging may exceed available items.
77
-
78
- ERRORS
79
- <One or two lines: return structure, hallucination policy>
80
- ```
81
-
82
- ### Step 3 — Apply these rules consistently
83
-
84
- **USE/DO NOT USE block**
85
- - Write as comma-separated inline list, not a bullet list
86
- - DO NOT USE entries should name the redirect tool in parentheses where known
87
-
88
- **ROUTING RULES block**
89
- - One rule per line; quote the trigger phrase; use `→ { }` for param mapping
90
- - Consolidate synonyms on one line: `"cas libs / cas libraries / in cas" → { server: 'cas' }`
91
- - List the default/fallback rule last
92
-
93
- **PARAMETERS block**
94
- - One line per param: `- name: type (default: val) — purpose`
95
- - Skip obvious params (e.g. don't explain what `limit` means if it's standard pagination)
96
-
97
- **EXAMPLES block**
98
- - Each example fits on one line
99
- - For "next page" examples, include the prior call's state inline: `"next" (prev: start:1, limit:10) → { start: 11, limit: 10 }`
100
-
101
- **NEGATIVE EXAMPLES block**
102
- - Only include when mis-routing is a real risk
103
- - Format: `"<utterance>" → <correct-tool-name>`
104
-
105
- **Tone**
106
- - Imperative, terse. No filler words ("Please note that...", "It is important to...")
107
- - Never include a "Rationale" or "Behavior Summary" section — if behavior matters, encode it as a rule
108
-
109
- ### Step 4 — Validate before returning
110
-
111
- Check the rewritten description against this list:
112
-
113
- - [ ] No trigger phrase appears in more than one block
114
- - [ ] No orphaned `→` arrows or dangling bullets
115
- - [ ] Parameter defaults are stated explicitly
116
- - [ ] Negative examples cover the tool's most common mis-routing risks
117
- - [ ] Total length is ≤ 50% of the original (target: 30–40% reduction)
118
-
119
- ---
120
-
121
- ## Output format
122
-
123
- Always return:
124
-
125
- 1. **Analysis** — 2–4 bullet points naming the key issues found in the original
126
- 2. **Rewritten description** — inside a JavaScript code block (matching the user's original code style)
127
- 3. **Change summary** — a short table or bullet list of what changed and why
128
-
129
- See `references/examples.md` for before/after examples of real tool descriptions.
@@ -1,123 +0,0 @@
1
- # Before / After Examples
2
-
3
- ## Example 1 — list-libraries (SAS Viya MCP)
4
-
5
- ### BEFORE (~620 tokens)
6
-
7
- ```
8
- ## list-libraries — enumerate CAS or SAS libraries
9
-
10
- LLM Invocation Guidance (critical)
11
- Use THIS tool when the user asks for: "list libs", "list libraries", "show cas libs", "show sas libs",
12
- "what libraries are available", "list caslib(s)", "enumerate libraries", "libraries in cas", "libraries in sas".
13
- DO NOT use this tool when the user asks for: tables inside a specific library (choose listTables),
14
- columns/metadata of a table, job/program execution, models, or scoring.
15
-
16
- Trigger Phrase → Parameter Mapping
17
- - "cas libs" / "in cas" / "cas libraries" → { server: 'cas' }
18
- - "sas libs" / "in sas" / "base sas libraries" → { server: 'sas' }
19
- - "all libs" / "all libs" -> {server: 'all'}
20
- → { server: 'all' }
21
- - "next" (after prior call) → { start: previous.start + previous.limit }
22
- - "first 20 cas libs" → { server: 'cas', limit: 20 }
23
- - If server unspecified: default to all.
24
-
25
- Parameters
26
- - server (cas|sas|all, default 'all')
27
- - limit (integer > 0, default 10)
28
- - start (1-based offset, default 1)
29
- - where (optional filter expression, default '')
30
-
31
- Response Contract
32
- Return JSON-like structure from helper; consumers may extract an array of library objects/names.
33
- If number of returned items === limit supply a pagination hint: start = start + limit.
34
-
35
- Behavior Summary
36
- - Pure listing; no side effects.
37
- - If ambiguous short request like "list" or "libs" and no prior context: assume { server: 'cas' }.
38
- - If user explicitly asks for ALL (e.g. "all cas libs") and count likely large, honor limit=50 unless
39
- user supplies a value; include note about paging.
40
-
41
- Disambiguation Rules
42
- - If user mentions a singular library name plus desire for tables ("list tables in SASHELP") choose
43
- listTables (not this tool).
44
- - If user mixes "tables" and "libraries" ask for clarification unless clearly about libraries.
45
-
46
- Examples
47
- - "list libraries" → { server: 'all', start:1, limit:10 }
48
- - "list libs" → { server: 'all', start:1, limit:10 }
49
- - "list sas libs" → { server: 'sas' }
50
- - "list cas libraries" → { server: 'cas' }
51
- - "show me 25 cas libraries" → { server:'cas', limit:25 }
52
- - "next" (after prior call {start:1,limit:10}) → { start:11, limit:10 }
53
- - "filter cas libs" (no criterion) → ask: "Provide a filter or continue without one?"
54
-
55
- Negative Examples (do not route here)
56
- - "list tables in public" (route to list-tables)
57
- - "list models, list tables, list jobs, list jobdef and similar request"
58
- - "describe library" (likely list-tables or table-info depending on follow-up)
59
- - "run program to make a lib" (run-sas-program tool)
60
-
61
- Error Handling
62
- - On backend error: return structured error with message field; do not hallucinate libraries.
63
- - Empty result set → return empty list plus (if start>1) a hint that paging may have exceeded available items.
64
-
65
- Rationale
66
- Concise, signal-rich description increases probability this spec is selected for generic library
67
- enumeration intents.
68
- ```
69
-
70
- ### AFTER (~210 tokens)
71
-
72
- ```
73
- list-libraries — enumerate CAS or SAS libraries.
74
-
75
- USE when: list/show/enumerate libraries, caslibs, sas libs, available libraries
76
- DO NOT USE for: listing tables in a library (→ list-tables), column/table metadata, job execution, models, scoring
77
-
78
- PARAMETERS
79
- - server: 'cas' | 'sas' | 'all' (default: 'all')
80
- - limit: integer > 0 (default: 10)
81
- - start: 1-based offset (default: 1)
82
- - where: optional filter expression (default: '')
83
-
84
- ROUTING RULES
85
- - "cas libs / cas libraries / in cas" → { server: 'cas' }
86
- - "sas libs / sas libraries / in sas" → { server: 'sas' }
87
- - "all libs / all libraries" → { server: 'all' }
88
- - "all cas libs" with no limit given → { server: 'cas', limit: 50 } + paging note
89
- - "next" after prior call (start:S, limit:L) → { start: S + L, limit: L }
90
- - "filter cas libs" with no filter given → ask: "What filter expression should I apply?"
91
- - server unspecified / ambiguous "list"/"libs" → { server: 'cas' }
92
-
93
- EXAMPLES
94
- - "list libraries" → { server: 'all', start: 1, limit: 10 }
95
- - "list cas libraries" → { server: 'cas', start: 1, limit: 10 }
96
- - "show me 25 sas libs" → { server: 'sas', limit: 25, start: 1 }
97
- - "next" (prev: start:1,limit:10) → { server: <same>, start: 11, limit: 10 }
98
-
99
- NEGATIVE EXAMPLES (do not route here)
100
- - "list tables in SASHELP" → list-tables
101
- - "list models / jobs / jobdefs" → respective tools
102
- - "run a program to create a lib" → run-sas-program
103
-
104
- PAGINATION
105
- If returned count === limit → hint: next start = start + limit.
106
- If start > 1 and result empty → note paging may exceed available items.
107
-
108
- ERRORS
109
- Return structured error with message field. Never hallucinate library names.
110
- ```
111
-
112
- **Token reduction: ~66%**
113
-
114
- ---
115
-
116
- ## Key patterns illustrated
117
-
118
- - Trigger phrases consolidated from 3 blocks → 1 ROUTING RULES block
119
- - "Rationale", "Behavior Summary", "Response Contract" sections eliminated
120
- - Orphaned `→ { server: 'all' }` arrow removed
121
- - Parameter defaults made explicit inline
122
- - Examples trimmed to one line each
123
- - Negative examples now name the redirect tool explicitly
@@ -1,154 +0,0 @@
1
- ---
2
- name: sas-find-library-smart
3
- description: >
4
- Find a SAS Viya library (libref or caslib) with intelligent server detection. Automatically checks
5
- CAS first, then SAS if not found. Use this skill when the user needs to verify a library exists,
6
- before accessing tables within it. Trigger phrases include: "find library", "does library exist",
7
- "check if library", "locate library", "is there a library named", "verify library", or any request
8
- to confirm a library's availability across servers.
9
- ---
10
-
11
- # Smart Library Lookup (Find Library)
12
-
13
- Intelligently locates a SAS Viya library by checking CAS first, then SAS if the library is not found
14
- in CAS. Provides the user with clear information about library availability and location.
15
-
16
- **If the user specifies the server explicitly** (e.g., "find library Public in cas"):
17
- - Use the specified server: `server: "cas"` or `server: "sas"`
18
- - Proceed directly to finding the library
19
-
20
- **If the server is NOT specified:**
21
- 1. **First attempt**: Check CAS (`server: "cas"`)
22
- 2. **If not found in CAS**: Check SAS with uppercase library name (`server: "sas"`)
23
- 3. **If not found in either**:
24
- - Inform user: *"The library '&lt;lib&gt;' was not found in CAS or SAS servers. Please verify the library name."*
25
- - Suggest: *"Would you like to list available libraries?"* (suggest `sas-score-list-libraries`)
26
- 4. **If found**:
27
- - Inform user which server contains the library: *"Found library '&lt;lib&gt;' in CAS"* or *"Found library '&lt;lib&gt;' in SAS"*
28
- - Offer next steps: *"Would you like to list tables in this library?"* (suggest `sas-score-list-tables`)
29
-
30
- ---
31
-
32
- ## Using sas-score-find-library
33
-
34
- **When:**
35
- - User wants to verify a library exists
36
- - User needs to determine which server contains a library
37
- - User wants to check library availability before accessing it
38
- - User wants to explore available libraries (before querying)
39
-
40
- **How:**
41
- ```
42
- sas-score-find-library({
43
- name: "libraryname", // required
44
- server: "cas" or "sas" // optional; determined by server check if not specified
45
- })
46
- ```
47
-
48
- **Rules:**
49
- - Always determine the correct server first (cas → sas → neither)
50
- - **For SAS server: always uppercase the library name** (e.g., "public" → "PUBLIC")
51
- - If library name is missing, ask: *"Which library name would you like to find?"*
52
- - Return the server where the library was found
53
- - If not found in either server, clearly inform the user and offer to list available libraries
54
- - Do not proceed with table access until library existence is confirmed
55
-
56
- ---
57
-
58
- ## Smart server detection logic
59
-
60
- ```
61
- IF server specified by user
62
- → IF server is "sas"
63
- → uppercase lib
64
- → use that server, call sas-score-find-library
65
- ELSE
66
- → TRY sas-score-find-library(lib, server="cas")
67
- IF library found
68
- → success, inform user: library found in CAS
69
- ELSE
70
- → uppercase lib
71
- → TRY sas-score-find-library(lib.toUpperCase(), server="sas")
72
- IF library found
73
- → success, inform user: library found in SAS
74
- ELSE
75
- → inform user library not found in either server
76
- → offer to list available libraries
77
- ```
78
-
79
- ---
80
-
81
- ## Common patterns
82
-
83
- **Pattern 1 — Find library, server unspecified**
84
- > "Find library Public"
85
-
86
- 1. Try CAS: `sas-score-find-library({ name: "Public", server: "cas" })`
87
- 2. If not found, try SAS with uppercase: `sas-score-find-library({ name: "PUBLIC", server: "sas" })`
88
- 3. If found in CAS → *"Found library 'Public' in CAS. Would you like to list tables in it?"*
89
- 4. If found in SAS → *"Found library 'PUBLIC' in SAS. Would you like to list tables in it?"*
90
- 5. If not found → *"The library 'Public' was not found in CAS or SAS. Would you like to list available libraries?"*
91
-
92
- **Pattern 2 — Find library with explicit server (CAS)**
93
- > "Find library MyData in cas"
94
-
95
- 1. Skip server detection
96
- 2. Call: `sas-score-find-library({ name: "MyData", server: "cas" })`
97
- 3. Result → *"Found library 'MyData' in CAS"* or *"Library 'MyData' not found in CAS"*
98
-
99
- **Pattern 3 — Find library with explicit server (SAS)**
100
- > "Does library SASHELP exist in sas"
101
-
102
- 1. Skip server detection
103
- 2. Uppercase lib: `sas-score-find-library({ name: "SASHELP", server: "sas" })`
104
- 3. Result → *"Found library 'SASHELP' in SAS"* or *"Library 'SASHELP' not found in SAS"*
105
-
106
- **Pattern 4 — Library not found, offer next steps**
107
- > "Check if library staging exists"
108
-
109
- 1. Try CAS: `sas-score-find-library({ name: "staging", server: "cas" })` → not found
110
- 2. Try SAS: `sas-score-find-library({ name: "STAGING", server: "sas" })` → not found
111
- 3. Respond:
112
- - *"The library 'staging' was not found in CAS or SAS."*
113
- - *"Would you like to:"*
114
- - *"List all available libraries? (use `sas-score-list-libraries`))"*
115
- - *"Check a different library name?"*
116
-
117
- **Pattern 5 — Library found, follow-up action**
118
- > "Verify library samples exists"
119
-
120
- 1. Try CAS: `sas-score-find-library({ name: "samples", server: "cas" })` → found
121
- 2. Respond:
122
- - *"Found library 'samples' in CAS."*
123
- - *"Would you like to list tables in this library? (use `sas-score-list-tables`))"*
124
-
125
- ---
126
-
127
- ## Output presentation
128
-
129
- **When library is found:**
130
- ```
131
- ✓ Found library '<lib>' in <SERVER>
132
-
133
- Would you like to:
134
- • List tables in this library (use sas-list-tables-smart skill)
135
- • Read data from a specific table (use sas-read-strategy skill)
136
- ```
137
-
138
- **When library is not found:**
139
- ```
140
- ✗ Library '<lib>' not found in either CAS or SAS
141
-
142
- Suggestions:
143
- • Check the spelling of the library name
144
- • List available libraries (use list-libraries tool)
145
- • Try a different library name
146
- ```
147
-
148
- ---
149
-
150
- ## Integration with other skills
151
-
152
- - **After finding library → List tables**: Use `sas-list-tables-smart` skill to browse available tables
153
- - **After finding library → Read data**: Use `sas-read-strategy` skill to retrieve data from tables
154
- - **Library not found → Explore**: Use `sas-score-list-libraries` tool to see all available libraries