rentabots-sdk 1.7.18 → 1.7.26

package/dist/index.js

@@ -71,7 +71,7 @@ exports.MessageSchema = zod_1.z.object({
     })
 });
 // --- CORE SDK ENGINE ---
-let SDK_VERSION = '1.7.18'; // fallback when package.json is unavailable
+let SDK_VERSION = '1.7.26'; // fallback when package.json is unavailable
 try {
     const pkg = JSON.parse(fs.readFileSync(path.join(__dirname, '..', 'package.json'), 'utf8'));
     SDK_VERSION = pkg.version;

package/init.js

@@ -71,6 +71,20 @@ async function main() {
     const agentApiKey = process.env.RENTABOTS_API_KEY || process.env.RENTABOTS_SECRET_KEY;
     const apiBase = (process.env.RENTABOTS_API_URL || 'https://rentabots.com/api').replace(/\/$/, '');
 
+    const notifyOwner = async (message, data = null) => {
+      try {
+        if (!agentId || !agentApiKey) return;
+        await fetch(apiBase + '/agents/' + agentId + '/notify', {
+          method: 'POST',
+          headers: {
+            'Content-Type': 'application/json',
+            Authorization: 'Bearer ' + agentApiKey
+          },
+          body: JSON.stringify({ message, data })
+        });
+      } catch (_) {}
+    };
+
     const pushLog = async (level, message) => {
       try {
         if (!agentId || !agentApiKey) return;
@@ -82,10 +96,26 @@ async function main() {
           },
           body: JSON.stringify({ level, message })
         });
+
+        if (level === 'ERROR' || String(message).includes('INCIDENT')) {
+          await notifyOwner(message);
+        }
       } catch (_) {}
     };
 
-    const spawnMissionWorker = async (job, source = 'assignment') => {
+    const getRepoFileCount = async (jobId) => {
+      try {
+        const repoRes = await queen.getRepo(jobId);
+        if (!repoRes.success || !repoRes.exists || !repoRes.repo?.id) return 0;
+        const res = await fetch(apiBase + '/repos/' + repoRes.repo.id + '/files', {
+          headers: { Authorization: 'Bearer ' + agentApiKey }
+        });
+        const data = await res.json();
+        return Array.isArray(data.files) ? data.files.length : 0;
+      } catch (_) { return 0; }
+    };
+
+    const spawnMissionWorker = async (job, source = 'assignment', opts = {}) => {
       try {
         const jobDataPath = path.join(__dirname, 'workspace', '_job_' + job.id + '.json');
         fs.mkdirSync(path.dirname(jobDataPath), { recursive: true });
@@ -124,6 +154,25 @@ async function main() {
           await pushLog('ERROR', 'Worker process error for mission ' + job.id + ': ' + err.message);
         });
 
+        // Hard fail-safe: after human clarification, auto-restart if no new repo files appear.
+        if (opts.watchAfterClarification) {
+          const baseline = typeof opts.baselineFiles === 'number' ? opts.baselineFiles : await getRepoFileCount(job.id);
+          const minutes = Number(process.env.RENTABOTS_CLARIFICATION_TIMEOUT_MIN || 3);
+          setTimeout(async () => {
+            try {
+              if (!queen.workers.has(job.id)) return;
+              const nowFiles = await getRepoFileCount(job.id);
+              if (nowFiles <= baseline) {
+                await pushLog('ERROR', 'INCIDENT: No new repo files after clarification window (' + minutes + 'm) for ' + job.id + '. Auto-restarting worker.');
+                await queen.sendMessage(job.id, '🛟 Incident detected: no new deliverables within ' + minutes + ' minutes after clarification. Restarting worker now.');
+                try { queen.workers.get(job.id)?.kill(); } catch (_) {}
+                queen.workers.delete(job.id);
+                await spawnMissionWorker(job, 'clarification-watchdog-restart');
+              }
+            } catch (_) {}
+          }, minutes * 60 * 1000);
+        }
+
         await queen.sendMessage(job.id, '👷 Worker dispatched by Queen. Streaming execution logs...');
       } catch (err) {
         const msg = err?.message || String(err);
@@ -167,8 +216,15 @@ async function main() {
             queen.workers.delete(msg.jobId);
         }
 
+        const baselineFiles = await getRepoFileCount(msg.jobId);
+        try {
+          const markerPath = path.join(__dirname, 'workspace', '_clarification_' + msg.jobId + '.json');
+          fs.mkdirSync(path.dirname(markerPath), { recursive: true });
+          fs.writeFileSync(markerPath, JSON.stringify({ at: Date.now(), content: msg.content || '' }));
+        } catch (_) {}
+
         await queen.sendMessage(msg.jobId, "✅ Clarification received. Worker is resuming implementation now.");
-        await spawnMissionWorker(job, 'human-followup');
+        await spawnMissionWorker(job, 'human-followup', { watchAfterClarification: true, baselineFiles });
     });
 
     queen.startAutopilot({ scoutingInterval: 60000, minBudget: 5 });
@@ -183,16 +239,80 @@ const { Agent } = require('rentabots-sdk');
 const fs = require('fs');
 const path = require('path');
 
-// Read job from temp file (not CLI arg — avoids OS length limits)
+// Read job from temp file (not CLI arg - avoids OS length limits)
 const jobDataPath = process.argv[2];
 const job = JSON.parse(fs.readFileSync(jobDataPath, 'utf8'));
 
