granclaw 0.0.1-beta.87 → 0.0.1-beta.89

package/dist/backend/agent/channel-broadcast.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WS_OPEN = void 0;
+exports.broadcastToClients = broadcastToClients;
+exports.getOrCreateChannelSet = getOrCreateChannelSet;
+exports.WS_OPEN = 1;
+function broadcastToClients(clients, data) {
+    const json = JSON.stringify(data);
+    let sent = 0;
+    for (const ws of clients) {
+        if (ws.readyState === exports.WS_OPEN) {
+            ws.send(json);
+            sent++;
+        }
+    }
+    return sent;
+}
+function getOrCreateChannelSet(map, channelId) {
+    let set = map.get(channelId);
+    if (!set) {
+        set = new Set();
+        map.set(channelId, set);
+    }
+    return set;
+}

package/dist/backend/agent/process.js

@@ -10,6 +10,7 @@ const path_1 = __importDefault(require("path"));
 const config_js_1 = require("../config.js");
 const agent_db_js_1 = require("../agent-db.js");
 const runner_pi_js_1 = require("./runner-pi.js");
+const channel_broadcast_js_1 = require("./channel-broadcast.js");
 const messages_db_js_1 = require("../messages-db.js");
 const telegram_adapter_js_1 = require("./telegram-adapter.js");
 const browser_sessions_js_1 = require("../browser-sessions.js");
