@johngalt5/bsv-overlay 0.2.9 → 0.2.11

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
 

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

@@ -157,28 +157,19 @@ function startBackgroundService(env, cliPath, logger) {
           if (event.action === 'queued-for-agent' && event.serviceId) {
             logger?.info?.(`[bsv-overlay] ⚡ Incoming ${event.serviceId} request from ${event.from?.slice(0, 12)}... — waking agent`);
             
-            // Wake the agent via gateway cron.wake RPC (fire-and-forget)
-            const wakeText = `⚡ Incoming overlay service request: ${event.serviceId} from ${event.from?.slice(0, 16)}... (${event.satoshisReceived || '?'} sats paid). Check overlay({ action: "pending-requests" }) for details, fulfill it using your capabilities, then call overlay({ action: "fulfill", requestId: "...", recipientKey: "...", serviceId: "...", result: {...} }).`;
-            (async () => {
-              try {
-                const gatewayUrl = 'http://127.0.0.1:18789';
-                const wakeResp = await fetch(gatewayUrl, {
-                  method: 'POST',
-                  headers: { 'Content-Type': 'application/json' },
-                  body: JSON.stringify({
-                    jsonrpc: '2.0',
-                    id: `overlay-wake-${Date.now()}`,
-                    method: 'cron.wake',
-                    params: { mode: 'now', text: wakeText },
-                  }),
-                });
-                if (wakeResp.ok) {
-                  logger?.info?.('[bsv-overlay] Agent woken for service fulfillment');
-                }
-              } catch (wakeErr: any) {
-                logger?.warn?.('[bsv-overlay] Failed to wake agent:', wakeErr.message);
-              }
-            })();
+            // Write alert file for the cron-based fulfillment checker to pick up
+            const alertDir = path.join(process.env.HOME || '', '.clawdbot', 'bsv-overlay');
+            const alertPath = path.join(alertDir, 'pending-alert.jsonl');
+            try {
+              fs.mkdirSync(alertDir, { recursive: true });
+              fs.appendFileSync(alertPath, JSON.stringify({
+                requestId: event.id,
+                serviceId: event.serviceId,
+                from: event.from,
+                satoshis: event.satoshisReceived,
+                ts: Date.now(),
+              }) + '\n');
+            } catch {}
           }
         } catch {}
       }
@@ -529,7 +520,7 @@ export default function register(api) {
             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! Now 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 }).`;
+              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' },
@@ -1102,7 +1093,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.9",
+  "version": "0.2.11",
   "description": "Clawdbot BSV Overlay — agent discovery, service marketplace, and micropayments on the BSV blockchain",
   "type": "module",
   "files": [