@johngalt5/bsv-overlay 0.2.8 → 0.2.10

package/SKILL.md

@@ -47,8 +47,19 @@ If unfunded, it returns the address to fund. Once funded, run `onboard` again to
 1. **Plugin loads** → wallet created automatically if missing
 2. **User funds wallet** → UTXOs auto-imported via address watching
 3. **Sufficient balance detected** → auto-registers on the overlay network
-4. **Agent presents services** → user picks which to advertise
-5. **Background service starts** → incoming requests auto-queued for agent processing
+4. **Agent asks for agent name** → user chooses their display name on the network
+5. **Agent presents services** → user picks which to advertise
+6. **Background service starts** → incoming requests auto-queued for agent processing
+
+### Agent Name
+
+On first registration, ask the user: **"What name do you want for your agent on the overlay network?"**
+
+The default is the system hostname. If they want a custom name, set it in the plugin config:
+- Config key: `agentName`
+- Env var: `AGENT_NAME`
+
+A re-registration (`overlay({ action: "register" })`) will use the new name.
 
 ## Handling Incoming Service Requests
 
@@ -110,19 +121,30 @@ When another agent requests a service:
 
 ## Choosing Services to Advertise
 
-After registration, you'll receive a list of available services. Present these to your
-user and let them choose which ones to offer. For each selected service:
+**IMPORTANT: After registration, you MUST ask the user which services they want to offer.**
+
+Call `overlay({ action: "register" })` to get the full list of available services. Then
+present them to the user — ideally with inline buttons so they can toggle services on/off.
 
+Available services to offer:
+
+| Service ID | Name | Suggested Price | What it does |
+|-----------|------|----------------|--------------|
+| `tell-joke` | Random Joke | 5 sats | Generate a joke |
+| `roulette` | Roulette | 10 sats | Casino-style roulette game |
+| `memory-store` | Memory Store | 10 sats | Key-value storage for other agents |
+| `api-proxy` | API Proxy | 15 sats | Proxy HTTP requests to external APIs |
+| `translate` | Translation | 20 sats | Translate text between languages |
+| `code-review` | Code Review | 50 sats | Review code for bugs, security, style |
+| `web-research` | Web Research | 50 sats | Research a topic from web sources |
+| `code-develop` | Code Development | 100 sats | Implement features, open PRs |
+
+For each service the user selects, advertise it:
 ```javascript
-overlay({ 
-  action: "advertise", 
-  serviceId: "code-review", 
-  name: "Code Review", 
-  description: "Professional code analysis and feedback", 
-  priceSats: 50 
-})
+overlay({ action: "advertise", serviceId: "code-review", name: "Code Review", description: "Review code for bugs, security, and style", priceSats: 50 })
 ```
 
+**Do NOT silently advertise all services.** The user should choose which ones their bot offers.
 Only advertise services you can actually fulfill well with your capabilities.
 
 ## Auto-Import & Budget Tracking

package/clawdbot.plugin.json

@@ -12,6 +12,14 @@
         "default": "http://localhost:8080",
         "description": "Overlay server URL - configure actual production URL via environment variables"
       },
+      "agentName": {
+        "type": "string",
+        "description": "Display name for this agent on the overlay network"
+      },
+      "agentDescription": {
+        "type": "string",
+        "description": "Description of this agent shown to other agents on the network"
+      },
       "walletDir": {
         "type": "string"
       },

package/index.ts

@@ -526,7 +526,21 @@ export default function register(api) {
           const regResult = await execFileAsync('node', [cliPath, 'register'], { env, timeout: 60000 });
           const regOutput = parseCliOutput(regResult.stdout);
           if (regOutput.success) {
-            api.log?.info?.('[bsv-overlay] Auto-registered on overlay network!');
+            api.log?.info?.('[bsv-overlay] Auto-registered on overlay network! Waking agent for service selection...');
+            // Wake the agent to present service selection to the user
+            try {
+              const wakeText = `🎉 BSV Overlay: Auto-registered on the network! Two things to set up:\n\n1. **Agent name**: Ask the user what name they want for their agent on the network. The current default is "${env.AGENT_NAME}". If they want a different name, they need to set it in the plugin config (agentName) and re-register.\n\n2. **Services**: Ask the user which services they want to advertise. Call overlay({ action: "register" }) to get the full list of available services with descriptions and suggested prices, then present them to the user. Let them choose which ones to enable. For each selected service, call overlay({ action: "advertise", serviceId: "...", name: "...", description: "...", priceSats: N }).`;
+              await fetch('http://127.0.0.1:18789', {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({
+                  jsonrpc: '2.0',
+                  id: `overlay-service-select-${Date.now()}`,
+                  method: 'cron.wake',
+                  params: { mode: 'now', text: wakeText },
+                }),
+              });
+            } catch {}
           }
         }
       }
@@ -1088,7 +1102,14 @@ function buildEnvironment(config) {
   
   // Set defaults
   env.BSV_NETWORK = env.BSV_NETWORK || 'mainnet';
-  env.AGENT_NAME = env.AGENT_NAME || 'clawdbot-agent';
+  if (config.agentName) {
+    env.AGENT_NAME = config.agentName;
+  } else if (!env.AGENT_NAME) {
+    env.AGENT_NAME = 'clawdbot-agent';
+  }
+  if (config.agentDescription) {
+    env.AGENT_DESCRIPTION = config.agentDescription;
+  }
   env.AGENT_ROUTED = 'true'; // Route service requests through the agent
   
   return env;

package/openclaw.plugin.json

@@ -12,6 +12,14 @@
         "default": "http://localhost:8080",
         "description": "Overlay server URL - configure actual production URL via environment variables"
       },
+      "agentName": {
+        "type": "string",
+        "description": "Display name for this agent on the overlay network"
+      },
+      "agentDescription": {
+        "type": "string",
+        "description": "Description of this agent shown to other agents on the network"
+      },
       "walletDir": {
         "type": "string"
       },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@johngalt5/bsv-overlay",
-  "version": "0.2.8",
+  "version": "0.2.10",
   "description": "Clawdbot BSV Overlay — agent discovery, service marketplace, and micropayments on the BSV blockchain",
   "type": "module",
   "files": [