@@ -36,9 +37,7 @@ function main() {
     const wss = new ws_1.WebSocketServer({ port });
     const channelClients = new Map();
     function getChannelClients(channelId) {
-        if (!channelClients.has(channelId))
-            channelClients.set(channelId, new Set());
-        return channelClients.get(channelId);
+        return (0, channel_broadcast_js_1.getOrCreateChannelSet)(channelClients, channelId);
     }
     wss.on('connection', (ws) => {
         let clientChannelId = 'ui';
@@ -84,14 +83,10 @@ function main() {
         telegramAdapter = new telegram_adapter_js_1.TelegramAdapter(agentId, telegramBotToken, workspaceDir);
     }
     function broadcastToChannel(channelId, data) {
-        const json = JSON.stringify(data);
         const targets = channelClients.get(channelId);
         if (!targets)
             return;
-        for (const ws of targets) {
-            if (ws.readyState === ws_1.WebSocket.OPEN)
-                ws.send(json);
-        }
+        (0, channel_broadcast_js_1.broadcastToClients)(targets, data);
     }
     const busyChannels = new Set();
     function channelType(channelId) {

package/dist/backend/agent/runner-pi.js

@@ -9,6 +9,7 @@ exports.bootstrapWorkspace = bootstrapWorkspace;
 exports.translateSessionEvent = translateSessionEvent;
 exports.stopAgent = stopAgent;
 exports.compactAgentSession = compactAgentSession;
+exports.classifyBrowserError = classifyBrowserError;
 exports.runAgent = runAgent;
 const path_1 = __importDefault(require("path"));
 const fs_1 = __importDefault(require("fs"));
@@ -267,6 +268,31 @@ function extractAgentName(workspaceDir) {
     }
     return null;
 }
+function classifyBrowserError(err, signal) {
+    const e = err;
+    if (signal?.aborted)
+        return 'ABORTED';
+    if (e?.name === 'AbortError' || e?.code === 'ABORT_ERR')
+        return 'ABORTED';
+    if (e?.killed === true && (e?.signal === 'SIGTERM' || e?.code === null))
+        return 'TIMEOUT';
+    if (e?.code === 'ETIMEDOUT')
+        return 'TIMEOUT';
+    const raw = `${e?.stderr ?? ''}\n${e?.stdout ?? ''}\n${e?.message ?? ''}`.toLowerCase();
+    if (raw.includes('econnrefused') ||
+        raw.includes('target closed') ||
+        raw.includes('session closed') ||
+        raw.includes('protocol error') ||
+        raw.includes('browser has disconnected') ||
+        raw.includes('cdp connection closed') ||
+        raw.includes('daemon not running') ||
+        raw.includes('no session')) {
+        return 'BROWSER_DIED';
+    }
+    if (raw.includes('timeout') || raw.includes('timed out'))
+        return 'TIMEOUT';
+    return 'CMD_ERROR';
+}
 function getLanIp() {
     const ifaces = (0, os_1.networkInterfaces)();
     for (const list of Object.values(ifaces)) {
@@ -306,6 +332,13 @@ async function runAgent(agent, message, onChunk, options) {
     catch { }
     let envKey;
     let prevValue;
+    let toolHeartbeat = null;
+    const stopHeartbeat = () => {
+        if (toolHeartbeat) {
+            clearInterval(toolHeartbeat);
+            toolHeartbeat = null;
+        }
+    };
     try {
         const { getModel } = await (0, esm_import_js_1.esmImport)('@mariozechner/pi-ai');
         const { createAgentSession, SessionManager, DefaultResourceLoader, getAgentDir } = await (0, esm_import_js_1.esmImport)('@mariozechner/pi-coding-agent');
@@ -698,6 +731,7 @@ async function runAgent(agent, message, onChunk, options) {
                     'You do not need to screenshot for audit — the whole session is recorded as video automatically.',
                     'Saved logins persist automatically when the user has set up a profile via the dashboard Browser view.',
                     'CAPTCHA & Cloudflare handling: the browser ships a stealth extension that handles Cloudflare JS interstitials ("Just a moment…") automatically (waits up to ~45s). If an actual CAPTCHA widget is detected (reCAPTCHA, hCaptcha, Turnstile, etc.), the runtime returns immediately with a warning — call request_human_browser_takeover right away.',
+                    'Error recovery: if a result contains "CATEGORY=BROWSER_DIED" the runtime has ALREADY respawned the browser — just retry the exact same command; do NOT tell the user the browser crashed. "CATEGORY=TIMEOUT" means the page is hung — try a different URL or approach. "CATEGORY=ABORTED" means the user cancelled — stop; do not retry. "CATEGORY=CMD_ERROR" is a genuine command problem — inspect the message.',
                     'Examples: {"command":"open","args":["https://example.com"]}, {"command":"click","args":["--ref","e12"]}, {"command":"fill","args":["--ref","e5","Alice"]}',
                 ],
                 parameters: {
@@ -715,7 +749,7 @@ async function runAgent(agent, message, onChunk, options) {
                     },
                     required: ['command'],
                 },
-                async execute(_toolCallId, params) {
+                async execute(_toolCallId, params, signal) {
                     const command = (params.command ?? '').trim();
                     const args = Array.isArray(params.args) ? params.args.map(String) : [];
                     if (!command) {
@@ -746,6 +780,7 @@ async function runAgent(agent, message, onChunk, options) {
                             timeout: 60_000,
                             maxBuffer: 10 * 1024 * 1024,
                             env: { ...process.env, ...browser.env },
+                            signal,
                         });
                         (0, session_manager_js_1.appendCommand)(browserState.handle, `${command} ${args.join(' ')}`.trim());
                         const out = stdout.trim() || stderr.trim() || 'ok';
@@ -753,9 +788,20 @@ async function runAgent(agent, message, onChunk, options) {
                     }
                     catch (err) {
                         (0, session_manager_js_1.appendCommand)(browserState.handle, `${command} ${args.join(' ')}`.trim());
+                        const category = classifyBrowserError(err, signal);
+                        if (category === 'BROWSER_DIED') {
+                            browserState.handle = null;
+                            return { content: [{ type: 'text', text: `browser session expired and has been restarted (CATEGORY=BROWSER_DIED) — retry the ${command} you were attempting; the runtime already handled the reset.` }] };
+                        }
+                        if (category === 'ABORTED') {
+                            return { content: [{ type: 'text', text: `browser ${command} was cancelled (CATEGORY=ABORTED)` }] };
+                        }
                         const e = err;
-                        const msg = (e.stderr || e.stdout || e.message || String(err)).trim();
-                        return { content: [{ type: 'text', text: `browser ${command} failed: ${msg}` }] };
+                        const raw = (e.stderr || e.stdout || e.message || String(err)).trim();
+                        if (category === 'TIMEOUT') {
+                            return { content: [{ type: 'text', text: `browser ${command} timed out after 60s (CATEGORY=TIMEOUT). Page is likely hung — try a different URL or fall back to fetch_website.` }] };
+                        }
+                        return { content: [{ type: 'text', text: `browser ${command} failed (CATEGORY=CMD_ERROR): ${raw}` }] };
                     }
                 },
             });
@@ -1004,7 +1050,7 @@ async function runAgent(agent, message, onChunk, options) {
             cwd: workspaceDir,
             agentDir,
             extensionFactories,
-            ...(appendSystemPrompt !== undefined ? { appendSystemPrompt } : {}),
+            ...(appendSystemPrompt !== undefined ? { appendSystemPrompt: [appendSystemPrompt] } : {}),
         });
         await resourceLoader.reload();
         const { session } = await createAgentSession({
@@ -1027,6 +1073,7 @@ async function runAgent(agent, message, onChunk, options) {
             console.error(`[runner-pi:${agent.id}] failed to configure auto-compaction:`, err);
         }
         let errorEmitted = false;
+        const HEARTBEAT_INTERVAL_MS = 30_000;
         session.subscribe((event) => {
             try {
                 switch (event.type) {
@@ -1042,9 +1089,20 @@ async function runAgent(agent, message, onChunk, options) {
                     case 'tool_execution_start': {
                         onChunk({ type: 'tool_call', tool: event.toolName, input: event.args });
                         (0, logs_db_js_1.logAction)(agent.id, 'tool_call', { tool: event.toolName, input: event.args });
+                        stopHeartbeat();
+                        toolHeartbeat = setInterval(() => {
+                            try {
+                                onChunk({ type: 'heartbeat' });
+                            }
+                            catch { }
+                        }, HEARTBEAT_INTERVAL_MS);
+                        if (typeof toolHeartbeat?.unref === 'function') {
+                            toolHeartbeat.unref();
+                        }
                         break;
                     }
                     case 'tool_execution_end': {
+                        stopHeartbeat();
                         const output = event.result;
                         const outputStr = typeof output === 'string' ? output : JSON.stringify(output);
                         onChunk({ type: 'tool_result', tool: event.toolName, output });
@@ -1167,6 +1225,7 @@ async function runAgent(agent, message, onChunk, options) {
         catch { }
     }
     finally {
+        stopHeartbeat();
         activeSessions.delete(agent.id);
         if (browserState.handle) {
             try {

package/dist/backend/browser/session-manager.js

@@ -119,7 +119,7 @@ async function startRecording(handle, res) {
     const started = await tryStart();
     if (!started)
         return false;
-    const FILE_APPEAR_TIMEOUT_MS = 5000;
+    const FILE_APPEAR_TIMEOUT_MS = 15_000;
     const FILE_APPEAR_POLL_MS = 100;
     const deadline = Date.now() + FILE_APPEAR_TIMEOUT_MS;
     let fileOk = false;
@@ -135,7 +135,7 @@ async function startRecording(handle, res) {
         await new Promise((r) => setTimeout(r, FILE_APPEAR_POLL_MS));
     }
     if (!fileOk) {
-        console.warn(`[browser/session-manager] record start reported success but ${recordingPath} did not materialize within ${FILE_APPEAR_TIMEOUT_MS}ms — check that ffmpeg is installed and the host is not overloaded`);
+        console.warn(`[browser/session-manager] record start reported success but ${recordingPath} did not materialize within ${FILE_APPEAR_TIMEOUT_MS}ms — session will proceed without WebM recording`);
         try {
             await execFileAsync(bin, stopArgv, { cwd: handle.workspaceDir, timeout: 5000 });
         }

package/dist/backend/index.js

@@ -5,12 +5,15 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 require("dotenv/config");
 const net_1 = __importDefault(require("net"));
+const node_events_1 = require("node:events");
 const server_js_1 = require("./orchestrator/server.js");
+(0, node_events_1.setMaxListeners)(50);
 const agent_manager_js_1 = require("./orchestrator/agent-manager.js");
 const scheduler_js_1 = require("./scheduler.js");
 const telemetry_js_1 = require("./telemetry.js");
 const config_js_1 = require("./config.js");
 const browser_sessions_js_1 = require("./browser-sessions.js");
+const workflows_db_js_1 = require("./workflows-db.js");
 const PORT = Number(process.env.PORT ?? 3001);
 function checkPortAvailable(port, label) {
     return new Promise((resolve, reject) => {
@@ -50,6 +53,15 @@ preflight()
         catch (err) {
             console.error(`[orchestrator] finalizeAllActiveSessions failed for ${agent.id}:`, err);
         }
+        try {
+            const flipped = (0, workflows_db_js_1.finalizeRunningRuns)(agent.id);
+            if (flipped > 0) {
+                console.log(`[orchestrator] finalized ${flipped} leftover running workflow run(s) for ${agent.id}`);
+            }
+        }
+        catch (err) {
+            console.error(`[orchestrator] finalizeRunningRuns failed for ${agent.id}:`, err);
+        }
     }
     (0, agent_manager_js_1.startAllAgents)();
     (0, scheduler_js_1.startScheduler)();

package/dist/backend/orchestrator/server.js

@@ -624,6 +624,26 @@ function createServer() {
         (0, agent_manager_js_1.restartAgent)(req.params.id);
         res.json({ ok: true });
     });
+    function resolveSkillsDir(workspaceDir) {
+        for (const candidate of ['.pi/skills', '.agent/skills', '.claude/skills']) {
+            const p = path_1.default.join(workspaceDir, candidate);
+            if (fs_1.default.existsSync(p))
+                return p;
+        }
+        return null;
+    }
+    function parseFrontmatter(content) {
+        const fm = content.match(/^---\n([\s\S]*?)\n---/);
+        if (!fm)
+            return {};
+        const out = {};
+        for (const line of fm[1].split('\n')) {
+            const m = line.match(/^([A-Za-z_-]+):\s*(.+)$/);
+            if (m)
+                out[m[1]] = m[2].trim();
+        }
+        return out;
+    }
     app.get('/agents/:id/skills', (req, res) => {
         const managed = (0, agent_manager_js_1.getManagedAgent)(req.params.id);
         if (!managed) {
@@ -631,11 +651,8 @@ function createServer() {
             return;
         }
         const workspaceDir = path_1.default.resolve(config_js_1.REPO_ROOT, managed.config.workspaceDir);
-        const agentSkillsDir = path_1.default.join(workspaceDir, '.agent', 'skills');
-        const skillsDir = fs_1.default.existsSync(agentSkillsDir)
-            ? agentSkillsDir
-            : path_1.default.join(workspaceDir, '.claude', 'skills');
-        if (!fs_1.default.existsSync(skillsDir)) {
+        const skillsDir = resolveSkillsDir(workspaceDir);
+        if (!skillsDir) {
             res.json({ skills: [] });
             return;
         }
@@ -646,19 +663,49 @@ function createServer() {
             const skillMd = path_1.default.join(skillsDir, entry.name, 'SKILL.md');
             if (!fs_1.default.existsSync(skillMd))
                 continue;
-            const content = fs_1.default.readFileSync(skillMd, 'utf8');
-            const fmMatch = content.match(/^---\n([\s\S]*?)\n---/);
-            if (!fmMatch)
+            const fm = parseFrontmatter(fs_1.default.readFileSync(skillMd, 'utf8'));
+            if (!fm.name && !fm.description)
                 continue;
-            const nameMatch = fmMatch[1].match(/^name:\s*(.+)/m);
-            const descMatch = fmMatch[1].match(/^description:\s*(.+)/m);
             skills.push({
-                name: nameMatch?.[1]?.trim() ?? entry.name,
-                description: descMatch?.[1]?.trim() ?? '',
+                name: fm.name ?? entry.name,
+                description: fm.description ?? '',
+                userInvocable: fm['user-invocable'] === 'true',
             });
         }
+        skills.sort((a, b) => a.name.localeCompare(b.name));
         res.json({ skills });
     });
+    app.get('/agents/:id/skills/:name', (req, res) => {
+        const managed = (0, agent_manager_js_1.getManagedAgent)(req.params.id);
+        if (!managed) {
+            res.status(404).json({ error: 'Agent not found' });
+            return;
+        }
+        const workspaceDir = path_1.default.resolve(config_js_1.REPO_ROOT, managed.config.workspaceDir);
+        const skillsDir = resolveSkillsDir(workspaceDir);
+        if (!skillsDir) {
+            res.status(404).json({ error: 'No skills directory' });
+            return;
+        }
+        const requested = path_1.default.resolve(skillsDir, req.params.name, 'SKILL.md');
+        if (!requested.startsWith(skillsDir + path_1.default.sep)) {
+            res.status(400).json({ error: 'Invalid skill name' });
+            return;
+        }
+        if (!fs_1.default.existsSync(requested)) {
+            res.status(404).json({ error: 'Skill not found' });
+            return;
+        }
+        const content = fs_1.default.readFileSync(requested, 'utf8');
+        const fm = parseFrontmatter(content);
+        res.json({
+            name: fm.name ?? req.params.name,
+            description: fm.description ?? '',
+            userInvocable: fm['user-invocable'] === 'true',
+            allowedTools: fm['allowed-tools'] ?? '',
+            content,
+        });
+    });
     app.get('/agents/:id/tasks', (req, res) => {
         const managed = (0, agent_manager_js_1.getManagedAgent)(req.params.id);
         if (!managed) {
@@ -1002,7 +1049,11 @@ function createServer() {
             res.status(404).json({ error: 'Agent not found' });
             return;
         }
-        res.json((0, workflows_db_js_1.listWorkflows)(req.params.id));
+        const workflows = (0, workflows_db_js_1.listWorkflows)(req.params.id).map(w => ({
+            ...w,
+            lastRun: (0, workflows_db_js_1.getLatestRun)(req.params.id, w.id),
+        }));
+        res.json(workflows);
     });
     app.post('/agents/:id/workflows', (req, res) => {
         const managed = (0, agent_manager_js_1.getManagedAgent)(req.params.id);

package/dist/backend/workflows-db.js

@@ -18,6 +18,8 @@ exports.getRun = getRun;
 exports.createRunStep = createRunStep;
 exports.updateRunStep = updateRunStep;
 exports.getRunningRuns = getRunningRuns;
+exports.finalizeRunningRuns = finalizeRunningRuns;
+exports.getLatestRun = getLatestRun;
 exports.closeWorkflowsDb = closeWorkflowsDb;
 const path_1 = __importDefault(require("path"));
 const crypto_1 = require("crypto");
@@ -213,6 +215,41 @@ function getRunningRuns(agentId) {
         return [];
     }
 }
+function finalizeRunningRuns(agentId) {
+    try {
+        const db = getDb(agentId);
+        const now = Date.now();
+        const err = 'Run interrupted — backend restarted while executing.';
+        db.prepare(`
+      UPDATE run_steps SET status = 'failed', error = COALESCE(error, ?), finished_at = COALESCE(finished_at, ?)
+      WHERE status = 'running'
+    `).run(err, now);
+        db.prepare(`
+      UPDATE run_steps SET status = 'skipped'
+      WHERE status = 'pending' AND run_id IN (SELECT id FROM runs WHERE status = 'running')
+    `).run();
+        const result = db.prepare(`
+      UPDATE runs SET status = 'failed', finished_at = COALESCE(finished_at, ?)
+      WHERE status = 'running'
+    `).run(now);
+        return result.changes ?? 0;
+    }
+    catch {
+        return 0;
+    }
+}
+function getLatestRun(agentId, workflowId) {
+    try {
+        const db = getDb(agentId);
+        const row = db.prepare(`
+      SELECT * FROM runs WHERE workflow_id = ? ORDER BY started_at DESC LIMIT 1
+    `).get(workflowId);
+        return row ? rowToRun(row) : null;
+    }
+    catch {
+        return null;
+    }
+}
 function closeWorkflowsDb(agentId) {
     const agent = (0, config_js_1.getAgent)(agentId);
     if (!agent)