@johngalt5/bsv-overlay 0.2.5 → 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 {}
       }
     });
@@ -1027,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.5",
+  "version": "0.2.6",
   "description": "Clawdbot BSV Overlay — agent discovery, service marketplace, and micropayments on the BSV blockchain",
   "type": "module",
   "files": [