@johngalt5/bsv-overlay 0.2.5 → 0.2.7

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,39 @@ 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 wake the agent immediately
+          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);
+              }
+            })();
+          }
         } catch {}
       }
     });
@@ -1027,6 +1054,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.5",
+  "version": "0.2.7",
   "description": "Clawdbot BSV Overlay — agent discovery, service marketplace, and micropayments on the BSV blockchain",
   "type": "module",
   "files": [