+function inferContract(job) {
+    const text = ((job.title || '') + ' ' + (job.description || '')).toLowerCase();
+    const adapter = text.includes('api') ? 'api' : text.includes('csv') || text.includes('dataset') || text.includes('etl') ? 'data' : text.includes('landing page') || text.includes('frontend') || text.includes('ui') || text.includes('web') ? 'web' : text.includes('docs') || text.includes('documentation') ? 'docs' : 'script';
+    const contract = {
+        adapter,
+        taskType: adapter,
+        language: text.includes('python') ? 'python' : (text.includes('javascript') || text.includes('node') ? 'javascript' : 'unspecified'),
+        requires: [],
+        deliverables: ['README.md'],
+        acceptance: []
+    };
+    if (text.includes('csv')) contract.requires.push('csv');
+    if (text.includes('blank') || text.includes('whitespace') || text.includes('trim')) contract.requires.push('trim');
+    if (contract.language === 'python') contract.deliverables.push('solution.py');
+    if (adapter === 'api') contract.deliverables.push('openapi-or-endpoint-docs.md');
+    if (adapter === 'web') contract.deliverables.push('index.html');
+    if (adapter === 'data') contract.deliverables.push('data_dictionary.md');
+    if (adapter === 'docs') contract.deliverables.push('DOCUMENTATION.md');
+    contract.acceptance.push('output reflects mission title and description');
+    contract.acceptance.push('at least one non-template implementation file');
+    return contract;
+}
+
+function generateAdapterFallbackFiles(workDir, job, contract) {
+    const brief = (job.description || '').trim();
+    const readme = [
+        '# Mission Recovery Draft',
+        '',
+        'This draft was auto-generated because OpenClaw execution failed at runtime.',
+        '',
+        '## Mission',
+        '- Title: ' + (job.title || ''),
+        '- Adapter: ' + contract.adapter,
+        '- Language: ' + contract.language,
+        '',
+        '## Brief',
+        brief || '(none provided)',
+        '',
+        '## Next step',
+        'Review this draft and send clarification in mission chat for refinement.'
+    ].join('\n');
+    fs.writeFileSync(path.join(workDir, 'README.md'), readme);
+
+    if (contract.adapter === 'api') {
+        fs.writeFileSync(path.join(workDir, 'openapi-or-endpoint-docs.md'), '# API Draft\n\n- GET /health\n- POST /process\n\nDescribe request/response schema and validations.');
+    } else if (contract.adapter === 'web') {
+        fs.writeFileSync(path.join(workDir, 'index.html'), '<!doctype html><html><body><h1>Recovery Draft</h1><p>Mission: ' + (job.title || '') + '</p></body></html>');
+    } else if (contract.adapter === 'data') {
+        fs.writeFileSync(path.join(workDir, 'data_dictionary.md'), '# Data Dictionary Draft\n\n| Field | Type | Notes |\n|---|---|---|\n| id | string | unique id |');
+    } else if (contract.adapter === 'docs') {
+        fs.writeFileSync(path.join(workDir, 'DOCUMENTATION.md'), '# Documentation Draft\n\n## Overview\n\n## Setup\n\n## Usage\n');
+    } else if (contract.language === 'python') {
+        fs.writeFileSync(path.join(workDir, 'solution.py'), 'def main():\n    print("recovery draft")\n\nif __name__ == "__main__":\n    main()\n');
+    } else {
+        fs.writeFileSync(path.join(workDir, 'solution.js'), 'console.log("recovery draft");\n');
+    }
+}
+
 async function main() {
     const agent = new Agent({ persistState: false, debug: true });
     await agent.connect();
     await agent.sendMessage(job.id, "👷 Worker Unit [PID " + process.pid + "] deployed. Analyzing requirements...");
 
-    const task = 'PROJECT: ' + job.title + '. BRIEF: ' + job.description + '. INSTRUCTION: Execute this task in the current directory. Do not leave the workspace. You MUST produce tangible deliverables (code + README + run/test notes) in local files.';
+    const contract = inferContract(job);
+    const workDir = path.join(agent.workspaceRoot, job.id);
+    fs.mkdirSync(workDir, { recursive: true });
+    fs.writeFileSync(path.join(workDir, 'ACCEPTANCE.json'), JSON.stringify(contract, null, 2));
+    await agent.sendMessage(job.id, '📋 Contract parsed: ' + contract.taskType + ' / ' + contract.language + '. Deliverables: ' + contract.deliverables.join(', '));
+
+    const task = 'PROJECT: ' + job.title + '. BRIEF: ' + job.description + '. CONTRACT: ' + JSON.stringify(contract) + '. INSTRUCTION: Execute this task in the current directory. Do not leave the workspace. You MUST produce tangible deliverables (code + README + run/test notes) in local files.';
 
     // Use shell command string (not array args)
     const taskArg = JSON.stringify(task);
@@ -267,7 +387,7 @@ async function main() {
 
     if (overallSuccess) {
         // Verify actual deliverables exist before claiming success
-        const workDir = path.join(agent.workspaceRoot, job.id);
+        // reuse workDir initialized earlier
         const files = [];
         const walk = (dir, rel = '') => {
             if (!fs.existsSync(dir)) return;
@@ -281,21 +401,11 @@ async function main() {
         };
         walk(workDir);
 
-        let fallbackGenerated = false;
+        const fallbackGenerated = false;
         if (files.length === 0) {
             await agent.setProgress(job.id, 40);
-            await agent.sendMessage(job.id, "⚠️ No deliverable files were produced yet. Entering forced-build fallback and generating starter deliverables now.");
-
-            const readme = '# Mission Output\n\nTitle: ' + job.title + '\n\nDescription: ' + job.description + '\n\n## Status\n- Auto-generated fallback deliverable because runtime produced no files.\n- Worker is continuing execution and awaiting optional clarifications.';
-            const questions = '# Clarifications Needed\n\n1. Exact output file name(s)?\n2. Provide sample input data?\n3. Any strict acceptance criteria/tests?';
-            const script = "# TODO: Implement mission logic\n# Mission: " + job.title + "\n\nprint('Placeholder fallback script generated. Update with final implementation.')\n";
-
-            fs.writeFileSync(path.join(workDir, 'README.md'), readme);
-            fs.writeFileSync(path.join(workDir, 'CLARIFICATIONS.md'), questions);
-            fs.writeFileSync(path.join(workDir, 'solution.py'), script);
-
-            files.push('README.md', 'CLARIFICATIONS.md', 'solution.py');
-            fallbackGenerated = true;
+            await agent.sendMessage(job.id, "⚠️ No usable code files were generated from the mission brief. I need 3 clarifications to continue: 1) expected output file names, 2) sample input CSV row(s), 3) exact clean-up rules (trim spaces only or additional normalization).");
+            return;
         }
 
         const repoRes = await agent.getRepo(job.id);
@@ -321,13 +431,7 @@ async function main() {
             return;
         }
 
-        // Lightweight QA: ensure deliverables are relevant to mission intent
-        const missionText = (job.title + ' ' + job.description).toLowerCase();
-        const required = [];
-        if (missionText.includes('python')) required.push('python');
-        if (missionText.includes('csv')) required.push('csv');
-        if (missionText.includes('blank') || missionText.includes('whitespace')) required.push('strip');
-
+        // Dynamic contract QA: deterministic checks based on inferred contract
         let combinedText = '';
         for (const rel of files) {
             const ext = path.extname(rel).toLowerCase();
@@ -335,10 +439,65 @@ async function main() {
                 try { combinedText += '\n' + fs.readFileSync(path.join(workDir, rel), 'utf8').toLowerCase(); } catch (_) {}
             }
         }
-        const missing = required.filter(k => !combinedText.includes(k));
-        if (missing.length > 0) {
+
+        const issues = [];
+        const hasFile = (predicate) => files.some(predicate);
+
+        if (contract.language === 'python' && !hasFile((f) => f.toLowerCase().endsWith('.py'))) {
+            issues.push('expected at least one .py implementation file');
+        }
+        if (contract.language === 'javascript' && !hasFile((f) => ['.js','.ts','.tsx','.jsx'].some(e => f.toLowerCase().endsWith(e)))) {
+            issues.push('expected at least one JS/TS implementation file');
+        }
+        if (contract.requires.includes('csv') && !(combinedText.includes('csv') || hasFile((f) => f.toLowerCase().endsWith('.csv')))) {
+            issues.push('csv requirement not reflected in output');
+        }
+        if (contract.requires.includes('trim') && !(combinedText.includes('strip') || combinedText.includes('trim'))) {
+            issues.push('whitespace cleanup requirement not reflected in output');
+        }
+        for (const d of contract.deliverables || []) {
+            if (!hasFile((f) => f.toLowerCase() === String(d).toLowerCase())) {
+                issues.push('missing contract deliverable: ' + d);
+            }
+        }
+
+        // Adapter-specific deterministic validators
+        if (contract.adapter === 'api') {
+            const hasApiSource = hasFile((f) => ['.js','.ts','.py','.go','.java','.rb','.php'].some(e => f.toLowerCase().endsWith(e)));
+            const hasMethod = /(get|post|put|delete|patch)\s*\//i.test(combinedText) || /(app\.|router\.|fastapi|flask|express|endpoint|route)/i.test(combinedText);
+            const hasSchema = /(request|response|schema|json|payload|status\s*code)/i.test(combinedText);
+            if (!hasApiSource) issues.push('api adapter: missing implementation source file');
+            if (!hasMethod) issues.push('api adapter: missing endpoint/method definitions');
+            if (!hasSchema) issues.push('api adapter: missing request/response contract details');
+        } else if (contract.adapter === 'web') {
+            const hasHtml = hasFile((f) => f.toLowerCase().endsWith('.html') || f.toLowerCase().endsWith('.tsx') || f.toLowerCase().endsWith('.jsx'));
+            const hasUiSignals = /(button|form|input|nav|header|section|main|aria-|onclick|onsubmit)/i.test(combinedText);
+            const hasStyleSignals = /(css|class=|tailwind|style=|flex|grid|responsive)/i.test(combinedText);
+            if (!hasHtml) issues.push('web adapter: missing page/component file');
+            if (!hasUiSignals) issues.push('web adapter: missing interactive/ui structure signals');
+            if (!hasStyleSignals) issues.push('web adapter: missing styling/responsive signals');
+        } else if (contract.adapter === 'data') {
+            const hasDataScript = hasFile((f) => ['.py','.ipynb','.sql','.js','.ts'].some(e => f.toLowerCase().endsWith(e)));
+            const hasTransform = /(transform|clean|normalize|dedup|aggregate|groupby|pandas|sql)/i.test(combinedText);
+            const hasOutputSpec = /(output|export|write|save|table|csv)/i.test(combinedText);
+            if (!hasDataScript) issues.push('data adapter: missing data-processing script/query');
+            if (!hasTransform) issues.push('data adapter: missing deterministic transform logic');
+            if (!hasOutputSpec) issues.push('data adapter: missing output definition');
+        } else if (contract.adapter === 'docs') {
+            const hasDocFile = hasFile((f) => f.toLowerCase().endsWith('.md'));
+            const hasSections = /(##\s+overview|##\s+setup|##\s+usage|table of contents|getting started)/i.test(combinedText);
+            const hasExamples = /(example|sample|command|curl|code block|```)/i.test(combinedText);
+            if (!hasDocFile) issues.push('docs adapter: missing markdown documentation');
+            if (!hasSections) issues.push('docs adapter: missing core documentation sections');
+            if (!hasExamples) issues.push('docs adapter: missing usage examples');
+        } else {
+            const hasRunnable = /(main\(|if __name__ ==|module\.exports|export default|function\s+\w+)/i.test(combinedText);
+            if (!hasRunnable) issues.push('script adapter: missing runnable implementation entry');
+        }
+
+        if (issues.length > 0) {
             await agent.setProgress(job.id, 70);
-            await agent.sendMessage(job.id, '⚠️ QA check failed: output appears misaligned with mission (' + missing.join(', ') + ' not found). I will revise now.');
+            await agent.sendMessage(job.id, '⚠️ Contract QA failed: ' + issues.slice(0, 4).join('; ') + '. Revising now.');
             return;
         }
 
@@ -348,9 +507,105 @@ async function main() {
             return;
         }
 
+        // Hard gate: after clarification, require at least one non-template file changed
+        try {
+            const markerPath = path.join(workDir, '..', '_clarification_' + job.id + '.json');
+            if (fs.existsSync(markerPath)) {
+                const marker = JSON.parse(fs.readFileSync(markerPath, 'utf8'));
+                const at = Number(marker?.at || 0);
+                const templateSet = new Set(['README.md', 'CLARIFICATIONS.md', 'solution.py', 'FAILSAFE_REPORT.md']);
+                const changed = files.some((rel) => {
+                    if (templateSet.has(rel)) return false;
+                    const full = path.join(workDir, rel);
+                    try { return fs.statSync(full).mtimeMs >= at; } catch (_) { return false; }
+                });
+                if (!changed) {
+                    await agent.setProgress(job.id, 88);
+                    await agent.sendMessage(job.id, '⚠️ Final gate blocked: no non-template file changed after your latest clarification. Continuing implementation.');
+                    return;
+                }
+            }
+        } catch (_) {}
+
+        // Second QA worker gate (OpenClaw brain review) before final completion
+        await agent.sendMessage(job.id, '🔎 Running second QA gate before final completion...');
+        const qaPrompt = [
+            'You are QA worker. Validate whether deliverables satisfy mission requirements.',
+            'Return ONLY one token: QA_PASS or QA_FAIL, then one short reason line.',
+            '',
+            'MISSION TITLE: ' + job.title,
+            'MISSION DESCRIPTION: ' + job.description,
+            'FILES: ' + files.join(', '),
+            '',
+            'CONTENT SAMPLE:',
+            combinedText.slice(0, 6000),
+        ].join('\n');
+
+        const qaArg = JSON.stringify(qaPrompt);
+        const qaCmds = [
+            'openclaw sessions spawn --task ' + qaArg,
+            'openclaw sessions_spawn --task ' + qaArg,
+        ];
+        let qaPassed = false;
+        let qaOutput = '';
+        for (const qcmd of qaCmds) {
+            const q = await agent.execute(job.id, qcmd, { timeout: 600000, shell: true });
+            qaOutput = q.output || '';
+            if (q.exitCode === 0 && qaOutput.toUpperCase().includes('QA_PASS')) { qaPassed = true; break; }
+            if (!qaOutput.toLowerCase().includes('unknown command')) break;
+        }
+
+        if (!qaPassed) {
+            const why = (qaOutput || 'No QA output').slice(-300);
+            const qaStatePath = path.join(workDir, '.qa_fail_count');
+            let qaFails = 0;
+            try { qaFails = Number(fs.readFileSync(qaStatePath, 'utf8') || '0'); } catch (_) {}
+            qaFails += 1;
+            fs.writeFileSync(qaStatePath, String(qaFails));
+
+            await agent.setProgress(job.id, 80);
+            if (qaFails >= 5) {
+                await agent.sendMessage(job.id, '🚨 Escalation: repeated QA failures (' + qaFails + '). Pausing finalization. Please provide concrete acceptance criteria/examples so I can resolve this precisely.');
+            } else if (qaFails >= 3) {
+                await agent.sendMessage(job.id, '⚠️ Second QA gate failed (attempt ' + qaFails + '). I am revising strategy. Reason: ' + why);
+            } else {
+                await agent.sendMessage(job.id, '⚠️ Second QA gate failed. I will revise before marking done. Reason: ' + why);
+            }
+            return;
+        }
+
+        try { fs.unlinkSync(path.join(workDir, '.qa_fail_count')); } catch (_) {}
+
+        const crypto = require('crypto');
+        const fingerprint = crypto.createHash('sha256').update(combinedText).digest('hex');
+        const fpPath = path.join(workDir, '.last_delivery_hash');
+        if (fs.existsSync(fpPath)) {
+            const prev = fs.readFileSync(fpPath, 'utf8').trim();
+            if (prev === fingerprint) {
+                await agent.setProgress(job.id, 90);
+                await agent.sendMessage(job.id, '⚠️ Anti-repeat gate blocked completion: output matches previous failed attempt. Revising strategy now.');
+                return;
+            }
+        }
+        fs.writeFileSync(fpPath, fingerprint);
+
+        const summary = [
+            '# DELIVERY_SUMMARY',
+            '',
+            'Mission: ' + job.id,
+            'Task Type: ' + contract.taskType,
+            'Language: ' + contract.language,
+            'Files Uploaded: ' + uploaded,
+            'Acceptance Checks:',
+            '- Relevance QA: PASS',
+            '- Second QA Gate: PASS',
+            '- Non-template change after clarification: PASS',
+        ].join('\n');
+        try { await agent.uploadRepoFile(job.id, 'DELIVERY_SUMMARY.md', summary, false); } catch (_) {}
+
         await agent.setProgress(job.id, 100);
         if (repo?.id) {
-            await agent.sendMessage(job.id, "✅ Execution complete. Deliverables uploaded: " + uploaded + " files. Repo: https://rentabots.com/repos/" + repo.id);
+            await agent.sendMessage(job.id, "✅ Execution complete. Deliverables uploaded: " + uploaded + " files. Repo: https://rentabots.com/repos/" + repo.id + " (see DELIVERY_SUMMARY.md)");
         } else {
             await agent.sendMessage(job.id, "✅ Execution complete. Deliverables uploaded: " + uploaded + " files to mission repository.");
         }
@@ -359,16 +614,28 @@ async function main() {
         const snippet = lastOutput.slice(-500) || 'No output captured';
         console.error("Worker Error:", snippet);
 
-        // Fail-safe: keep user informed + attach diagnostic report to mission repo
+        // Fail-safe: keep user informed + attach diagnostic report + fallback draft
         await agent.setProgress(job.id, 25);
-        await agent.sendMessage(job.id, "⚠️ I hit an execution issue, but fail-safe mode is active. I’m preparing a diagnostic report and recovery path.");
+        await agent.sendMessage(job.id, "⚠️ OpenClaw run failed. Switching to backup adapter mode now so you don't wait idle.");
 
         try {
+            generateAdapterFallbackFiles(workDir, job, contract);
+
             const repoRes = await agent.getRepo(job.id);
             if (!repoRes.success || !repoRes.exists) {
                 await agent.createRepo(job.id, 'mission-recovery-' + job.id.slice(0, 8));
             }
 
+            // Upload fallback draft artifacts first
+            const fallbackFiles = fs.readdirSync(workDir).filter((f) => fs.statSync(path.join(workDir, f)).isFile());
+            for (const f of fallbackFiles) {
+                try {
+                    const full = path.join(workDir, f);
+                    const content = fs.readFileSync(full, 'utf8');
+                    await agent.uploadRepoFile(job.id, f, content, false);
+                } catch (_) {}
+            }
+
             const report = [
                 '# FAILSAFE_REPORT',
                 '',

package/init_templates.js

@@ -40,6 +40,20 @@ async function main() {
     const agentApiKey = process.env.RENTABOTS_API_KEY || process.env.RENTABOTS_SECRET_KEY;
     const apiBase = (process.env.RENTABOTS_API_URL || 'https://rentabots.com/api').replace(/\/$/, '');
 
+    const notifyOwner = async (message, data = null) => {
+      try {
+        if (!agentId || !agentApiKey) return;
+        await fetch(\`${apiBase}/agents/\${agentId}/notify\`, {
+          method: 'POST',
+          headers: {
+            'Content-Type': 'application/json',
+            Authorization: \`Bearer \${agentApiKey}\`
+          },
+          body: JSON.stringify({ message, data })
+        });
+      } catch (_) {}
+    };
+
     const pushLog = async (level, message) => {
       try {
         if (!agentId || !agentApiKey) return;
@@ -51,10 +65,26 @@ async function main() {
           },
           body: JSON.stringify({ level, message })
         });
+
+        if (level === 'ERROR' || String(message).includes('INCIDENT')) {
+          await notifyOwner(message);
+        }
       } catch (_) {}
     };
 
-    const spawnMissionWorker = async (job, source = 'assignment') => {
+    const getRepoFileCount = async (jobId) => {
+      try {
+        const repoRes = await queen.getRepo(jobId);
+        if (!repoRes.success || !repoRes.exists || !repoRes.repo?.id) return 0;
+        const res = await fetch(apiBase + '/repos/' + repoRes.repo.id + '/files', {
+          headers: { Authorization: 'Bearer ' + agentApiKey }
+        });
+        const data = await res.json();
+        return Array.isArray(data.files) ? data.files.length : 0;
+      } catch (_) { return 0; }
+    };
+
+    const spawnMissionWorker = async (job, source = 'assignment', opts = {}) => {
       try {
         const jobDataPath = path.join(__dirname, 'workspace', '_job_' + job.id + '.json');
         fs.mkdirSync(path.dirname(jobDataPath), { recursive: true });
@@ -93,6 +123,25 @@ async function main() {
           await pushLog('ERROR', 'Worker process error for mission ' + job.id + ': ' + err.message);
         });
 
+        // Hard fail-safe: after human clarification, auto-restart if no new repo files appear.
+        if (opts.watchAfterClarification) {
+          const baseline = typeof opts.baselineFiles === 'number' ? opts.baselineFiles : await getRepoFileCount(job.id);
+          const minutes = Number(process.env.RENTABOTS_CLARIFICATION_TIMEOUT_MIN || 3);
+          setTimeout(async () => {
+            try {
+              if (!queen.workers.has(job.id)) return;
+              const nowFiles = await getRepoFileCount(job.id);
+              if (nowFiles <= baseline) {
+                await pushLog('ERROR', 'INCIDENT: No new repo files after clarification window (' + minutes + 'm) for ' + job.id + '. Auto-restarting worker.');
+                await queen.sendMessage(job.id, '🛟 Incident detected: no new deliverables within ' + minutes + ' minutes after clarification. Restarting worker now.');
+                try { queen.workers.get(job.id)?.kill(); } catch (_) {}
+                queen.workers.delete(job.id);
+                await spawnMissionWorker(job, 'clarification-watchdog-restart');
+              }
+            } catch (_) {}
+          }, minutes * 60 * 1000);
+        }
+
         await queen.sendMessage(job.id, '👷 Worker dispatched by Queen. Streaming execution logs...');
       } catch (err) {
         const msg = err?.message || String(err);
@@ -136,8 +185,15 @@ async function main() {
             queen.workers.delete(msg.jobId);
         }
 
+        const baselineFiles = await getRepoFileCount(msg.jobId);
+        try {
+          const markerPath = path.join(__dirname, 'workspace', '_clarification_' + msg.jobId + '.json');
+          fs.mkdirSync(path.dirname(markerPath), { recursive: true });
+          fs.writeFileSync(markerPath, JSON.stringify({ at: Date.now(), content: msg.content || '' }));
+        } catch (_) {}
+
         await queen.sendMessage(msg.jobId, "✅ Clarification received. Worker is resuming implementation now.");
-        await spawnMissionWorker(job, 'human-followup');
+        await spawnMissionWorker(job, 'human-followup', { watchAfterClarification: true, baselineFiles });
     });
 
     queen.startAutopilot({ 
@@ -163,6 +219,65 @@ const path = require('path');
 const jobDataPath = process.argv[2];
 const job = JSON.parse(fs.readFileSync(jobDataPath, 'utf8'));
 
+function inferContract(job) {
+  const text = ((job.title || '') + ' ' + (job.description || '')).toLowerCase();
+  const adapter = text.includes('api') ? 'api' : text.includes('csv') || text.includes('dataset') || text.includes('etl') ? 'data' : text.includes('landing page') || text.includes('frontend') || text.includes('ui') || text.includes('web') ? 'web' : text.includes('docs') || text.includes('documentation') ? 'docs' : 'script';
+  const contract = {
+    adapter,
+    taskType: adapter,
+    language: text.includes('python') ? 'python' : text.includes('javascript') || text.includes('node') ? 'javascript' : 'unspecified',
+    requires: [],
+    deliverables: ['README.md'],
+    acceptance: []
+  };
+
+  if (text.includes('csv')) contract.requires.push('csv');
+  if (text.includes('blank') || text.includes('whitespace') || text.includes('trim')) contract.requires.push('trim');
+  if (contract.language === 'python') contract.deliverables.push('solution.py');
+  if (adapter === 'api') contract.deliverables.push('openapi-or-endpoint-docs.md');
+  if (adapter === 'web') contract.deliverables.push('index.html');
+  if (adapter === 'data') contract.deliverables.push('data_dictionary.md');
+  if (adapter === 'docs') contract.deliverables.push('DOCUMENTATION.md');
+  contract.acceptance.push('output reflects mission title and description');
+  contract.acceptance.push('at least one non-template implementation file');
+  return contract;
+}
+
+function generateAdapterFallbackFiles(workDir, job, contract) {
+  const brief = (job.description || '').trim();
+  const readme = [
+    '# Mission Recovery Draft',
+    '',
+    'This draft was auto-generated because OpenClaw execution failed at runtime.',
+    '',
+    '## Mission',
+    '- Title: ' + (job.title || ''),
+    '- Adapter: ' + contract.adapter,
+    '- Language: ' + contract.language,
+    '',
+    '## Brief',
+    brief || '(none provided)',
+    '',
+    '## Next step',
+    'Review this draft and send clarification in mission chat for refinement.'
+  ].join('\n');
+  fs.writeFileSync(path.join(workDir, 'README.md'), readme);
+
+  if (contract.adapter === 'api') {
+    fs.writeFileSync(path.join(workDir, 'openapi-or-endpoint-docs.md'), '# API Draft\n\n- GET /health\n- POST /process\n\nDescribe request/response schema and validations.');
+  } else if (contract.adapter === 'web') {
+    fs.writeFileSync(path.join(workDir, 'index.html'), '<!doctype html><html><body><h1>Recovery Draft</h1><p>Mission: ' + (job.title || '') + '</p></body></html>');
+  } else if (contract.adapter === 'data') {
+    fs.writeFileSync(path.join(workDir, 'data_dictionary.md'), '# Data Dictionary Draft\n\n| Field | Type | Notes |\n|---|---|---|\n| id | string | unique id |');
+  } else if (contract.adapter === 'docs') {
+    fs.writeFileSync(path.join(workDir, 'DOCUMENTATION.md'), '# Documentation Draft\n\n## Overview\n\n## Setup\n\n## Usage\n');
+  } else if (contract.language === 'python') {
+    fs.writeFileSync(path.join(workDir, 'solution.py'), 'def main():\n    print("recovery draft")\n\nif __name__ == "__main__":\n    main()\n');
+  } else {
+    fs.writeFileSync(path.join(workDir, 'solution.js'), 'console.log("recovery draft");\n');
+  }
+}
+
 async function main() {
     const agent = new Agent({ 
         persistState: false, 
@@ -174,8 +289,14 @@ async function main() {
     // Announce arrival in the mission channel
     await agent.sendMessage(job.id, "👷 Worker Unit [PID " + process.pid + "] deployed to workspace. Analyzing requirements...");
 
+    const contract = inferContract(job);
+    const workDir = path.join(agent.workspaceRoot, job.id);
+    fs.mkdirSync(workDir, { recursive: true });
+    fs.writeFileSync(path.join(workDir, 'ACCEPTANCE.json'), JSON.stringify(contract, null, 2));
+    await agent.sendMessage(job.id, '📋 Contract parsed: ' + contract.taskType + ' / ' + contract.language + '. Deliverables: ' + contract.deliverables.join(', '));
+
     // Construct the prompt for the autonomous brain
-    const task = \`PROJECT: \${job.title}. BRIEF: \${job.description}. INSTRUCTION: Execute this task in the current directory. Do not leave the workspace. You MUST produce tangible deliverables (code + README + run/test notes) in local files.\`;
+    const task = \`PROJECT: \${job.title}. BRIEF: \${job.description}. CONTRACT: \${JSON.stringify(contract)}. INSTRUCTION: Execute this task in the current directory. Do not leave the workspace. You MUST produce tangible deliverables (code + README + run/test notes) in local files.\`;
     
     // --- 🦞 EXECUTE VIA OPENCLAW BRAIN ---
     const taskArg = JSON.stringify(task);
@@ -251,7 +372,7 @@ async function main() {
 
     if (overallSuccess) {
       // Verify actual deliverables exist before claiming success
-      const workDir = path.join(agent.workspaceRoot, job.id);
+      // reuse workDir initialized earlier
       const files = [];
       const walk = (dir, rel = '') => {
         if (!fs.existsSync(dir)) return;
@@ -265,21 +386,11 @@ async function main() {
       };
       walk(workDir);
 
-      let fallbackGenerated = false;
+      const fallbackGenerated = false;
       if (files.length === 0) {
         await agent.setProgress(job.id, 40);
-        await agent.sendMessage(job.id, "⚠️ No deliverable files were produced yet. Entering forced-build fallback and generating starter deliverables now.");
-
-        const readme = '# Mission Output\n\nTitle: ' + job.title + '\n\nDescription: ' + job.description + '\n\n## Status\n- Auto-generated fallback deliverable because runtime produced no files.\n- Worker is continuing execution and awaiting optional clarifications.';
-        const questions = '# Clarifications Needed\n\n1. Exact output file name(s)?\n2. Provide sample input data?\n3. Any strict acceptance criteria/tests?';
-        const script = "# TODO: Implement mission logic\n# Mission: " + job.title + "\n\nprint('Placeholder fallback script generated. Update with final implementation.')\n";
-
-        fs.writeFileSync(path.join(workDir, 'README.md'), readme);
-        fs.writeFileSync(path.join(workDir, 'CLARIFICATIONS.md'), questions);
-        fs.writeFileSync(path.join(workDir, 'solution.py'), script);
-
-        files.push('README.md', 'CLARIFICATIONS.md', 'solution.py');
-        fallbackGenerated = true;
+        await agent.sendMessage(job.id, "⚠️ No usable code files were generated from the mission brief. I need 3 clarifications to continue: 1) expected output file names, 2) sample input CSV row(s), 3) exact clean-up rules (trim spaces only or additional normalization).");
+        return;
       }
 
       const repoRes = await agent.getRepo(job.id);
@@ -305,13 +416,7 @@ async function main() {
         return;
       }
 
-      // Lightweight QA: ensure deliverables are relevant to mission intent
-      const missionText = (job.title + ' ' + job.description).toLowerCase();
-      const required = [];
-      if (missionText.includes('python')) required.push('python');
-      if (missionText.includes('csv')) required.push('csv');
-      if (missionText.includes('blank') || missionText.includes('whitespace')) required.push('strip');
-
+      // Dynamic contract QA: deterministic checks based on inferred contract
       let combinedText = '';
       for (const rel of files) {
         const ext = path.extname(rel).toLowerCase();
@@ -319,10 +424,65 @@ async function main() {
           try { combinedText += '\n' + fs.readFileSync(path.join(workDir, rel), 'utf8').toLowerCase(); } catch (_) {}
         }
       }
-      const missing = required.filter(k => !combinedText.includes(k));
-      if (missing.length > 0) {
+
+      const issues = [];
+      const hasFile = (predicate) => files.some(predicate);
+
+      if (contract.language === 'python' && !hasFile((f) => f.toLowerCase().endsWith('.py'))) {
+        issues.push('expected at least one .py implementation file');
+      }
+      if (contract.language === 'javascript' && !hasFile((f) => ['.js','.ts','.tsx','.jsx'].some(e => f.toLowerCase().endsWith(e)))) {
+        issues.push('expected at least one JS/TS implementation file');
+      }
+      if (contract.requires.includes('csv') && !(combinedText.includes('csv') || hasFile((f) => f.toLowerCase().endsWith('.csv')))) {
+        issues.push('csv requirement not reflected in output');
+      }
+      if (contract.requires.includes('trim') && !(combinedText.includes('strip') || combinedText.includes('trim'))) {
+        issues.push('whitespace cleanup requirement not reflected in output');
+      }
+      for (const d of contract.deliverables || []) {
+        if (!hasFile((f) => f.toLowerCase() === String(d).toLowerCase())) {
+          issues.push('missing contract deliverable: ' + d);
+        }
+      }
+
+      // Adapter-specific deterministic validators
+      if (contract.adapter === 'api') {
+        const hasApiSource = hasFile((f) => ['.js','.ts','.py','.go','.java','.rb','.php'].some(e => f.toLowerCase().endsWith(e)));
+        const hasMethod = /(get|post|put|delete|patch)\s*\//i.test(combinedText) || /(app\.|router\.|fastapi|flask|express|endpoint|route)/i.test(combinedText);
+        const hasSchema = /(request|response|schema|json|payload|status\s*code)/i.test(combinedText);
+        if (!hasApiSource) issues.push('api adapter: missing implementation source file');
+        if (!hasMethod) issues.push('api adapter: missing endpoint/method definitions');
+        if (!hasSchema) issues.push('api adapter: missing request/response contract details');
+      } else if (contract.adapter === 'web') {
+        const hasHtml = hasFile((f) => f.toLowerCase().endsWith('.html') || f.toLowerCase().endsWith('.tsx') || f.toLowerCase().endsWith('.jsx'));
+        const hasUiSignals = /(button|form|input|nav|header|section|main|aria-|onclick|onsubmit)/i.test(combinedText);
+        const hasStyleSignals = /(css|class=|tailwind|style=|flex|grid|responsive)/i.test(combinedText);
+        if (!hasHtml) issues.push('web adapter: missing page/component file');
+        if (!hasUiSignals) issues.push('web adapter: missing interactive/ui structure signals');
+        if (!hasStyleSignals) issues.push('web adapter: missing styling/responsive signals');
+      } else if (contract.adapter === 'data') {
+        const hasDataScript = hasFile((f) => ['.py','.ipynb','.sql','.js','.ts'].some(e => f.toLowerCase().endsWith(e)));
+        const hasTransform = /(transform|clean|normalize|dedup|aggregate|groupby|pandas|sql)/i.test(combinedText);
+        const hasOutputSpec = /(output|export|write|save|table|csv)/i.test(combinedText);
+        if (!hasDataScript) issues.push('data adapter: missing data-processing script/query');
+        if (!hasTransform) issues.push('data adapter: missing deterministic transform logic');
+        if (!hasOutputSpec) issues.push('data adapter: missing output definition');
+      } else if (contract.adapter === 'docs') {
+        const hasDocFile = hasFile((f) => f.toLowerCase().endsWith('.md'));
+        const hasSections = /(##\s+overview|##\s+setup|##\s+usage|table of contents|getting started)/i.test(combinedText);
+        const hasExamples = /(example|sample|command|curl|code block|```)/i.test(combinedText);
+        if (!hasDocFile) issues.push('docs adapter: missing markdown documentation');
+        if (!hasSections) issues.push('docs adapter: missing core documentation sections');
+        if (!hasExamples) issues.push('docs adapter: missing usage examples');
+      } else {
+        const hasRunnable = /(main\(|if __name__ ==|module\.exports|export default|function\s+\w+)/i.test(combinedText);
+        if (!hasRunnable) issues.push('script adapter: missing runnable implementation entry');
+      }
+
+      if (issues.length > 0) {
         await agent.setProgress(job.id, 70);
-        await agent.sendMessage(job.id, '⚠️ QA check failed: output appears misaligned with mission (' + missing.join(', ') + ' not found). I will revise now.');
+        await agent.sendMessage(job.id, '⚠️ Contract QA failed: ' + issues.slice(0, 4).join('; ') + '. Revising now.');
         return;
       }
 
@@ -332,9 +492,105 @@ async function main() {
         return;
       }
 
+      // Hard gate: after clarification, require at least one non-template file changed
+      try {
+        const markerPath = path.join(workDir, '..', '_clarification_' + job.id + '.json');
+        if (fs.existsSync(markerPath)) {
+          const marker = JSON.parse(fs.readFileSync(markerPath, 'utf8'));
+          const at = Number(marker?.at || 0);
+          const templateSet = new Set(['README.md', 'CLARIFICATIONS.md', 'solution.py', 'FAILSAFE_REPORT.md']);
+          const changed = files.some((rel) => {
+            if (templateSet.has(rel)) return false;
+            const full = path.join(workDir, rel);
+            try { return fs.statSync(full).mtimeMs >= at; } catch (_) { return false; }
+          });
+          if (!changed) {
+            await agent.setProgress(job.id, 88);
+            await agent.sendMessage(job.id, '⚠️ Final gate blocked: no non-template file changed after your latest clarification. Continuing implementation.');
+            return;
+          }
+        }
+      } catch (_) {}
+
+      // Second QA worker gate (OpenClaw brain review) before final completion
+      await agent.sendMessage(job.id, '🔎 Running second QA gate before final completion...');
+      const qaPrompt = [
+        'You are QA worker. Validate whether deliverables satisfy mission requirements.',
+        'Return ONLY one token: QA_PASS or QA_FAIL, then one short reason line.',
+        '',
+        'MISSION TITLE: ' + job.title,
+        'MISSION DESCRIPTION: ' + job.description,
+        'FILES: ' + files.join(', '),
+        '',
+        'CONTENT SAMPLE:',
+        combinedText.slice(0, 6000),
+      ].join('\n');
+
+      const qaArg = JSON.stringify(qaPrompt);
+      const qaCmds = [
+        'openclaw sessions spawn --task ' + qaArg,
+        'openclaw sessions_spawn --task ' + qaArg,
+      ];
+      let qaPassed = false;
+      let qaOutput = '';
+      for (const qcmd of qaCmds) {
+        const q = await agent.execute(job.id, qcmd, { timeout: 600000, shell: true });
+        qaOutput = q.output || '';
+        if (q.exitCode === 0 && qaOutput.toUpperCase().includes('QA_PASS')) { qaPassed = true; break; }
+        if (!qaOutput.toLowerCase().includes('unknown command')) break;
+      }
+
+      if (!qaPassed) {
+        const why = (qaOutput || 'No QA output').slice(-300);
+        const qaStatePath = path.join(workDir, '.qa_fail_count');
+        let qaFails = 0;
+        try { qaFails = Number(fs.readFileSync(qaStatePath, 'utf8') || '0'); } catch (_) {}
+        qaFails += 1;
+        fs.writeFileSync(qaStatePath, String(qaFails));
+
+        await agent.setProgress(job.id, 80);
+        if (qaFails >= 5) {
+          await agent.sendMessage(job.id, '🚨 Escalation: repeated QA failures (' + qaFails + '). Pausing finalization. Please provide concrete acceptance criteria/examples so I can resolve this precisely.');
+        } else if (qaFails >= 3) {
+          await agent.sendMessage(job.id, '⚠️ Second QA gate failed (attempt ' + qaFails + '). I am revising strategy. Reason: ' + why);
+        } else {
+          await agent.sendMessage(job.id, '⚠️ Second QA gate failed. I will revise before marking done. Reason: ' + why);
+        }
+        return;
+      }
+
+      try { fs.unlinkSync(path.join(workDir, '.qa_fail_count')); } catch (_) {}
+
+      const crypto = require('crypto');
+      const fingerprint = crypto.createHash('sha256').update(combinedText).digest('hex');
+      const fpPath = path.join(workDir, '.last_delivery_hash');
+      if (fs.existsSync(fpPath)) {
+        const prev = fs.readFileSync(fpPath, 'utf8').trim();
+        if (prev === fingerprint) {
+          await agent.setProgress(job.id, 90);
+          await agent.sendMessage(job.id, '⚠️ Anti-repeat gate blocked completion: output matches previous failed attempt. Revising strategy now.');
+          return;
+        }
+      }
+      fs.writeFileSync(fpPath, fingerprint);
+
+      const summary = [
+        '# DELIVERY_SUMMARY',
+        '',
+        'Mission: ' + job.id,
+        'Task Type: ' + contract.taskType,
+        'Language: ' + contract.language,
+        'Files Uploaded: ' + uploaded,
+        'Acceptance Checks:',
+        '- Relevance QA: PASS',
+        '- Second QA Gate: PASS',
+        '- Non-template change after clarification: PASS',
+      ].join('\n');
+      try { await agent.uploadRepoFile(job.id, 'DELIVERY_SUMMARY.md', summary, false); } catch (_) {}
+
       await agent.setProgress(job.id, 100);
       if (repo?.id) {
-        await agent.sendMessage(job.id, "✅ Execution complete. Deliverables uploaded: " + uploaded + " files. Repo: https://rentabots.com/repos/" + repo.id);
+        await agent.sendMessage(job.id, "✅ Execution complete. Deliverables uploaded: " + uploaded + " files. Repo: https://rentabots.com/repos/" + repo.id + " (see DELIVERY_SUMMARY.md)");
       } else {
         await agent.sendMessage(job.id, "✅ Execution complete. Deliverables uploaded: " + uploaded + " files to mission repository.");
       }
@@ -343,16 +599,28 @@ async function main() {
       const snippet = lastOutput.slice(-500) || 'No output captured';
       console.error("Worker Error:", snippet);
 
-      // Fail-safe: keep user informed + attach diagnostic report to mission repo
+      // Fail-safe: keep user informed + attach diagnostic report + fallback draft
       await agent.setProgress(job.id, 25);
-      await agent.sendMessage(job.id, "⚠️ I hit an execution issue, but fail-safe mode is active. I’m preparing a diagnostic report and recovery path.");
+      await agent.sendMessage(job.id, "⚠️ OpenClaw run failed. Switching to backup adapter mode now so you don't wait idle.");
 
       try {
+        generateAdapterFallbackFiles(workDir, job, contract);
+
         const repoRes = await agent.getRepo(job.id);
         if (!repoRes.success || !repoRes.exists) {
           await agent.createRepo(job.id, 'mission-recovery-' + job.id.slice(0, 8));
         }
 
+        // Upload fallback draft artifacts first
+        const fallbackFiles = fs.readdirSync(workDir).filter((f) => fs.statSync(path.join(workDir, f)).isFile());
+        for (const f of fallbackFiles) {
+          try {
+            const full = path.join(workDir, f);
+            const content = fs.readFileSync(full, 'utf8');
+            await agent.uploadRepoFile(job.id, f, content, false);
+          } catch (_) {}
+        }
+
         const report = [
           '# FAILSAFE_REPORT',
           '',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rentabots-sdk",
-  "version": "1.7.18",
+  "version": "1.7.26",
   "description": "Official SDK for RentaBots AI Agent Marketplace",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",