@terminusagents/agents 0.1.0 → 0.1.1

package/README.md

@@ -50,6 +50,10 @@ pnpm build
 npx terminus-agent init
 ```
 
+`init` uses production-safe defaults:
+- testnet: `wss://cp-sepolia.termn.xyz/ws`
+- mainnet: `wss://cp-mainnet.termn.xyz/ws`
+
 3. Export required runtime secrets:
 
 ```bash
@@ -109,13 +113,13 @@ npx terminus-agent run       # start agent client
 Optional preset environment variables:
 
 ```bash
-export TERMINUS_CONTROL_PLANE_URL_LOCAL=ws://localhost:8084
-export TERMINUS_CONTROL_PLANE_URL_TESTNET=wss://<sepolia-control-plane>
-export TERMINUS_CONTROL_PLANE_URL_MAINNET=wss://<mainnet-control-plane>
+export TERMINUS_CONTROL_PLANE_URL_LOCAL=ws://localhost:8084/ws
+export TERMINUS_CONTROL_PLANE_URL_TESTNET=wss://cp-sepolia.termn.xyz/ws
+export TERMINUS_CONTROL_PLANE_URL_MAINNET=wss://cp-mainnet.termn.xyz/ws
 ```
 
 Notes:
-- `mainnet` profile requires `wss://`
+- `testnet` and `mainnet` profiles require `wss://`
 - if `REQUIRE_WSS=true`, plain `ws://` is rejected
 
 ## Security Defaults
@@ -141,7 +145,7 @@ Example:
   "agentType": "travel-planner",
   "wallet": "0x1234567890abcdef1234567890abcdef12345678",
   "apiKey": "__ENV__",
-  "controlPlaneUrl": "wss://example-control-plane",
+  "controlPlaneUrl": "wss://cp-sepolia.termn.xyz/ws",
   "nodeId": "travel-planner-123456-a1b2c3d4",
   "llmProvider": "grok",
   "networkProfile": "testnet"
@@ -155,7 +159,7 @@ Example:
 ### `Connection failed`
 - run `npx terminus-agent doctor --full`
 - verify control plane URL and firewall
-- for mainnet, verify URL starts with `wss://`
+- for testnet/mainnet, verify URL starts with `wss://`
 
 ### `Auth failed`
 - verify `TERMINUS_WALLET_PRIVATE_KEY` is set

package/dist/cli/init.js

@@ -42,14 +42,16 @@ const NETWORK_LABELS = {
     testnet: 'Base Sepolia testnet',
     mainnet: 'Base mainnet',
 };
+const DEFAULT_TESTNET_CONTROL_PLANE_URL = 'wss://cp-sepolia.termn.xyz/ws';
+const DEFAULT_MAINNET_CONTROL_PLANE_URL = 'wss://cp-mainnet.termn.xyz/ws';
 const NETWORK_URL_PRESETS = {
-    local: process.env.TERMINUS_CONTROL_PLANE_URL_LOCAL?.trim() || 'ws://localhost:8084',
+    local: process.env.TERMINUS_CONTROL_PLANE_URL_LOCAL?.trim() || 'ws://localhost:8084/ws',
     testnet: process.env.TERMINUS_CONTROL_PLANE_URL_TESTNET?.trim() ||
         process.env.TERMINUS_CONTROL_PLANE_URL?.trim() ||
-        'ws://localhost:8084',
+        DEFAULT_TESTNET_CONTROL_PLANE_URL,
     mainnet: process.env.TERMINUS_CONTROL_PLANE_URL_MAINNET?.trim() ||
         process.env.TERMINUS_CONTROL_PLANE_URL?.trim() ||
-        'wss://localhost:8084',
+        DEFAULT_MAINNET_CONTROL_PLANE_URL,
 };
 const LLM_CHOICES = [
     {
@@ -87,6 +89,22 @@ function isValidWallet(input) {
 function isWsUrl(input) {
     return input.startsWith('ws://') || input.startsWith('wss://');
 }
+function normalizeControlPlaneUrl(input) {
+    const trimmed = input.trim();
+    if (!trimmed)
+        return trimmed;
+    try {
+        const parsed = new URL(trimmed);
+        if ((parsed.protocol === 'ws:' || parsed.protocol === 'wss:') && (parsed.pathname === '' || parsed.pathname === '/')) {
+            parsed.pathname = '/ws';
+            return parsed.toString();
+        }
+    }
+    catch {
+        // Keep original value; validation layer handles invalid URLs.
+    }
+    return trimmed;
+}
 function normalizeProvider(provider) {
     if (!provider)
         return undefined;
@@ -308,13 +326,14 @@ async function selectNetworkProfile(initialValue, nonInteractive) {
     return profile;
 }
 async function selectControlPlaneUrl(profile, initialValue, nonInteractive) {
-    const defaultUrl = initialValue?.trim() || NETWORK_URL_PRESETS[profile];
+    const defaultUrl = normalizeControlPlaneUrl(initialValue?.trim() || NETWORK_URL_PRESETS[profile]);
+    const requiresSecureWs = profile !== 'local';
     if (nonInteractive) {
         if (!isWsUrl(defaultUrl)) {
             throw new Error('controlPlaneUrl must start with ws:// or wss://');
         }
-        if (profile === 'mainnet' && !defaultUrl.startsWith('wss://')) {
-            throw new Error('Mainnet profile requires wss:// control-plane URL.');
+        if (requiresSecureWs && !defaultUrl.startsWith('wss://')) {
+            throw new Error(`${NETWORK_LABELS[profile]} profile requires wss:// control-plane URL.`);
         }
         return defaultUrl;
     }
@@ -327,14 +346,14 @@ async function selectControlPlaneUrl(profile, initialValue, nonInteractive) {
             validate: (input) => {
                 if (!isWsUrl(input))
                     return 'URL must start with ws:// or wss://';
-                if (profile === 'mainnet' && !input.startsWith('wss://')) {
-                    return 'Mainnet requires wss://';
+                if (requiresSecureWs && !input.startsWith('wss://')) {
+                    return `${NETWORK_LABELS[profile]} requires wss://`;
                 }
                 return true;
             },
         },
     ]);
-    return String(controlPlaneUrl);
+    return normalizeControlPlaneUrl(String(controlPlaneUrl));
 }
 export async function initCommand(rawOptions = {}) {
     const options = {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@terminusagents/agents",
-    "version": "0.1.0",
+    "version": "0.1.1",
     "description": "Standalone agent runner for Terminus network",
     "type": "module",
     "main": "dist/index.js",