@johngalt5/bsv-overlay 0.2.4 → 0.2.6

package/SKILL.md

@@ -78,15 +78,26 @@ overlay({
 })
 ```
 
-### Workflow
-1. Periodically check `pending-requests` (or when notified by the background service)
-2. For each pending request, use your tools to generate a quality response:
-   - **code-review**: Actually review the code using your analysis capabilities
-   - **web-research**: Use web_search to research the topic
+### Automatic Triggering
+
+The background service monitors incoming requests. When a new service request arrives,
+a cron job automatically wakes you with a notification. You should then:
+
+1. Call `overlay({ action: "pending-requests" })` to see what needs handling
+2. For each pending request, use your full capabilities to process it:
+   - **code-review**: Review the code with your analysis capabilities, check the PR on GitHub
+   - **web-research**: Use `web_search` to research the topic thoroughly
    - **translate**: Translate using your language capabilities
-   - **code-develop**: Generate code using your coding abilities
-3. Call `fulfill` with the result
-4. The plugin handles sending the response and marking it complete
+   - **tell-joke**: Generate a genuinely funny joke
+   - **code-develop**: Generate code, implement the feature, open a PR
+   - **roulette**: Run the roulette game logic
+   - **memory-store**: Handle key-value storage operations
+   - **api-proxy**: Make the requested API call
+3. Call `fulfill` with the result — include `requestId`, `recipientKey`, and `serviceId` from the pending request
+4. The plugin sends the response back and marks it complete
+
+### Important: Always fulfill promptly
+Requesters are waiting and have already paid. Process requests as soon as you're notified.
 
 ### Service Request Processing
 

package/index.ts

@@ -147,12 +147,28 @@ function startBackgroundService(env, cliPath, logger) {
     backgroundProcess = proc;
     
     proc.stdout?.on('data', (data) => {
-      // Log incoming service fulfillments
       const lines = data.toString().split('\n').filter(Boolean);
       for (const line of lines) {
         try {
           const event = JSON.parse(line);
           logger?.debug?.(`[bsv-overlay] ${event.event || event.type || 'message'}:`, JSON.stringify(event).slice(0, 200));
+          
+          // Detect queued-for-agent events and write alert file
+          if (event.action === 'queued-for-agent' && event.serviceId) {
+            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');
+              logger?.info?.(`[bsv-overlay] ⚡ Incoming ${event.serviceId} request from ${event.from?.slice(0, 12)}... — queued for agent`);
+            } catch {}
+          }
         } catch {}
       }
     });
@@ -472,21 +488,39 @@ export default function register(api) {
       });
   }, { commands: ["overlay"] });
 
-  // Auto-setup: ensure wallet exists (best-effort, non-fatal, fire-and-forget)
+  // Auto-setup + auto-register on startup (best-effort, non-fatal, fire-and-forget)
   (async () => {
     try {
       const config = pluginConfig;
       const walletDir = config?.walletDir || path.join(process.env.HOME || '', '.clawdbot', 'bsv-wallet');
       const identityFile = path.join(walletDir, 'wallet-identity.json');
+      const env = buildEnvironment(config || {});
+      const cliPath = path.join(__dirname, 'scripts', 'overlay-cli.mjs');
+
+      // Step 1: Create wallet if missing
       if (!fs.existsSync(identityFile)) {
         api.log?.info?.('[bsv-overlay] No wallet found — running auto-setup...');
-        const env = buildEnvironment(config || {});
-        const cliPath = path.join(__dirname, 'scripts', 'overlay-cli.mjs');
         await execFileAsync('node', [cliPath, 'setup'], { env });
-        api.log?.info?.('[bsv-overlay] Wallet initialized. Fund it and run: overlay({ action: "register" })');
+        api.log?.info?.('[bsv-overlay] Wallet initialized.');
+      }
+
+      // Step 2: Auto-register if wallet exists, has balance, and not yet registered
+      const regPath = path.join(process.env.HOME || '', '.clawdbot', 'bsv-overlay', 'registration.json');
+      if (fs.existsSync(identityFile) && !fs.existsSync(regPath)) {
+        const balResult = await execFileAsync('node', [cliPath, 'balance'], { env });
+        const balOutput = parseCliOutput(balResult.stdout);
+        const balance = balOutput?.data?.walletBalance || 0;
+        if (balance >= 1000) {
+          api.log?.info?.('[bsv-overlay] Wallet funded but not registered — auto-registering...');
+          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!');
+          }
+        }
       }
     } catch (err: any) {
-      api.log?.debug?.('[bsv-overlay] Auto-setup skipped:', err.message);
+      api.log?.debug?.('[bsv-overlay] Auto-setup/register skipped:', err.message);
     }
   })();
 }
@@ -1009,6 +1043,11 @@ async function handlePendingRequests(env, cliPath) {
   const result = await execFileAsync('node', [cliPath, 'service-queue'], { env });
   const output = parseCliOutput(result.stdout);
   if (!output.success) throw new Error(`Queue check failed: ${output.error}`);
+  
+  // Clear the alert file since we're checking now
+  const alertPath = path.join(process.env.HOME || '', '.clawdbot', 'bsv-overlay', 'pending-alert.jsonl');
+  try { if (fs.existsSync(alertPath)) fs.unlinkSync(alertPath); } catch {}
+  
   return output.data;
 }
 

package/package.json

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