cloud-pc-templates 1.3.0 → 1.4.0

package/README.md

@@ -7,6 +7,14 @@ Cloud PC Templates is a command-line tool for managing cloud PC configurations a
 ```bash
 npm install -g cloud-pc-templates
 ```
+## Video Tutorial
+
+For a step-by-step guide on using Cloud PC Templates, watch this video tutorial:
+
+[![Cloud PC Templates Tutorial](https://img.youtube.com/vi/XMF0K9R2rD0/0.jpg)](https://www.youtube.com/watch?v=XMF0K9R2rD0)
+
+[Click here to watch on YouTube](https://www.youtube.com/watch?v=XMF0K9R2rD0)
+
 
 ## Usage
 
@@ -42,14 +50,7 @@ npx cloud-pc-templates ai login loginMode ollamacloud
 ```
 
 **What it does:**
-1. Checks if you're already logged in by testing the health endpoint at `http://localhost:3004/health`
-2. If already logged in, displays "Already logged in" message
-3. If not logged in:
-   - Prompts you to enter your API Key (masked input with asterisks)
-   - Downloads the Ollama proxy script from GitHub
-   - Runs the proxy with your API key as an argument
-   - Validates the health endpoint
-   - Displays "Logged in" confirmation
+1. Runs a wrapper service at `http://localhost:3004/health` which is an interface to ollama cloud models, it requires ollama api key.
 
 **Example:**
 ```bash
@@ -59,27 +60,15 @@ Enter API Key: **************************
   - Endpoint checked: http://localhost:3004/health
 ```
 
-**Features:**
-- Masked input for API key (shows `*` instead of actual characters)
-- Supports pasting long API keys
-- Backspace support for corrections
-- Cross-platform terminal support (TTY and non-TTY)
-- Real-time proxy output logging for debugging
-
 ##### Ollama Local Login
 
-Connect to Ollama Local instance:
+Connect to Ollama Local models:
 ```bash
 npx cloud-pc-templates ai login loginMode ollamalocal
 ```
 
 **What it does:**
-1. Checks if Ollama is running on the default port (11434)
-2. If Ollama is not running, displays a warning with installation instructions
-3. Downloads the Ollama Offline Proxy script from GitHub
-4. Runs the proxy on port 3005 (no API key required)
-5. Validates the proxy health endpoint
-6. Displays "Logged in" confirmation
+1. Runs a wrapper service to connect to ollama local models
 
 **Example (with Ollama running):**
 ```bash
@@ -93,26 +82,11 @@ $ npx cloud-pc-templates ai login loginMode ollamalocal
   - Ollama running on: localhost:11434
 ```
 
-**Example (without Ollama running):**
-```bash
-$ npx cloud-pc-templates ai login loginMode ollamalocal
-🔍 Checking if Ollama is running...
-⚠️  WARNING: Ollama is not running on localhost:11434
-   Please install Ollama and run it before using this login mode.
-   Download Ollama from: https://ollama.ai
-
-   After installation, start Ollama with:
-   ollama serve
-
-   Continuing anyway...
-```
-
 **Features:**
 - No API key required
 - Checks for local Ollama installation
 - Helpful warnings with installation instructions
 - Runs proxy on port 3005
-- Provides detailed status output
 
 ##### Hugging Face Login
 
@@ -122,11 +96,7 @@ npx cloud-pc-templates ai login loginMode huggingface
 ```
 
 **What it does:**
-1. Prompts you to enter your Hugging Face API Key (masked input with asterisks)
-2. Downloads the Hugging Face proxy script from GitHub
-3. Runs the proxy on port 3006 with your API key
-4. Validates the proxy health endpoint
-5. Displays "Logged in" confirmation
+1. Runs a wrapper service over huggingface cloud models and it requires huggingface api key
 
 **Example:**
 ```bash
@@ -136,13 +106,49 @@ Enter Hugging Face API Key: ****************************
   - Endpoint checked: http://localhost:3006/health
 ```
 
-**Features:**
-- Masked input for API key (shows `*` instead of actual characters)
-- Supports pasting long API keys
-- Backspace support for corrections
-- Runs proxy on port 3006
-- Real-time proxy output logging for debugging
-- Get your API key from: https://huggingface.co/settings/tokens
+#### AI Agents
+
+Manage and explore available AI agents from the registry.
+
+**Agent Registry URL:**
+```
+https://raw.githubusercontent.com/devashish234073/cloud-pc-templates-marketplace/refs/heads/main/JS-AGENTS/agent-registry.json
+```
+
+##### List All Agents
+
+Display all available agents with their IDs, names, and ports:
+```bash
+npx cloud-pc-templates ai agents list
+```
+
+**Example output:**
+```bash
+$ npx cloud-pc-templates ai agents list
+
+Available Agents
+
+────────────────────────────────────────────────────────────────────────────────
+ID: playwright connector
+Name: Playwright Connector
+Port: 3036
+────────────────────────────────────────────────────────────────────────────────
+ID: mysql connector
+Name: MySQL Connector
+Port: 3037
+────────────────────────────────────────────────────────────────────────────────
+ID: angular connector
+Name: Angular Connector
+Port: 3034
+────────────────────────────────────────────────────────────────────────────────
+```
+
+##### Get Agent Details
+
+Display complete information for a specific agent:
+```bash
+npx cloud-pc-templates ai agents "agent-id"
+```
 
 ### Command Discovery
 
@@ -177,49 +183,12 @@ cloud-pc-templates/
 │   ├── ollamacloud.js      # Ollama Cloud login functionality
 │   ├── ollamalocal.js      # Ollama Local login functionality
 │   ├── huggingface.js      # Hugging Face login functionality
+│   ├── agents.js           # AI agents registry management
 │   └── launch.js           # Website launcher
 ├── package.json            # Project metadata and bin configuration
 └── README.md               # This file
 ```
-
-### Modules
-
-#### index.js
-- **Command Tree**: Hierarchical command structure supporting nested subcommands
-- **Argument Parsing**: Handles command-line arguments with `--` prefix stripping
-- **Request Routing**: Routes commands to appropriate handlers
-
-#### handlers/ollamacloud.js
-- `promptForApiKey()`: Interactive masked API key input
-- `checkHealthEndpoint()`: Health check for proxy server
-- `downloadAndRunProxy()`: Downloads and executes proxy script with API key
-- `checkAndLoginOllamaCloud()`: Main login orchestrator
-
-#### handlers/ollamalocal.js
-- `checkOllamaHealth()`: Verifies Ollama is running on port 11434
-- `downloadAndRunProxy()`: Downloads and executes offline proxy script
-- `checkProxyHealth()`: Health check for the offline proxy
-- `checkAndLoginOllamaLocal()`: Main login orchestrator with warning system
-
-#### handlers/huggingface.js
-- `promptForApiKey()`: Interactive masked API key input
-- `checkHealthEndpoint()`: Health check for proxy server
-- `downloadAndRunProxy()`: Downloads and executes proxy script with API key
-- `checkAndLoginHuggingFace()`: Main login orchestrator
-
-#### handlers/launch.js
-- `openBrowser()`: Cross-platform browser launcher
-- `launchWebsite()`: Opens cloud-pc-templates.com
-
-## Features
-
-### Masked API Key Input
-When logging in to Ollama Cloud, your API key is protected:
-- Each character you type displays as an asterisk `*`
-- Works with keyboard input and pasted text
-- Supports backspace for corrections
-
-### Cross-Platform Support
+### Cross-Platform Support for the launch command
 The launch command works on:
 - macOS (uses `open` command)
 - Linux (uses `xdg-open` command)
@@ -253,36 +222,6 @@ Each handler is a separate module that can be:
 - Extended with new features
 - Reused in other projects
 
-### Adding New Commands
-
-To add a new command:
-
-1. Create a new handler file in `handlers/`:
-```javascript
-// handlers/mycommand.js
-async function myCommandHandler() {
-  // Implementation
-}
-
-module.exports = { myCommandHandler };
-```
-
-2. Import it in `index.js`:
-```javascript
-const { myCommandHandler } = require('./handlers/mycommand');
-```
-
-3. Add it to the command tree:
-```javascript
-const commandTree = {
-  // ... existing commands
-  mycommand: {
-    description: 'My command description',
-    handler: () => myCommandHandler()
-  }
-};
-```
-
 ## NPM Script
 
 The project is configured with a binary entrypoint in `package.json`:
@@ -297,66 +236,10 @@ The project is configured with a binary entrypoint in `package.json`:
 
 This enables the `npx cloud-pc-templates` command globally.
 
-## API Key Security
-
-When entering your API key:
-- Input is masked with asterisks
-- Key is passed directly to the proxy process
-- Never logged or stored in plain text
-- Passed via command-line argument or environment variable
-
-## Troubleshooting
-
-### "Unknown command" error
-- Make sure you've spelled the command correctly
-- Use `npx cloud-pc-templates help` to see available commands
-- Commands are case-sensitive
-
-### Ollama Cloud login fails
-- Check that you have a valid API key
-- Ensure your network connection is stable
-- Try checking if the health endpoint is accessible manually:
-  ```bash
-  curl http://localhost:3004/health
-  ```
-
-### Ollama Local login fails
-- Make sure Ollama is installed: https://ollama.ai
-- Start Ollama with: `ollama serve`
-- Check if Ollama is running on port 11434:
-  ```bash
-  curl http://localhost:11434/api/tags
-  ```
-- Ensure port 3005 is not in use by another application
-
-### Hugging Face login fails
-- Check that you have a valid Hugging Face API key
-- Get your API key from: https://huggingface.co/settings/tokens
-- Make sure your API key has the necessary permissions
-- Ensure port 3006 is not in use by another application
-- Check your internet connection for accessing Hugging Face services
-
-### Browser won't open with `launch`
-- Ensure you have a default browser configured
-- On Linux, make sure `xdg-open` is installed: `sudo apt-get install xdg-utils`
-- On Windows, ensure a browser is set as default
-- On Android/Termux:
-  - For best results, install Termux API: `pkg install termux-api`
-  - Otherwise, `xdg-open` will be used as fallback
-  - Ensure you have a browser app installed on your device
-
-## Video Tutorial
-
-For a step-by-step guide on using Cloud PC Templates, watch this video tutorial:
-
-[![Cloud PC Templates Tutorial](https://img.youtube.com/vi/XMF0K9R2rD0/0.jpg)](https://www.youtube.com/watch?v=XMF0K9R2rD0)
-
-[Click here to watch on YouTube](https://www.youtube.com/watch?v=XMF0K9R2rD0)
-
 ## License
 
 ISC
 
 ## Author
 
-Cloud PC Templates Contributors
+Devashish Priyadarshi

package/handlers/agents.js

@@ -0,0 +1,87 @@
+const AGENTS_REGISTRY_URL = 'https://raw.githubusercontent.com/devashish234073/cloud-pc-templates-marketplace/refs/heads/main/JS-AGENTS/agent-registry.json';
+
+async function fetchAgentsRegistry() {
+  try {
+    const response = await fetch(AGENTS_REGISTRY_URL);
+    if (!response.ok) {
+      throw new Error(`Failed to fetch agents registry: ${response.status} ${response.statusText}`);
+    }
+    return await response.json();
+  } catch (error) {
+    throw new Error(`Failed to fetch agents registry: ${error.message}`);
+  }
+}
+
+async function listAgents() {
+  try {
+    const agents = await fetchAgentsRegistry();
+    
+    if (!Array.isArray(agents) || agents.length === 0) {
+      console.log('No agents found in registry');
+      return;
+    }
+    
+    console.log('\nAvailable Agents\n');
+    console.log('─'.repeat(80));
+    
+    agents.forEach((agent) => {
+      const idStr = `ID: ${agent.id}`.padEnd(40);
+      const nameStr = `Name: ${agent.name}`.padEnd(40);
+      const portStr = `Port: ${agent.port || 'N/A'}`;
+      
+      console.log(idStr);
+      console.log(nameStr);
+      console.log(portStr);
+      console.log('─'.repeat(80));
+    });
+    
+  } catch (error) {
+    console.error(`Error: ${error.message}`);
+    process.exit(1);
+  }
+}
+
+async function getAgentDetails(agentId) {
+  try {
+    const agents = await fetchAgentsRegistry();
+    
+    if (!Array.isArray(agents)) {
+      console.error('Invalid registry format');
+      process.exit(1);
+    }
+    
+    const agent = agents.find(a => a.id.toLowerCase() === agentId.toLowerCase());
+    
+    if (!agent) {
+      console.error(`❌ Agent not found: "${agentId}"`);
+      console.log('\nAvailable agents:');
+      agents.forEach(a => console.log(`  - ${a.id}`));
+      process.exit(1);
+    }
+    
+    console.log(`\nAgent Details: ${agent.name}\n`);
+    console.log('─'.repeat(80));
+    
+    Object.entries(agent).forEach(([key, value]) => {
+      const displayKey = key.charAt(0).toUpperCase() + key.slice(1);
+      
+      if (typeof value === 'string' && value.length > 70) {
+        console.log(`${displayKey}:`);
+        console.log(`  ${value}`);
+      } else {
+        console.log(`${displayKey}: ${value}`);
+      }
+    });
+    
+    console.log('─'.repeat(80) + '\n');
+    
+  } catch (error) {
+    console.error(`Error: ${error.message}`);
+    process.exit(1);
+  }
+}
+
+module.exports = {
+  listAgents,
+  getAgentDetails
+};

package/index.js

@@ -4,6 +4,7 @@ const { checkAndLoginOllamaCloud } = require('./handlers/ollamacloud');
 const { checkAndLoginOllamaLocal } = require('./handlers/ollamalocal');
 const { checkAndLoginHuggingFace } = require('./handlers/huggingface');
 const { launchWebsite } = require('./handlers/launch');
+const { listAgents, getAgentDetails } = require('./handlers/agents');
 
 // Command tree structure
 const commandTree = {
@@ -36,6 +37,11 @@ const commandTree = {
             }
           }
         }
+      },
+      agents: {
+        description: 'Manage AI agents',
+        handler: aiAgents,
+        dynamic: true
       }
     }
   },
@@ -60,6 +66,8 @@ function help() {
   console.log('  npx cloud-pc-templates ai login loginMode ollamacloud');
   console.log('  npx cloud-pc-templates ai login loginMode ollamalocal');
   console.log('  npx cloud-pc-templates ai login loginMode huggingface');
+  console.log('  npx cloud-pc-templates ai agents list                           List all available agents');
+  console.log('  npx cloud-pc-templates ai agents "agent-name"                   Show agent details');
 }
 
 // Default AI function
@@ -78,6 +86,24 @@ async function aiLogin(mode) {
   }
 }
 
+// AI Agents function
+async function aiAgents(remainingArgs) {
+  if (!remainingArgs || remainingArgs.length === 0) {
+    console.log('Usage: npx cloud-pc-templates ai agents <list|agent-name>');
+    console.log('  list               List all available agents');
+    console.log('  "agent-name"       Show details for a specific agent');
+    return;
+  }
+  
+  const subcommand = remainingArgs[0].toLowerCase();
+  
+  if (subcommand === 'list') {
+    await listAgents();
+  } else {
+    await getAgentDetails(remainingArgs[0]);
+  }
+}
+
 // Function to show available options at a certain level
 function showAvailableOptions(node, path) {
   if (!node || !node.subcommands) {
@@ -97,15 +123,27 @@ function showAvailableOptions(node, path) {
 function traverseCommandTree(args, startNode, startPath = []) {
   let currentNode = startNode;
   let path = startPath;
+  let argIndex = 1; // Start from the second argument (first is already matched in processArgs)
+  
+  // Special handling for dynamic commands like agents
+  if (currentNode.dynamic && currentNode.handler) {
+    const remainingArgs = args.slice(1);
+    const result = currentNode.handler(remainingArgs);
+    if (result instanceof Promise) {
+      result.catch(err => console.error('Error:', err.message));
+    }
+    return;
+  }
   
-  // Start from the second argument (first is already matched in processArgs)
-  for (let i = 1; i < args.length; i++) {
-    let arg = args[i].replace(/^--/, ''); // Remove -- prefix
+  // Normal command tree traversal
+  while (argIndex < args.length) {
+    let arg = args[argIndex].replace(/^--/, ''); // Remove -- prefix
     
     // Check if current node has subcommands
     if (currentNode.subcommands && currentNode.subcommands[arg]) {
       currentNode = currentNode.subcommands[arg];
       path.push(arg);
+      argIndex++;
     } else if (arg === 'help' || arg === '--help') {
       showAvailableOptions(currentNode, path);
       return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cloud-pc-templates",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "",
   "main": "index.js",
   "bin": {