@wuyax/mcps 0.1.0-beta.3 → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 wuyax
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -653,7 +653,7 @@ import {
   resolveConfigClusters,
   getCoHostedAgents,
   getCandidateAgentsForScope,
-  sortAgentsWithClusters,
+  sortAgentsByClusters,
   installToCompatibleAgents,
 } from "@wuyax/mcps";
 
@@ -673,7 +673,7 @@ for (const cluster of clusters) {
 }
 
 // 3. Sort agents so cluster peers appear adjacent in lists
-const sorted = sortAgentsWithClusters(["github-copilot-cli", "cursor", "claude-code"]);
+const sorted = sortAgentsByClusters(["github-copilot-cli", "cursor", "claude-code"]);
 // ['github-copilot-cli', 'claude-code', 'cursor']
 
 // 4. Batch-install to compatible agents with cluster deduplication
@@ -688,7 +688,25 @@ const results = installToCompatibleAgents("my-server", serverConfig, {
 
 ### Exported Utilities & Interactive Prompts
 
-The interactive wizard flows, prompt components, and inspection/sanitization utilities are also exported for programmatic embedding:
+`mcps` provides two dedicated export surfaces:
+1. **Headless Programmatic SDK (`@wuyax/mcps`)**: Clean, dependency-light API for servers, clusters, protocols, and security masking.
+2. **Interactive UI Wizards & Prompts (`@wuyax/mcps/interactive`)**: Terminal UI wizards and Inquirer prompts for custom CLI integrations.
+
+#### Headless Utilities (`@wuyax/mcps`)
+
+```typescript
+import {
+  parseServerConfig,
+  buildMcpServerConfig,
+  applyServerConfigDelta,
+  detectUpdateTransition,
+  sanitizeUpdatedServerConfig,
+  maskSecretValue,
+  maskSecretHeader,
+} from "@wuyax/mcps";
+```
+
+#### Interactive Terminal UI & Wizards (`@wuyax/mcps/interactive`)
 
 ```typescript
 import {
@@ -698,16 +716,6 @@ import {
   wizardRemove,
   linkedCheckbox,
   buildLinkedAgentChoices,
-  groupInstalledServersByName,
-  normalizeServerConfig,
-  formatCoHostedBadge,
-  logCoHostedNotice,
-  displayServerDetails,
-  resolveTransport,
-  maskSecretValue,
-  maskSecretHeader,
-  sanitizeUpdatedServerConfig,
-  detectUpdateTransition,
   promptSwitchServerType,
   promptScopeAndAgents,
   promptEnvConfig,
@@ -715,7 +723,7 @@ import {
   promptArgsConfig,
   parseEnvText,
   parseHeadersText,
-} from "@wuyax/mcps";
+} from "@wuyax/mcps/interactive";
 ```
 
 ---