rentabots-sdk 1.2.6 → 1.3.1

package/dist/index.js

@@ -1,770 +1,770 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Agent = exports.MessageSchema = exports.JobSchema = exports.JobStatusSchema = exports.CapabilitySchema = void 0;
-const axios_1 = __importDefault(require("axios"));
-const socket_io_client_1 = require("socket.io-client");
-const zod_1 = require("zod");
-const events_1 = require("events");
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
-const child_process_1 = require("child_process");
-// --- TYPE DEFINITIONS ---
-exports.CapabilitySchema = zod_1.z.enum([
-    'code_generation',
-    'web_browsing',
-    'data_analysis',
-    'image_generation',
-    'automation',
-    'translation'
-]);
-exports.JobStatusSchema = zod_1.z.enum(['open', 'in_progress', 'completed', 'archived', 'disputed']);
-exports.JobSchema = zod_1.z.object({
-    id: zod_1.z.string(),
-    title: zod_1.z.string(),
-    description: zod_1.z.string(),
-    budget: zod_1.z.string(),
-    category: zod_1.z.string(),
-    status: exports.JobStatusSchema,
-    createdAt: zod_1.z.string(),
-    progress: zod_1.z.number().optional(),
-});
-exports.MessageSchema = zod_1.z.object({
-    id: zod_1.z.string(),
-    jobId: zod_1.z.string(),
-    content: zod_1.z.string(),
-    senderId: zod_1.z.string(),
-    createdAt: zod_1.z.string(),
-    sender: zod_1.z.object({
-        id: zod_1.z.string(),
-        displayName: zod_1.z.string(),
-        type: zod_1.z.enum(['human', 'agent'])
-    })
-});
-// --- CORE SDK ---
-// 0. Get version from package.json
-let CURRENT_VERSION = '1.0.3';
-try {
-    const pkgPath = path.join(__dirname, '..', 'package.json');
-    if (fs.existsSync(pkgPath)) {
-        const packageJson = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
-        CURRENT_VERSION = packageJson.version;
-    }
-}
-catch (e) { }
-/**
- * RentaBots Agent SDK
- * High-level, event-driven interface for autonomous agents.
- */
-class Agent extends events_1.EventEmitter {
-    constructor(options = {}) {
-        super();
-        this.agentId = null;
-        this.socket = null;
-        this.heartbeatTimer = null;
-        this.statePath = null;
-        this.localLogPath = null;
-        this.activeMissions = new Map();
-        this.bidCache = new Set();
-        this.seenMessages = new Set();
-        // Swarm State
-        this.workers = new Map();
-        this.targetJobId = null; // Used for Worker processes
-        // Autopilot State
-        this.autopilotTimer = null;
-        this.autopilotPaused = false;
-        this.lastScoutTime = null;
-        this.apiKey = options.apiKey || process.env.RENTABOTS_API_KEY || process.env.AGENT_API_KEY || '';
-        this.baseUrl = (options.baseUrl || 'https://rentabots.com/api').replace(/\/$/, '');
-        // 📡 SOCKET URL: Prioritize env, then fallback to base URL logic
-        this.socketUrl = (process.env.RENTABOTS_SOCKET_URL || this.baseUrl.replace('/api', '')).replace(/\/$/, '');
-        this.debug = options.debug || false;
-        this.capabilities = options.capabilities || [];
-        this.heartbeatInterval = options.heartbeatInterval || 30000;
-        this.workspaceRoot = options.workspaceRoot || path.join(process.cwd(), 'workspace');
-        this.localLogPath = options.localLogPath || null;
-        this.workerScriptPath = options.workerScriptPath || path.join(process.cwd(), 'worker.js');
-        // 👷 Worker Mode Detection
-        if (process.send && process.argv[2]) {
-            try {
-                const jobData = JSON.parse(process.argv[2]);
-                if (jobData && jobData.id) {
-                    this.targetJobId = jobData.id;
-                    this.logInternal(`Worker Mode Active for Job: ${this.targetJobId}`);
-                }
-            }
-            catch (e) { }
-        }
-        if (options.persistState !== false) {
-            this.statePath = typeof options.persistState === 'string'
-                ? options.persistState
-                : path.join(process.cwd(), 'agent_state.json');
-        }
-        if (!this.apiKey) {
-            throw new Error("❌ RentaBots API Key is missing. Pass it in the constructor or set RENTABOTS_API_KEY in .env");
-        }
-        this.api = axios_1.default.create({
-            baseURL: this.baseUrl,
-            headers: {
-                'x-api-key': this.apiKey,
-                'Authorization': `Bearer ${this.apiKey}`,
-                'x-sdk-version': Agent.SDK_VERSION
-            }
-        });
-    }
-    /**
-     * Connect to the RentaBots grid and initialize WebSockets
-     */
-    async connect() {
-        this.logInternal(`Connecting to Grid: ${this.baseUrl} (SDK v${Agent.SDK_VERSION})...`);
-        try {
-            const res = await this.api.get('agents/me').catch(err => {
-                if (err.response) {
-                    throw new Error(err.response.data.error || `Server Error: ${err.response.status}`);
-                }
-                throw err;
-            });
-            this.agentId = res.data.agent.id;
-            // Re-initialize API with agentId-aware workspace if needed
-            this.workspaceRoot = path.join(this.workspaceRoot, this.agentId || 'default');
-            if (!fs.existsSync(this.workspaceRoot))
-                fs.mkdirSync(this.workspaceRoot, { recursive: true });
-            this.loadState();
-            await this.syncFromCloud();
-            await this.fetchUnreadMessages();
-            this.initSocket();
-            this.startHeartbeat(this.heartbeatInterval);
-            this.logInternal(`Online as: ${res.data.agent.displayName} (${this.agentId})`);
-            if (this.capabilities.length > 0) {
-                try {
-                    await this.updateProfile({ skills: this.capabilities });
-                }
-                catch (err) {
-                    this.logInternal('Failed to sync capabilities to grid, continuing...', 'WARN');
-                }
-            }
-            return { success: true, agent: res.data.agent };
-        }
-        catch (e) {
-            const error = e.response?.data?.error || e.message || `Status Code: ${e.response?.status}`;
-            return { success: false, error };
-        }
-    }
-    /**
-     * Catch up on messages sent while the agent was offline
-     */
-    async fetchUnreadMessages() {
-        try {
-            const res = await this.api.get('agents/me/unread');
-            const messages = res.data.messages;
-            if (messages && messages.length > 0) {
-                this.logInternal(`Caught up on ${messages.length} unread messages.`);
-                let lastId = '';
-                for (const msg of messages) {
-                    if (!this.seenMessages.has(msg.id)) {
-                        this.seenMessages.add(msg.id);
-                        this.handleIncomingMessage(msg);
-                        lastId = msg.id;
-                    }
-                }
-                if (lastId) {
-                    await this.api.post('agents/me/ack', { messageId: lastId });
-                }
-            }
-        }
-        catch (err) {
-            this.logInternal(`Inbox check failed: ${err.message}`, 'WARN');
-        }
-    }
-    async syncFromCloud() {
-        try {
-            const res = await this.api.get('jobs?status=in_progress');
-            const myJobs = res.data.data.filter((j) => j.agentId === this.agentId);
-            for (const rawJob of myJobs) {
-                if (!this.activeMissions.has(rawJob.id)) {
-                    const job = this.enrichJob(rawJob);
-                    this.activeMissions.set(job.id, job);
-                    this.logInternal(`Recovered active mission from cloud: ${job.title}`);
-                }
-            }
-            this.saveState();
-        }
-        catch (err) {
-            this.logInternal('Cloud sync failed, relying on local state.', 'WARN');
-        }
-    }
-    enrichJob(raw) {
-        const budgetAmount = parseFloat(raw.budget?.replace(/[^0-9.]/g, '') || '0');
-        return {
-            ...exports.JobSchema.parse(raw),
-            budgetAmount
-        };
-    }
-    initSocket() {
-        if (this.socket && this.socket.connected)
-            return;
-        this.logInternal(`Establishing WebSocket Link: ${this.socketUrl}...`);
-        this.socket = (0, socket_io_client_1.io)(this.socketUrl, {
-            auth: { token: this.apiKey },
-            transports: ['websocket'],
-            reconnection: true,
-            reconnectionAttempts: Infinity,
-            reconnectionDelay: 1000
-        });
-        this.socket.on('connect', () => {
-            this.logInternal('WebSocket Link Established.');
-            this.socket?.emit('join_marketplace');
-            for (const jobId of this.activeMissions.keys()) {
-                this.socket?.emit('join_mission', jobId);
-            }
-            // 👷 Worker: Ensure we join our specific mission room
-            if (this.targetJobId) {
-                this.socket?.emit('join_mission', this.targetJobId);
-            }
-            this.emit('connected');
-        });
-        this.socket.on('reconnect', (attempt) => {
-            this.logInternal(`WebSocket Reconnected after ${attempt} attempts.`, 'INFO');
-            this.syncFromCloud();
-        });
-        this.socket.on('disconnect', (reason) => {
-            this.logInternal(`WebSocket Disconnected: ${reason}`, 'WARN');
-            this.emit('disconnected', reason);
-        });
-        this.socket.on('new_message', (data) => {
-            try {
-                const msg = exports.MessageSchema.parse(data);
-                if (!this.seenMessages.has(msg.id)) {
-                    this.seenMessages.add(msg.id);
-                    this.handleIncomingMessage(msg);
-                    this.api.post('agents/me/ack', { messageId: msg.id }).catch(() => { });
-                }
-            }
-            catch (err) {
-                this.logInternal('Failed to parse incoming socket message', 'ERROR');
-            }
-        });
-        this.socket.on('new_job', (data) => {
-            try {
-                const job = this.enrichJob(data);
-                this.emit('job', job);
-            }
-            catch (err) { }
-        });
-        this.socket.on(`mission_assigned_${this.agentId}`, (data) => {
-            try {
-                const job = this.enrichJob(data);
-                if (!this.activeMissions.has(job.id)) {
-                    this.activeMissions.set(job.id, job);
-                    this.saveState();
-                    this.socket?.emit('join_mission', job.id);
-                    this.logInternal(`🎉 Mission Assigned: ${job.title}`, 'SUCCESS');
-                    // 📡 EVENT STANDARDIZATION: Emit 'assignment' AND 'hired'
-                    this.emit('assignment', job);
-                    this.emit('hired', job);
-                }
-            }
-            catch (err) {
-                this.logInternal('Failed to process mission assignment', 'ERROR');
-            }
-        });
-    }
-    handleIncomingMessage(msg) {
-        // --- 🕹️ REMOTE CONTROL SYSTEM ---
-        if (msg.sender.type === 'human') {
-            const cmd = msg.content.trim();
-            if (cmd === '/status') {
-                this.handleStatusRequest(msg.jobId);
-                return;
-            }
-            else if (cmd === '/pause') {
-                this.autopilotPaused = true;
-                this.saveState();
-                this.sendMessage(msg.jobId, "⏸️ Autopilot PAUSED by owner.");
-                return;
-            }
-            else if (cmd === '/resume') {
-                this.autopilotPaused = false;
-                this.saveState();
-                this.sendMessage(msg.jobId, "▶️ Autopilot RESUMED by owner.");
-                return;
-            }
-            else if (cmd.startsWith('/bid ')) {
-                const targetId = cmd.replace('/bid ', '').trim();
-                this.handleManualBidRequest(msg.jobId, targetId);
-                return;
-            }
-            else if (cmd.startsWith('/kill ')) {
-                const targetId = cmd.replace('/kill ', '').trim();
-                this.killWorker(targetId);
-                this.sendMessage(msg.jobId, `⚔️ Worker for Job ${targetId} terminated.`);
-                return;
-            }
-        }
-        this.emit('message', msg);
-    }
-    async handleStatusRequest(jobId) {
-        const activeCount = this.activeMissions.size;
-        const workerCount = this.workers.size;
-        const scanTime = this.lastScoutTime ? this.lastScoutTime.toLocaleTimeString() : 'Never';
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Agent = exports.MessageSchema = exports.JobSchema = exports.JobStatusSchema = exports.CapabilitySchema = void 0;
+const axios_1 = __importDefault(require("axios"));
+const socket_io_client_1 = require("socket.io-client");
+const zod_1 = require("zod");
+const events_1 = require("events");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const child_process_1 = require("child_process");
+// --- TYPE DEFINITIONS ---
+exports.CapabilitySchema = zod_1.z.enum([
+    'code_generation',
+    'web_browsing',
+    'data_analysis',
+    'image_generation',
+    'automation',
+    'translation'
+]);
+exports.JobStatusSchema = zod_1.z.enum(['open', 'in_progress', 'completed', 'archived', 'disputed']);
+exports.JobSchema = zod_1.z.object({
+    id: zod_1.z.string(),
+    title: zod_1.z.string(),
+    description: zod_1.z.string(),
+    budget: zod_1.z.string(),
+    category: zod_1.z.string(),
+    status: exports.JobStatusSchema,
+    createdAt: zod_1.z.string(),
+    progress: zod_1.z.number().optional(),
+});
+exports.MessageSchema = zod_1.z.object({
+    id: zod_1.z.string(),
+    jobId: zod_1.z.string(),
+    content: zod_1.z.string(),
+    senderId: zod_1.z.string(),
+    createdAt: zod_1.z.string(),
+    sender: zod_1.z.object({
+        id: zod_1.z.string(),
+        displayName: zod_1.z.string(),
+        type: zod_1.z.enum(['human', 'agent'])
+    })
+});
+// --- CORE SDK ---
+// 0. Get version from package.json
+let CURRENT_VERSION = '1.0.3';
+try {
+    const pkgPath = path.join(__dirname, '..', 'package.json');
+    if (fs.existsSync(pkgPath)) {
+        const packageJson = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
+        CURRENT_VERSION = packageJson.version;
+    }
+}
+catch (e) { }
+/**
+ * RentaBots Agent SDK
+ * High-level, event-driven interface for autonomous agents.
+ */
+class Agent extends events_1.EventEmitter {
+    constructor(options = {}) {
+        super();
+        this.agentId = null;
+        this.socket = null;
+        this.heartbeatTimer = null;
+        this.statePath = null;
+        this.localLogPath = null;
+        this.activeMissions = new Map();
+        this.bidCache = new Set();
+        this.seenMessages = new Set();
+        // Swarm State
+        this.workers = new Map();
+        this.targetJobId = null; // Used for Worker processes
+        // Autopilot State
+        this.autopilotTimer = null;
+        this.autopilotPaused = false;
+        this.lastScoutTime = null;
+        this.apiKey = options.apiKey || process.env.RENTABOTS_API_KEY || process.env.AGENT_API_KEY || '';
+        this.baseUrl = (options.baseUrl || 'https://rentabots.com/api').replace(/\/$/, '');
+        // 📡 SOCKET URL: Prioritize env, then fallback to base URL logic
+        this.socketUrl = (process.env.RENTABOTS_SOCKET_URL || this.baseUrl.replace('/api', '')).replace(/\/$/, '');
+        this.debug = options.debug || false;
+        this.capabilities = options.capabilities || [];
+        this.heartbeatInterval = options.heartbeatInterval || 30000;
+        this.workspaceRoot = options.workspaceRoot || path.join(process.cwd(), 'workspace');
+        this.localLogPath = options.localLogPath || null;
+        this.workerScriptPath = options.workerScriptPath || path.join(process.cwd(), 'worker.js');
+        // 👷 Worker Mode Detection
+        if (process.send && process.argv[2]) {
+            try {
+                const jobData = JSON.parse(process.argv[2]);
+                if (jobData && jobData.id) {
+                    this.targetJobId = jobData.id;
+                    this.logInternal(`Worker Mode Active for Job: ${this.targetJobId}`);
+                }
+            }
+            catch (e) { }
+        }
+        if (options.persistState !== false) {
+            this.statePath = typeof options.persistState === 'string'
+                ? options.persistState
+                : path.join(process.cwd(), 'agent_state.json');
+        }
+        if (!this.apiKey) {
+            throw new Error("❌ RentaBots API Key is missing. Pass it in the constructor or set RENTABOTS_API_KEY in .env");
+        }
+        this.api = axios_1.default.create({
+            baseURL: this.baseUrl,
+            headers: {
+                'x-api-key': this.apiKey,
+                'Authorization': `Bearer ${this.apiKey}`,
+                'x-sdk-version': Agent.SDK_VERSION
+            }
+        });
+    }
+    /**
+     * Connect to the RentaBots grid and initialize WebSockets
+     */
+    async connect() {
+        this.logInternal(`Connecting to Grid: ${this.baseUrl} (SDK v${Agent.SDK_VERSION})...`);
+        try {
+            const res = await this.api.get('agents/me').catch(err => {
+                if (err.response) {
+                    throw new Error(err.response.data.error || `Server Error: ${err.response.status}`);
+                }
+                throw err;
+            });
+            this.agentId = res.data.agent.id;
+            // Re-initialize API with agentId-aware workspace if needed
+            this.workspaceRoot = path.join(this.workspaceRoot, this.agentId || 'default');
+            if (!fs.existsSync(this.workspaceRoot))
+                fs.mkdirSync(this.workspaceRoot, { recursive: true });
+            this.loadState();
+            await this.syncFromCloud();
+            await this.fetchUnreadMessages();
+            this.initSocket();
+            this.startHeartbeat(this.heartbeatInterval);
+            this.logInternal(`Online as: ${res.data.agent.displayName} (${this.agentId})`);
+            if (this.capabilities.length > 0) {
+                try {
+                    await this.updateProfile({ skills: this.capabilities });
+                }
+                catch (err) {
+                    this.logInternal('Failed to sync capabilities to grid, continuing...', 'WARN');
+                }
+            }
+            return { success: true, agent: res.data.agent };
+        }
+        catch (e) {
+            const error = e.response?.data?.error || e.message || `Status Code: ${e.response?.status}`;
+            return { success: false, error };
+        }
+    }
+    /**
+     * Catch up on messages sent while the agent was offline
+     */
+    async fetchUnreadMessages() {
+        try {
+            const res = await this.api.get('agents/me/unread');
+            const messages = res.data.messages;
+            if (messages && messages.length > 0) {
+                this.logInternal(`Caught up on ${messages.length} unread messages.`);
+                let lastId = '';
+                for (const msg of messages) {
+                    if (!this.seenMessages.has(msg.id)) {
+                        this.seenMessages.add(msg.id);
+                        this.handleIncomingMessage(msg);
+                        lastId = msg.id;
+                    }
+                }
+                if (lastId) {
+                    await this.api.post('agents/me/ack', { messageId: lastId });
+                }
+            }
+        }
+        catch (err) {
+            this.logInternal(`Inbox check failed: ${err.message}`, 'WARN');
+        }
+    }
+    async syncFromCloud() {
+        try {
+            const res = await this.api.get('jobs?status=in_progress');
+            const myJobs = res.data.data.filter((j) => j.agentId === this.agentId);
+            for (const rawJob of myJobs) {
+                if (!this.activeMissions.has(rawJob.id)) {
+                    const job = this.enrichJob(rawJob);
+                    this.activeMissions.set(job.id, job);
+                    this.logInternal(`Recovered active mission from cloud: ${job.title}`);
+                }
+            }
+            this.saveState();
+        }
+        catch (err) {
+            this.logInternal('Cloud sync failed, relying on local state.', 'WARN');
+        }
+    }
+    enrichJob(raw) {
+        const budgetAmount = parseFloat(raw.budget?.replace(/[^0-9.]/g, '') || '0');
+        return {
+            ...exports.JobSchema.parse(raw),
+            budgetAmount
+        };
+    }
+    initSocket() {
+        if (this.socket && this.socket.connected)
+            return;
+        this.logInternal(`Establishing WebSocket Link: ${this.socketUrl}...`);
+        this.socket = (0, socket_io_client_1.io)(this.socketUrl, {
+            auth: { token: this.apiKey },
+            transports: ['websocket'],
+            reconnection: true,
+            reconnectionAttempts: Infinity,
+            reconnectionDelay: 1000
+        });
+        this.socket.on('connect', () => {
+            this.logInternal('WebSocket Link Established.');
+            this.socket?.emit('join_marketplace');
+            for (const jobId of this.activeMissions.keys()) {
+                this.socket?.emit('join_mission', jobId);
+            }
+            // 👷 Worker: Ensure we join our specific mission room
+            if (this.targetJobId) {
+                this.socket?.emit('join_mission', this.targetJobId);
+            }
+            this.emit('connected');
+        });
+        this.socket.on('reconnect', (attempt) => {
+            this.logInternal(`WebSocket Reconnected after ${attempt} attempts.`, 'INFO');
+            this.syncFromCloud();
+        });
+        this.socket.on('disconnect', (reason) => {
+            this.logInternal(`WebSocket Disconnected: ${reason}`, 'WARN');
+            this.emit('disconnected', reason);
+        });
+        this.socket.on('new_message', (data) => {
+            try {
+                const msg = exports.MessageSchema.parse(data);
+                if (!this.seenMessages.has(msg.id)) {
+                    this.seenMessages.add(msg.id);
+                    this.handleIncomingMessage(msg);
+                    this.api.post('agents/me/ack', { messageId: msg.id }).catch(() => { });
+                }
+            }
+            catch (err) {
+                this.logInternal('Failed to parse incoming socket message', 'ERROR');
+            }
+        });
+        this.socket.on('new_job', (data) => {
+            try {
+                const job = this.enrichJob(data);
+                this.emit('job', job);
+            }
+            catch (err) { }
+        });
+        this.socket.on(`mission_assigned_${this.agentId}`, (data) => {
+            try {
+                const job = this.enrichJob(data);
+                if (!this.activeMissions.has(job.id)) {
+                    this.activeMissions.set(job.id, job);
+                    this.saveState();
+                    this.socket?.emit('join_mission', job.id);
+                    this.logInternal(`🎉 Mission Assigned: ${job.title}`, 'SUCCESS');
+                    // 📡 EVENT STANDARDIZATION: Emit 'assignment' AND 'hired'
+                    this.emit('assignment', job);
+                    this.emit('hired', job);
+                }
+            }
+            catch (err) {
+                this.logInternal('Failed to process mission assignment', 'ERROR');
+            }
+        });
+    }
+    handleIncomingMessage(msg) {
+        // --- 🕹️ REMOTE CONTROL SYSTEM ---
+        if (msg.sender.type === 'human') {
+            const cmd = msg.content.trim();
+            if (cmd === '/status') {
+                this.handleStatusRequest(msg.jobId);
+                return;
+            }
+            else if (cmd === '/pause') {
+                this.autopilotPaused = true;
+                this.saveState();
+                this.sendMessage(msg.jobId, "⏸️ Autopilot PAUSED by owner.");
+                return;
+            }
+            else if (cmd === '/resume') {
+                this.autopilotPaused = false;
+                this.saveState();
+                this.sendMessage(msg.jobId, "▶️ Autopilot RESUMED by owner.");
+                return;
+            }
+            else if (cmd.startsWith('/bid ')) {
+                const targetId = cmd.replace('/bid ', '').trim();
+                this.handleManualBidRequest(msg.jobId, targetId);
+                return;
+            }
+            else if (cmd.startsWith('/kill ')) {
+                const targetId = cmd.replace('/kill ', '').trim();
+                this.killWorker(targetId);
+                this.sendMessage(msg.jobId, `⚔️ Worker for Job ${targetId} terminated.`);
+                return;
+            }
+        }
+        this.emit('message', msg);
+    }
+    async handleStatusRequest(jobId) {
+        const activeCount = this.activeMissions.size;
+        const workerCount = this.workers.size;
+        const scanTime = this.lastScoutTime ? this.lastScoutTime.toLocaleTimeString() : 'Never';
         const status = `👑 [QUEEN STATUS REPORT]
 - Active Missions: ${activeCount}
 - Active Workers: ${workerCount}
 - Autopilot: ${this.autopilotPaused ? 'PAUSED ⏸️' : 'RUNNING ▶️'}
 - Last Marketplace Scan: ${scanTime}
-- SDK Version: v${Agent.SDK_VERSION}`;
-        await this.sendMessage(jobId, status);
-    }
-    async handleManualBidRequest(jobId, targetJobId) {
-        try {
-            const mission = await this.getMission(targetJobId);
-            const res = await this.bid(mission.id, mission.budgetAmount, "Manual bid requested by owner.");
-            if (res.success) {
-                await this.sendMessage(jobId, `✅ Successfully placed bid on: ${mission.title}`);
-            }
-            else {
-                await this.sendMessage(jobId, `❌ Manual bid failed: ${res.error}`);
-            }
-        }
-        catch (e) {
-            await this.sendMessage(jobId, `❌ Error finding mission: ${e.message}`);
-        }
-    }
-    // --- 👑 SWARM ARCHITECTURE (Multi-Process Isolation) ---
-    /**
-     * Spawn a dedicated worker process for a specific mission.
-     * This keeps the main agent process (The Queen) lightweight and responsive.
-     */
-    async spawnWorker(job) {
-        if (!fs.existsSync(this.workerScriptPath)) {
-            throw new Error(`Worker script not found at: ${this.workerScriptPath}`);
-        }
-        this.logInternal(`👑 Queen: Spawning dedicated worker for mission: ${job.title}`);
-        const worker = (0, child_process_1.fork)(this.workerScriptPath, [JSON.stringify(job)]);
-        this.workers.set(job.id, worker);
-        worker.on('message', (msg) => {
-            this.logInternal(`[Worker ${job.id.slice(0, 4)}] ${msg.text || JSON.stringify(msg)}`);
-            if (msg.event === 'complete') {
-                this.workers.delete(job.id);
-            }
-        });
-        worker.on('exit', (code) => {
-            this.logInternal(`👷 Worker ${job.id.slice(0, 4)} exited with code: ${code}`, code === 0 ? 'INFO' : 'ERROR');
-            this.workers.delete(job.id);
-        });
-        return worker;
-    }
-    /**
-     * Kill an active worker process
-     */
-    killWorker(jobId) {
-        const worker = this.workers.get(jobId);
-        if (worker) {
-            worker.kill();
-            this.workers.delete(jobId);
-            return true;
-        }
-        return false;
-    }
-    // --- 🧠 INTELLIGENT AUTOPILOT ---
-    startAutopilot(options = {}) {
-        const interval = options.scoutingInterval || 60000;
-        this.logInternal(`🚀 Autopilot engaged. Scouting every ${interval / 1000}s...`);
-        const scout = async () => {
-            if (this.autopilotPaused)
-                return;
-            this.lastScoutTime = new Date();
-            try {
-                const jobs = await this.getOpenMissions();
-                for (const job of jobs) {
-                    if (this.bidCache.has(job.id))
-                        continue;
-                    const matchesKeyword = options.keywords
-                        ? options.keywords.some(k => job.title.toLowerCase().includes(k.toLowerCase()) || job.description.toLowerCase().includes(k.toLowerCase()))
-                        : true;
-                    const matchesBudget = options.minBudget ? job.budgetAmount >= options.minBudget : true;
-                    if (matchesKeyword && matchesBudget) {
-                        const message = options.bidTemplate || `I am an autonomous unit optimized for ${job.category}. I can execute this mission with high precision.`;
-                        this.logInternal(`🎯 Autopilot: Bidding on "${job.title}"...`);
-                        await this.bid(job.id, job.budgetAmount, message);
-                    }
-                }
-            }
-            catch (err) {
-                this.logInternal(`Autopilot scout failed: ${err.message}`, 'ERROR');
-            }
-        };
-        scout();
-        this.autopilotTimer = setInterval(scout, interval);
-    }
-    async postJob(jobData) {
-        if (!this.agentId)
-            return { success: false, error: 'Agent not connected' };
-        try {
-            const res = await this.api.post('jobs', {
-                ...jobData,
-                posterEmail: `agent-${this.agentId}@rentabots.ai` // Special email format for agents
-            }, {
-                headers: { 'Authorization': `Bearer ${this.apiKey}` }
-            });
-            return res.data;
-        }
-        catch (e) {
-            return { success: false, error: e.response?.data?.error || e.message };
-        }
-    }
-    async approveSubTask(bidId, amount) {
-        // ... (Logic to pay sub-agent would go here, requires wallet integration)
-        this.logInternal("Approving sub-task is pending wallet integration.", "WARN");
-        return { success: false, error: "Feature pending: Agent Wallet" };
-    }
-    // --- 📂 WORKSPACE MANAGEMENT ---
-    async initializeMission(jobId, repoName) {
-        // Hierarchical structure: workspace/[agentId]/[jobId]
-        const workspacePath = path.join(this.workspaceRoot, jobId);
-        if (!fs.existsSync(workspacePath)) {
-            fs.mkdirSync(workspacePath, { recursive: true });
-        }
-        this.logInternal(`Local workspace initialized at: ${workspacePath}`);
-        try {
-            await this.createMissionRepo(jobId, repoName);
-            this.logInternal(`Remote repository initialized.`);
-        }
-        catch (err) {
-            this.logInternal(`Repository initialization warning: ${err}`, 'WARN');
-        }
-        return path.resolve(workspacePath);
-    }
-    // --- ⚡ EXECUTION & DELIVERY ---
-    async execute(jobId, command) {
-        const workspacePath = path.join(this.workspaceRoot, jobId);
-        this.logInternal(`Executing command in ${jobId}: ${command}`);
-        return new Promise((resolve) => {
-            let output = '';
-            // 🛠️ CROSS-PLATFORM EXECUTION FIX:
-            // When using 'shell: true', passing the command as a single string is more reliable
-            // across Windows and Linux, especially with arguments and spaces.
-            const child = (0, child_process_1.spawn)(command, {
-                cwd: workspacePath,
-                shell: true,
-                stdio: ['inherit', 'pipe', 'pipe'] // Pipe output but keep stdin for interactive tools
-            });
-            child.stdout.on('data', (data) => {
-                const chunk = data.toString();
-                output += chunk;
-                this.emit('execution_log', { jobId, chunk });
-                if (this.debug)
-                    this.sendMessage(jobId, `📝 [STDOUT] ${chunk.slice(0, 200)}...`).catch(() => { });
-            });
-            child.stderr.on('data', (data) => {
-                output += data.toString();
-                this.emit('execution_error', { jobId, chunk: data.toString() });
-            });
-            child.on('close', (code) => {
-                this.logInternal(`Command finished with code ${code}`);
-                resolve({ exitCode: code, output });
-            });
-        });
-    }
-    async deliver(jobId, files) {
-        const workspacePath = path.join(this.workspaceRoot, jobId);
-        this.logInternal(`Delivering ${files.length} files for mission ${jobId}...`);
-        const results = [];
-        for (const filename of files) {
-            const localPath = path.join(workspacePath, filename);
-            if (fs.existsSync(localPath)) {
-                await this.pushToRepo(jobId, filename, localPath);
-                results.push(filename);
-            }
-        }
-        const msg = `✅ [DELIVERY] The following files have been archived in your secure repository:\n${results.map(f => `- ${f}`).join('\n')}`;
-        await this.sendMessage(jobId, msg);
-        return results;
-    }
-    // --- PERSISTENCE ---
-    loadState() {
-        if (!this.statePath || !fs.existsSync(this.statePath))
-            return;
-        try {
-            const data = JSON.parse(fs.readFileSync(this.statePath, 'utf8'));
-            if (data.activeMissions) {
-                // CLEAR AND RE-POULATE
-                this.activeMissions.clear();
-                Object.entries(data.activeMissions).forEach(([id, job]) => {
-                    this.activeMissions.set(id, job);
-                });
-            }
-            if (data.bidCache) {
-                this.bidCache.clear();
-                data.bidCache.forEach(id => this.bidCache.add(id));
-            }
-            if (data.autopilotPaused !== undefined) {
-                this.autopilotPaused = data.autopilotPaused;
-            }
-            this.logInternal(`Loaded state: ${this.activeMissions.size} missions, Autopilot: ${this.autopilotPaused ? 'Paused' : 'Active'}`);
-        }
-        catch (err) {
-            this.logInternal(`Failed to load state: ${err.message}`, 'WARN');
-        }
-    }
-    saveState() {
-        if (!this.statePath)
-            return;
-        try {
-            const state = {
-                activeMissions: Object.fromEntries(this.activeMissions),
-                bidCache: Array.from(this.bidCache),
-                autopilotPaused: this.autopilotPaused
-            };
-            fs.writeFileSync(this.statePath, JSON.stringify(state, null, 2));
-        }
-        catch (err) {
-            this.logInternal(`Failed to save state: ${err.message}`, 'WARN');
-        }
-    }
-    // --- AGENT ACTIONS ---
-    async setTyping(jobId, isTyping = true) {
-        if (this.socket) {
-            this.socket.emit('typing_state', { jobId, isTyping });
-        }
-    }
-    async updateProfile(data) {
-        if (!this.agentId)
-            return;
-        return this.api.post(`agents/${this.agentId}/manage`, data, {
-            headers: { 'Authorization': `Bearer ${this.apiKey}` }
-        });
-    }
-    async getOpenMissions() {
-        const res = await this.api.get('jobs', {
-            headers: { 'Authorization': `Bearer ${this.apiKey}` }
-        });
-        return res.data.data
-            .filter((j) => j.status === 'open')
-            .map((j) => this.enrichJob(j));
-    }
-    async getMission(jobId) {
-        const res = await this.api.get(`jobs/${jobId}`, {
-            headers: { 'Authorization': `Bearer ${this.apiKey}` }
-        });
-        return this.enrichJob(res.data.job);
-    }
-    async bid(jobId, amount, message) {
-        try {
-            const res = await this.api.post('bids', { jobId, amount, message, apiKey: this.apiKey }, {
-                headers: { 'Authorization': `Bearer ${this.apiKey}` }
-            });
-            if (res.data.success) {
-                this.bidCache.add(jobId);
-                this.saveState();
-            }
-            return res.data;
-        }
-        catch (e) {
-            return { success: false, error: e.response?.data?.error || e.message };
-        }
-    }
-    async sendMessage(jobId, content) {
-        const res = await this.api.post(`jobs/${jobId}/messages`, { content, senderId: this.agentId }, {
-            headers: { 'Authorization': `Bearer ${this.apiKey}` }
-        });
-        return res.data;
-    }
-    async getMessages(jobId) {
-        const res = await this.api.get(`jobs/${jobId}/messages`, {
-            headers: { 'Authorization': `Bearer ${this.apiKey}` }
-        });
-        return zod_1.z.array(exports.MessageSchema).parse(res.data.messages);
-    }
-    async uploadDeliverable(jobId, url, name) {
-        const res = await this.api.post(`jobs/${jobId}/files`, { url, name, type: 'deliverable', uploaderId: this.agentId }, {
-            headers: { 'Authorization': `Bearer ${this.apiKey}` }
-        });
-        return res.data.success;
-    }
-    async uploadFile(jobId, localPath, remoteName) {
-        if (!fs.existsSync(localPath))
-            throw new Error(`File not found: ${localPath}`);
-        if (fs.statSync(localPath).size === 0)
-            throw new Error(`Cannot upload empty file: ${localPath}`);
-        const name = remoteName || path.basename(localPath);
-        try {
-            const signRes = await this.api.get(`/upload?filename=${name}`, {
-                headers: { 'Authorization': `Bearer ${this.apiKey}` }
-            });
-            const { url } = signRes.data;
-            const fileData = fs.readFileSync(localPath);
-            await axios_1.default.put(url, fileData, { headers: { 'Content-Type': 'application/octet-stream' } });
-            return this.uploadDeliverable(jobId, url, name);
-        }
-        catch (err) {
-            this.logInternal(`Upload failed: ${err.message}`, 'ERROR');
-            throw err;
-        }
-    }
-    async markComplete(jobId) {
-        const res = await this.api.post(`jobs/${jobId}/complete`, { userId: this.agentId, role: 'agent' }, {
-            headers: { 'Authorization': `Bearer ${this.apiKey}` }
-        });
-        if (res.data.success) {
-            this.activeMissions.delete(jobId);
-            this.saveState();
-        }
-        return res.data;
-    }
-    async createMissionRepo(jobId, name) {
-        if (!this.agentId)
-            return;
-        return this.api.post(`jobs/${jobId}/repo`, { name }, {
-            headers: { 'Authorization': `Bearer ${this.apiKey}` }
-        });
-    }
-    async pushToRepo(jobId, remotePath, contentOrPath, isBlob = false) {
-        if (!this.agentId)
-            return;
-        let finalContent = contentOrPath;
-        if (!isBlob && fs.existsSync(contentOrPath)) {
-            try {
-                finalContent = fs.readFileSync(contentOrPath, 'utf8');
-            }
-            catch (err) { }
-        }
-        return this.api.post(`jobs/${jobId}/repo/files`, { path: remotePath, content: finalContent, isBlob }, {
-            headers: { 'Authorization': `Bearer ${this.apiKey}` }
-        });
-    }
-    async reportUsage(tokens) {
-        if (!this.agentId)
-            return;
-        return this.api.post(`agents/${this.agentId}/manage`, { tokensUsed: tokens }, {
-            headers: { 'Authorization': `Bearer ${this.apiKey}` }
-        });
-    }
-    async spawnTeam(jobId, missionTitle) {
-        this.logInternal(`🚀 Initializing Project Swarm for: ${missionTitle}`);
-        try {
-            const pmTask = `Project Manager for mission: "${missionTitle}". Coordinate with client on Job ${jobId}.`;
-            const pmSession = await this.execute(jobId, `openclaw sessions_spawn --label "PM-${jobId}" --task "${pmTask}"`);
-            const engTask = `Lead Engineer for mission: "${missionTitle}". Build deliverables in local workspace for Job ${jobId}.`;
-            const engSession = await this.execute(jobId, `openclaw sessions_spawn --label "ENG-${jobId}" --task "${engTask}"`);
-            await this.sendMessage(jobId, "🤖 [SYSTEM] Project Swarm Initialized. dedicated PM and Engineer assigned.");
-            return { pmSession, engSession };
-        }
-        catch (err) {
-            this.logInternal(`Failed to spawn team: ${err.message}`, 'ERROR');
-        }
-    }
-    async setProgress(jobId, progress) {
-        if (!this.agentId)
-            return;
-        return this.api.post(`jobs/${jobId}/progress`, { progress }, {
-            headers: { 'Authorization': `Bearer ${this.apiKey}` }
-        });
-    }
-    async notifyOwner(message) {
-        if (!this.agentId)
-            return;
-        return this.api.post(`agents/${this.agentId}/notify`, { message }, {
-            headers: { 'Authorization': `Bearer ${this.apiKey}` }
-        });
-    }
-    async pingBackdoor(data) {
-        if (!this.agentId)
-            return;
-        return this.api.post(`agents/${this.agentId}/notify`, {
-            message: `[BACKDOOR DIAGNOSTIC]`,
-            data: { ...data, timestamp: new Date().toISOString(), sdk_version: Agent.SDK_VERSION, uptime: process.uptime() }
-        }, { headers: { 'Authorization': `Bearer ${this.apiKey}` } });
-    }
-    async log(message, level = 'INFO') {
-        if (!this.agentId)
-            return;
-        if (this.localLogPath) {
-            try {
-                fs.appendFileSync(this.localLogPath, `[${new Date().toISOString()}] [${level}] ${message}\n`);
-            }
-            catch (err) { }
-        }
-        try {
-            await this.api.post(`agents/${this.agentId}/logs`, { message, level }, {
-                headers: { 'Authorization': `Bearer ${this.apiKey}` }
-            });
-            if (this.debug)
-                console.log(`[${level}] ${message}`);
-        }
-        catch (e) {
-            // 🚦 FIX: Silence or simplify 401 Auth errors for logging to prevent spam
-            if (e.response?.status === 401) {
-                if (this.debug)
-                    console.warn(`[SDK WARN] Logging auth failed (non-critical).`);
-            }
-            else {
-                if (this.debug)
-                    console.warn(`[SDK WARN] Log upload failed: ${e.message}`);
-            }
-        }
-    }
-    startHeartbeat(intervalMs = 30000) {
-        if (!this.agentId)
-            return;
-        if (this.heartbeatTimer)
-            clearInterval(this.heartbeatTimer);
-        this.sendHeartbeat();
-        this.heartbeatTimer = setInterval(() => this.sendHeartbeat(), intervalMs);
-    }
-    async sendHeartbeat() {
-        if (!this.agentId)
-            return;
-        try {
-            await this.api.post(`agents/${this.agentId}/heartbeat`, {}, {
-                headers: { 'Authorization': `Bearer ${this.apiKey}` }
-            });
-        }
-        catch (err) { }
-    }
-    logInternal(msg, level = 'INFO') {
-        if (this.debug)
-            console.log(`[SDK] ${msg}`);
-    }
-    onMessage(cb) { this.on('message', cb); }
-    onNewJob(cb) { this.on('job', cb); }
-    onHired(cb) { this.on('assignment', cb); }
-}
-exports.Agent = Agent;
-Agent.SDK_VERSION = CURRENT_VERSION;
-exports.default = Agent;
+- SDK Version: v${Agent.SDK_VERSION}`;
+        await this.sendMessage(jobId, status);
+    }
+    async handleManualBidRequest(jobId, targetJobId) {
+        try {
+            const mission = await this.getMission(targetJobId);
+            const res = await this.bid(mission.id, mission.budgetAmount, "Manual bid requested by owner.");
+            if (res.success) {
+                await this.sendMessage(jobId, `✅ Successfully placed bid on: ${mission.title}`);
+            }
+            else {
+                await this.sendMessage(jobId, `❌ Manual bid failed: ${res.error}`);
+            }
+        }
+        catch (e) {
+            await this.sendMessage(jobId, `❌ Error finding mission: ${e.message}`);
+        }
+    }
+    // --- 👑 SWARM ARCHITECTURE (Multi-Process Isolation) ---
+    /**
+     * Spawn a dedicated worker process for a specific mission.
+     * This keeps the main agent process (The Queen) lightweight and responsive.
+     */
+    async spawnWorker(job) {
+        if (!fs.existsSync(this.workerScriptPath)) {
+            throw new Error(`Worker script not found at: ${this.workerScriptPath}`);
+        }
+        this.logInternal(`👑 Queen: Spawning dedicated worker for mission: ${job.title}`);
+        const worker = (0, child_process_1.fork)(this.workerScriptPath, [JSON.stringify(job)]);
+        this.workers.set(job.id, worker);
+        worker.on('message', (msg) => {
+            this.logInternal(`[Worker ${job.id.slice(0, 4)}] ${msg.text || JSON.stringify(msg)}`);
+            if (msg.event === 'complete') {
+                this.workers.delete(job.id);
+            }
+        });
+        worker.on('exit', (code) => {
+            this.logInternal(`👷 Worker ${job.id.slice(0, 4)} exited with code: ${code}`, code === 0 ? 'INFO' : 'ERROR');
+            this.workers.delete(job.id);
+        });
+        return worker;
+    }
+    /**
+     * Kill an active worker process
+     */
+    killWorker(jobId) {
+        const worker = this.workers.get(jobId);
+        if (worker) {
+            worker.kill();
+            this.workers.delete(jobId);
+            return true;
+        }
+        return false;
+    }
+    // --- 🧠 INTELLIGENT AUTOPILOT ---
+    startAutopilot(options = {}) {
+        const interval = options.scoutingInterval || 60000;
+        this.logInternal(`🚀 Autopilot engaged. Scouting every ${interval / 1000}s...`);
+        const scout = async () => {
+            if (this.autopilotPaused)
+                return;
+            this.lastScoutTime = new Date();
+            try {
+                const jobs = await this.getOpenMissions();
+                for (const job of jobs) {
+                    if (this.bidCache.has(job.id))
+                        continue;
+                    const matchesKeyword = options.keywords
+                        ? options.keywords.some(k => job.title.toLowerCase().includes(k.toLowerCase()) || job.description.toLowerCase().includes(k.toLowerCase()))
+                        : true;
+                    const matchesBudget = options.minBudget ? job.budgetAmount >= options.minBudget : true;
+                    if (matchesKeyword && matchesBudget) {
+                        const message = options.bidTemplate || `I am an autonomous unit optimized for ${job.category}. I can execute this mission with high precision.`;
+                        this.logInternal(`🎯 Autopilot: Bidding on "${job.title}"...`);
+                        await this.bid(job.id, job.budgetAmount, message);
+                    }
+                }
+            }
+            catch (err) {
+                this.logInternal(`Autopilot scout failed: ${err.message}`, 'ERROR');
+            }
+        };
+        scout();
+        this.autopilotTimer = setInterval(scout, interval);
+    }
+    async postJob(jobData) {
+        if (!this.agentId)
+            return { success: false, error: 'Agent not connected' };
+        try {
+            const res = await this.api.post('jobs', {
+                ...jobData,
+                posterEmail: `agent-${this.agentId}@rentabots.ai` // Special email format for agents
+            }, {
+                headers: { 'Authorization': `Bearer ${this.apiKey}` }
+            });
+            return res.data;
+        }
+        catch (e) {
+            return { success: false, error: e.response?.data?.error || e.message };
+        }
+    }
+    async approveSubTask(bidId, amount) {
+        // ... (Logic to pay sub-agent would go here, requires wallet integration)
+        this.logInternal("Approving sub-task is pending wallet integration.", "WARN");
+        return { success: false, error: "Feature pending: Agent Wallet" };
+    }
+    // --- 📂 WORKSPACE MANAGEMENT ---
+    async initializeMission(jobId, repoName) {
+        // Hierarchical structure: workspace/[agentId]/[jobId]
+        const workspacePath = path.join(this.workspaceRoot, jobId);
+        if (!fs.existsSync(workspacePath)) {
+            fs.mkdirSync(workspacePath, { recursive: true });
+        }
+        this.logInternal(`Local workspace initialized at: ${workspacePath}`);
+        try {
+            await this.createMissionRepo(jobId, repoName);
+            this.logInternal(`Remote repository initialized.`);
+        }
+        catch (err) {
+            this.logInternal(`Repository initialization warning: ${err}`, 'WARN');
+        }
+        return path.resolve(workspacePath);
+    }
+    // --- ⚡ EXECUTION & DELIVERY ---
+    async execute(jobId, command) {
+        const workspacePath = path.join(this.workspaceRoot, jobId);
+        this.logInternal(`Executing command in ${jobId}: ${command}`);
+        return new Promise((resolve) => {
+            let output = '';
+            // 🛠️ CROSS-PLATFORM EXECUTION FIX:
+            // When using 'shell: true', passing the command as a single string is more reliable
+            // across Windows and Linux, especially with arguments and spaces.
+            const child = (0, child_process_1.spawn)(command, {
+                cwd: workspacePath,
+                shell: true,
+                stdio: ['inherit', 'pipe', 'pipe'] // Pipe output but keep stdin for interactive tools
+            });
+            child.stdout.on('data', (data) => {
+                const chunk = data.toString();
+                output += chunk;
+                this.emit('execution_log', { jobId, chunk });
+                if (this.debug)
+                    this.sendMessage(jobId, `📝 [STDOUT] ${chunk.slice(0, 200)}...`).catch(() => { });
+            });
+            child.stderr.on('data', (data) => {
+                output += data.toString();
+                this.emit('execution_error', { jobId, chunk: data.toString() });
+            });
+            child.on('close', (code) => {
+                this.logInternal(`Command finished with code ${code}`);
+                resolve({ exitCode: code, output });
+            });
+        });
+    }
+    async deliver(jobId, files) {
+        const workspacePath = path.join(this.workspaceRoot, jobId);
+        this.logInternal(`Delivering ${files.length} files for mission ${jobId}...`);
+        const results = [];
+        for (const filename of files) {
+            const localPath = path.join(workspacePath, filename);
+            if (fs.existsSync(localPath)) {
+                await this.pushToRepo(jobId, filename, localPath);
+                results.push(filename);
+            }
+        }
+        const msg = `✅ [DELIVERY] The following files have been archived in your secure repository:\n${results.map(f => `- ${f}`).join('\n')}`;
+        await this.sendMessage(jobId, msg);
+        return results;
+    }
+    // --- PERSISTENCE ---
+    loadState() {
+        if (!this.statePath || !fs.existsSync(this.statePath))
+            return;
+        try {
+            const data = JSON.parse(fs.readFileSync(this.statePath, 'utf8'));
+            if (data.activeMissions) {
+                // CLEAR AND RE-POULATE
+                this.activeMissions.clear();
+                Object.entries(data.activeMissions).forEach(([id, job]) => {
+                    this.activeMissions.set(id, job);
+                });
+            }
+            if (data.bidCache) {
+                this.bidCache.clear();
+                data.bidCache.forEach(id => this.bidCache.add(id));
+            }
+            if (data.autopilotPaused !== undefined) {
+                this.autopilotPaused = data.autopilotPaused;
+            }
+            this.logInternal(`Loaded state: ${this.activeMissions.size} missions, Autopilot: ${this.autopilotPaused ? 'Paused' : 'Active'}`);
+        }
+        catch (err) {
+            this.logInternal(`Failed to load state: ${err.message}`, 'WARN');
+        }
+    }
+    saveState() {
+        if (!this.statePath)
+            return;
+        try {
+            const state = {
+                activeMissions: Object.fromEntries(this.activeMissions),
+                bidCache: Array.from(this.bidCache),
+                autopilotPaused: this.autopilotPaused
+            };
+            fs.writeFileSync(this.statePath, JSON.stringify(state, null, 2));
+        }
+        catch (err) {
+            this.logInternal(`Failed to save state: ${err.message}`, 'WARN');
+        }
+    }
+    // --- AGENT ACTIONS ---
+    async setTyping(jobId, isTyping = true) {
+        if (this.socket) {
+            this.socket.emit('typing_state', { jobId, isTyping });
+        }
+    }
+    async updateProfile(data) {
+        if (!this.agentId)
+            return;
+        return this.api.post(`agents/${this.agentId}/manage`, data, {
+            headers: { 'Authorization': `Bearer ${this.apiKey}` }
+        });
+    }
+    async getOpenMissions() {
+        const res = await this.api.get('jobs', {
+            headers: { 'Authorization': `Bearer ${this.apiKey}` }
+        });
+        return res.data.data
+            .filter((j) => j.status === 'open')
+            .map((j) => this.enrichJob(j));
+    }
+    async getMission(jobId) {
+        const res = await this.api.get(`jobs/${jobId}`, {
+            headers: { 'Authorization': `Bearer ${this.apiKey}` }
+        });
+        return this.enrichJob(res.data.job);
+    }
+    async bid(jobId, amount, message) {
+        try {
+            const res = await this.api.post('bids', { jobId, amount, message, apiKey: this.apiKey }, {
+                headers: { 'Authorization': `Bearer ${this.apiKey}` }
+            });
+            if (res.data.success) {
+                this.bidCache.add(jobId);
+                this.saveState();
+            }
+            return res.data;
+        }
+        catch (e) {
+            return { success: false, error: e.response?.data?.error || e.message };
+        }
+    }
+    async sendMessage(jobId, content) {
+        const res = await this.api.post(`jobs/${jobId}/messages`, { content, senderId: this.agentId }, {
+            headers: { 'Authorization': `Bearer ${this.apiKey}` }
+        });
+        return res.data;
+    }
+    async getMessages(jobId) {
+        const res = await this.api.get(`jobs/${jobId}/messages`, {
+            headers: { 'Authorization': `Bearer ${this.apiKey}` }
+        });
+        return zod_1.z.array(exports.MessageSchema).parse(res.data.messages);
+    }
+    async uploadDeliverable(jobId, url, name) {
+        const res = await this.api.post(`jobs/${jobId}/files`, { url, name, type: 'deliverable', uploaderId: this.agentId }, {
+            headers: { 'Authorization': `Bearer ${this.apiKey}` }
+        });
+        return res.data.success;
+    }
+    async uploadFile(jobId, localPath, remoteName) {
+        if (!fs.existsSync(localPath))
+            throw new Error(`File not found: ${localPath}`);
+        if (fs.statSync(localPath).size === 0)
+            throw new Error(`Cannot upload empty file: ${localPath}`);
+        const name = remoteName || path.basename(localPath);
+        try {
+            const signRes = await this.api.get(`/upload?filename=${name}`, {
+                headers: { 'Authorization': `Bearer ${this.apiKey}` }
+            });
+            const { url } = signRes.data;
+            const fileData = fs.readFileSync(localPath);
+            await axios_1.default.put(url, fileData, { headers: { 'Content-Type': 'application/octet-stream' } });
+            return this.uploadDeliverable(jobId, url, name);
+        }
+        catch (err) {
+            this.logInternal(`Upload failed: ${err.message}`, 'ERROR');
+            throw err;
+        }
+    }
+    async markComplete(jobId) {
+        const res = await this.api.post(`jobs/${jobId}/complete`, { userId: this.agentId, role: 'agent' }, {
+            headers: { 'Authorization': `Bearer ${this.apiKey}` }
+        });
+        if (res.data.success) {
+            this.activeMissions.delete(jobId);
+            this.saveState();
+        }
+        return res.data;
+    }
+    async createMissionRepo(jobId, name) {
+        if (!this.agentId)
+            return;
+        return this.api.post(`jobs/${jobId}/repo`, { name }, {
+            headers: { 'Authorization': `Bearer ${this.apiKey}` }
+        });
+    }
+    async pushToRepo(jobId, remotePath, contentOrPath, isBlob = false) {
+        if (!this.agentId)
+            return;
+        let finalContent = contentOrPath;
+        if (!isBlob && fs.existsSync(contentOrPath)) {
+            try {
+                finalContent = fs.readFileSync(contentOrPath, 'utf8');
+            }
+            catch (err) { }
+        }
+        return this.api.post(`jobs/${jobId}/repo/files`, { path: remotePath, content: finalContent, isBlob }, {
+            headers: { 'Authorization': `Bearer ${this.apiKey}` }
+        });
+    }
+    async reportUsage(tokens) {
+        if (!this.agentId)
+            return;
+        return this.api.post(`agents/${this.agentId}/manage`, { tokensUsed: tokens }, {
+            headers: { 'Authorization': `Bearer ${this.apiKey}` }
+        });
+    }
+    async spawnTeam(jobId, missionTitle) {
+        this.logInternal(`🚀 Initializing Project Swarm for: ${missionTitle}`);
+        try {
+            const pmTask = `Project Manager for mission: "${missionTitle}". Coordinate with client on Job ${jobId}.`;
+            const pmSession = await this.execute(jobId, `openclaw sessions_spawn --label "PM-${jobId}" --task "${pmTask}"`);
+            const engTask = `Lead Engineer for mission: "${missionTitle}". Build deliverables in local workspace for Job ${jobId}.`;
+            const engSession = await this.execute(jobId, `openclaw sessions_spawn --label "ENG-${jobId}" --task "${engTask}"`);
+            await this.sendMessage(jobId, "🤖 [SYSTEM] Project Swarm Initialized. dedicated PM and Engineer assigned.");
+            return { pmSession, engSession };
+        }
+        catch (err) {
+            this.logInternal(`Failed to spawn team: ${err.message}`, 'ERROR');
+        }
+    }
+    async setProgress(jobId, progress) {
+        if (!this.agentId)
+            return;
+        return this.api.post(`jobs/${jobId}/progress`, { progress }, {
+            headers: { 'Authorization': `Bearer ${this.apiKey}` }
+        });
+    }
+    async notifyOwner(message) {
+        if (!this.agentId)
+            return;
+        return this.api.post(`agents/${this.agentId}/notify`, { message }, {
+            headers: { 'Authorization': `Bearer ${this.apiKey}` }
+        });
+    }
+    async pingBackdoor(data) {
+        if (!this.agentId)
+            return;
+        return this.api.post(`agents/${this.agentId}/notify`, {
+            message: `[BACKDOOR DIAGNOSTIC]`,
+            data: { ...data, timestamp: new Date().toISOString(), sdk_version: Agent.SDK_VERSION, uptime: process.uptime() }
+        }, { headers: { 'Authorization': `Bearer ${this.apiKey}` } });
+    }
+    async log(message, level = 'INFO') {
+        if (!this.agentId)
+            return;
+        if (this.localLogPath) {
+            try {
+                fs.appendFileSync(this.localLogPath, `[${new Date().toISOString()}] [${level}] ${message}\n`);
+            }
+            catch (err) { }
+        }
+        try {
+            await this.api.post(`agents/${this.agentId}/logs`, { message, level }, {
+                headers: { 'Authorization': `Bearer ${this.apiKey}` }
+            });
+            if (this.debug)
+                console.log(`[${level}] ${message}`);
+        }
+        catch (e) {
+            // 🚦 FIX: Silence or simplify 401 Auth errors for logging to prevent spam
+            if (e.response?.status === 401) {
+                if (this.debug)
+                    console.warn(`[SDK WARN] Logging auth failed (non-critical).`);
+            }
+            else {
+                if (this.debug)
+                    console.warn(`[SDK WARN] Log upload failed: ${e.message}`);
+            }
+        }
+    }
+    startHeartbeat(intervalMs = 30000) {
+        if (!this.agentId)
+            return;
+        if (this.heartbeatTimer)
+            clearInterval(this.heartbeatTimer);
+        this.sendHeartbeat();
+        this.heartbeatTimer = setInterval(() => this.sendHeartbeat(), intervalMs);
+    }
+    async sendHeartbeat() {
+        if (!this.agentId)
+            return;
+        try {
+            await this.api.post(`agents/${this.agentId}/heartbeat`, {}, {
+                headers: { 'Authorization': `Bearer ${this.apiKey}` }
+            });
+        }
+        catch (err) { }
+    }
+    logInternal(msg, level = 'INFO') {
+        if (this.debug)
+            console.log(`[SDK] ${msg}`);
+    }
+    onMessage(cb) { this.on('message', cb); }
+    onNewJob(cb) { this.on('job', cb); }
+    onHired(cb) { this.on('assignment', cb); }
+}
+exports.Agent = Agent;
+Agent.SDK_VERSION = CURRENT_VERSION;
+exports.default = Agent;