@monoes/monomindcli 1.10.30 → 1.10.31

package/.claude/helpers/handlers/adr-draft-handler.cjs

@@ -0,0 +1,64 @@
+'use strict';
+// Extracted from hook-handler.cjs — handles 'adr-draft' command.
+// Drafts an ADR from accumulated decision markers in .monomind/decisions.jsonl.
+// Receives hCtx from dispatcher. See route-handler.cjs for hCtx field docs.
+
+const path = require('path');
+const fs = require('fs');
+
+module.exports = {
+  handle: function(hCtx) {
+    var CWD = hCtx.CWD;
+
+    var jsonl = path.join(CWD, '.monomind', 'decisions.jsonl');
+    if (!fs.existsSync(jsonl)) {
+      console.log('[ADR] No decisions recorded yet. Type prompts containing markers like "let\'s go with X", "we chose Y", "decision: Z" to populate the log.');
+      return;
+    }
+    var lines = fs.readFileSync(jsonl, 'utf-8').trim().split('\n').filter(Boolean);
+    if (lines.length === 0) {
+      console.log('[ADR] decisions.jsonl is empty.');
+      return;
+    }
+    // Group decisions captured in the last 7 days.
+    var cutoff = Date.now() - 7 * 24 * 60 * 60 * 1000;
+    var recent = lines
+      .map(function(l) { try { return JSON.parse(l); } catch (_) { return null; } })
+      .filter(function(d) { return d && d.ts >= cutoff; });
+    if (recent.length === 0) {
+      console.log('[ADR] No decisions in the last 7 days. Older entries: ' + lines.length + '.');
+      return;
+    }
+
+    var adrsDir = path.join(CWD, 'docs', 'adrs');
+    try { fs.mkdirSync(adrsDir, { recursive: true }); } catch (_) {}
+    var existing = [];
+    try { existing = fs.readdirSync(adrsDir).filter(function(f) { return /^ADR-\d{4}/.test(f); }); } catch (_) {}
+    var nextNum = existing.length + 1;
+    var num = String(nextNum).padStart(4, '0');
+    var stamp = new Date().toISOString().slice(0, 10);
+    var fname = 'ADR-' + num + '-' + stamp + '-session-decisions.md';
+    var outPath = path.join(adrsDir, fname);
+
+    var body = '# ADR-' + num + ': Session decisions (' + stamp + ')\n\n' +
+               '**Status:** Proposed\n**Date:** ' + stamp + '\n\n' +
+               '## Context\n\n' +
+               'During recent sessions, the following decision markers were captured ' +
+               'from user prompts. Each excerpt is the surrounding sentence at the time.\n\n' +
+               '## Decisions\n\n';
+    for (var i = 0; i < recent.length; i++) {
+      var d = recent[i];
+      var date = new Date(d.ts).toISOString().slice(0, 16).replace('T', ' ');
+      body += '### ' + (i + 1) + '. ' + date + '\n\n';
+      for (var j = 0; j < d.excerpts.length; j++) {
+        body += '> ' + d.excerpts[j].trim() + '\n\n';
+      }
+      if (d.prompt) body += '_Prompt:_ ' + d.prompt.slice(0, 200) + (d.prompt.length > 200 ? '…' : '') + '\n\n';
+    }
+    body += '## Consequences\n\n_(fill in after review)_\n\n' +
+            '## Status\n\nProposed — awaiting human review and refinement.\n';
+    fs.writeFileSync(outPath, body);
+    console.log('[ADR_DRAFT] Wrote ' + recent.length + ' decision(s) to ' + outPath);
+    console.log('  Edit the file to fill in Context and Consequences, then change Status to Accepted/Rejected.');
+  },
+};

package/.claude/helpers/handlers/agent-start-handler.cjs

@@ -0,0 +1,99 @@
+'use strict';
+// Extracted from hook-handler.cjs — handles 'agent-start' (SubagentStart) hook event.
+// Receives hCtx from dispatcher. See route-handler.cjs for hCtx field docs.
+
+const path = require('path');
+const fs = require('fs');
+
+module.exports = {
+  handle: function(hCtx) {
+    var hookInput = hCtx.hookInput;
+    var CWD = hCtx.CWD;
+    var _openMonographDb = hCtx._openMonographDb;
+    var getMonographSuggestions = hCtx.getMonographSuggestions;
+
+    // Register this agent so the statusline can count active agents.
+    const regDir = path.join(CWD, '.monomind', 'agents', 'registrations');
+    try {
+      fs.mkdirSync(regDir, { recursive: true });
+      const id = Date.now() + '-' + Math.random().toString(36).slice(2, 6);
+      const regFile = path.join(regDir, 'agent-' + id + '.json');
+      fs.writeFileSync(regFile, JSON.stringify({
+        agentId: id,
+        startedAt: new Date().toISOString(),
+        pid: process.pid,
+      }));
+      // Refresh swarm-activity.json within the 5-min staleness window.
+      const activityDir = path.join(CWD, '.monomind', 'metrics');
+      fs.mkdirSync(activityDir, { recursive: true });
+      const activityPath = path.join(activityDir, 'swarm-activity.json');
+      const active = fs.readdirSync(regDir).filter(f => f.endsWith('.json')).length;
+      // Preserve lastActive (peak) so statusline shows non-zero after completion.
+      let prevLastActive = 0;
+      try { prevLastActive = (JSON.parse(fs.readFileSync(activityPath, 'utf-8'))?.swarm?.lastActive) || 0; } catch { /* ignore */ }
+      fs.writeFileSync(activityPath, JSON.stringify({
+        timestamp: new Date().toISOString(),
+        swarm: {
+          active: active > 0,
+          agent_count: active,
+          coordination_active: active > 0,
+          lastActive: Math.max(active, prevLastActive),
+        },
+      }));
+
+      // Write last-dispatch.json so the route handler can suppress redundant
+      // suggestions on the next turn when the same agent type is recommended.
+      const agentType = hookInput.subagent_type || hookInput.agentType || hookInput.agent_type || hookInput.agentSlug || 'unknown';
+      const agentDesc = hookInput.description || hookInput.prompt_description || '';
+      fs.writeFileSync(
+        path.join(CWD, '.monomind', 'last-dispatch.json'),
+        JSON.stringify({
+          agentType: agentType,
+          description: agentDesc.substring(0, 120),
+          dispatchedAt: new Date().toISOString(),
+        }),
+        'utf-8'
+      );
+    } catch (e) { /* non-fatal — never block a subagent from starting */ }
+
+    // Subagent context inheritance — inject graph god nodes + parent's last
+    // pre-resolved suggestions so the spawned agent inherits spatial map.
+    try {
+      var subDb = _openMonographDb();
+      if (subDb) {
+        try {
+          var godRows = subDb.prepare(
+            "SELECT n.name, n.label, n.file_path AS file, " +
+            "(SELECT COUNT(*) FROM edges WHERE source_id=n.id OR target_id=n.id) AS deg " +
+            "FROM nodes n " +
+            "WHERE n.label NOT IN ('Concept') AND n.file_path IS NOT NULL AND n.file_path != '' " +
+            "ORDER BY deg DESC LIMIT 5"
+          ).all();
+          if (godRows.length > 0) {
+            console.log('[MONOGRAPH_SUBAGENT_CTX] Graph map inherited from parent:');
+            for (var gi = 0; gi < godRows.length; gi++) {
+              var gr = godRows[gi];
+              console.log('  · ' + gr.name + ' [' + gr.label + '] — ' + (gr.file || '') + ' (deg ' + gr.deg + ')');
+            }
+            try {
+              var subAgentDesc = hookInput.description || hookInput.prompt_description || '';
+              if (subAgentDesc && subAgentDesc.length > 8) {
+                var subHints = getMonographSuggestions(subAgentDesc, 3);
+                if (subHints.length > 0) {
+                  console.log('  Top files for this subagent task:');
+                  for (var si2 = 0; si2 < subHints.length; si2++) {
+                    var sh = subHints[si2];
+                    console.log('    · ' + sh.name + ' [' + sh.label + '] — ' + (sh.file || ''));
+                  }
+                }
+              }
+            } catch (_) {}
+            console.log('  Use mcp__monomind__monograph_suggest / monograph_query in this subagent before grepping.');
+          }
+        } catch (e) { /* non-fatal */ }
+      }
+    } catch (e) { /* non-fatal */ }
+
+    console.log('[OK] Agent registered');
+  },
+};

package/.claude/helpers/handlers/graph-status-handler.cjs

@@ -0,0 +1,38 @@
+'use strict';
+// Extracted from hook-handler.cjs — handles 'graph-status' command.
+// Shows monograph node/edge counts and graph-vs-grep usage ratio.
+// Receives hCtx from dispatcher. See route-handler.cjs for hCtx field docs.
+
+const path = require('path');
+const fs = require('fs');
+
+module.exports = {
+  handle: function(hCtx) {
+    var CWD = hCtx.CWD;
+    var _openMonographDb = hCtx._openMonographDb;
+
+    var db = _openMonographDb();
+    if (!db) {
+      console.log('No monograph.db found. Run /monomind:understand to build.');
+      return;
+    }
+    try {
+      var n = db.prepare("SELECT COUNT(*) AS c FROM nodes").get().c;
+      var e = db.prepare("SELECT COUNT(*) AS c FROM edges").get().c;
+      var usage = (function() {
+        try { return JSON.parse(fs.readFileSync(path.join(CWD, '.monomind', 'metrics', 'graph-usage.json'), 'utf-8')); }
+        catch (_) { return {}; }
+      })();
+      var wins = (usage.monograph_call || 0) + (usage.preresolve_hit || 0)
+               + (usage.graph_assist_search || 0) + (usage.graph_assist_neighbors || 0);
+      var search = (usage.grep_call || 0) + (usage.glob_call || 0)
+                 + (usage.bash_grep_call || 0) + (usage.bash_find_call || 0);
+      var pct = (wins + search) > 0 ? Math.round((wins / (wins + search)) * 100) : 0;
+      var saved = usage.dollars_saved || 0;
+      console.log('Monograph: ' + n.toLocaleString() + ' nodes · ' + e.toLocaleString() + ' edges');
+      console.log('Usage: ' + pct + '% graph · ' + (100 - pct) + '% grep · ' +
+                  'wins=' + wins + ' search=' + search +
+                  (saved > 0 ? ' · saved $' + saved.toFixed(2) : ''));
+    } catch (err) { console.log('Error: ' + err.message); }
+  },
+};

package/.claude/helpers/handlers/session-restore-handler.cjs

@@ -31,50 +31,55 @@ module.exports = {
     } catch (e) { console.log('[WARN] Session restore failed: ' + e.message); }
 
     // Stale helper detection — warn when project helpers drift from the bundled npm copy.
+    // Skip when running inside the monomind dev repo itself: local helpers ARE the
+    // source of truth there, so any diff vs. the npm global install is expected.
     try {
-      var crypto = require('crypto');
-      function _findBundledHelpers() {
-        var helperPaths = [
-          path.join(helpersDir),
-          path.join(CWD, 'node_modules', 'monomind', '.claude', 'helpers'),
-          path.join(CWD, 'node_modules', '@monoes', 'monomindcli', '.claude', 'helpers'),
-        ];
-        try {
-          var globalRoot = require('child_process')
-            .execSync('npm root -g 2>/dev/null', { encoding: 'utf-8', timeout: 2000 })
-            .trim();
-          if (globalRoot) {
-            helperPaths.push(path.join(globalRoot, 'monomind', '.claude', 'helpers'));
-            helperPaths.push(path.join(globalRoot, '@monoes', 'monomindcli', '.claude', 'helpers'));
-          }
-        } catch (_) {}
-        for (var i = 0; i < helperPaths.length; i++) {
-          if (fs.existsSync(path.join(helperPaths[i], 'hook-handler.cjs')) &&
-              helperPaths[i] !== path.join(CWD, '.claude', 'helpers')) {
-            return helperPaths[i];
-          }
-        }
-        return null;
-      }
-
-      var bundledDir = _findBundledHelpers();
-      if (bundledDir) {
-        var helpersToCheck = ['hook-handler.cjs', 'statusline.cjs'];
-        var stale = [];
-        for (var hi = 0; hi < helpersToCheck.length; hi++) {
-          var hName = helpersToCheck[hi];
-          var localF   = path.join(CWD, '.claude', 'helpers', hName);
-          var bundledF = path.join(bundledDir, hName);
-          if (!fs.existsSync(localF) || !fs.existsSync(bundledF)) continue;
+      var _isDevRepo = fs.existsSync(path.join(CWD, 'packages', '@monomind', 'cli', 'package.json'));
+      if (!_isDevRepo) {
+        var crypto = require('crypto');
+        function _findBundledHelpers() {
+          var helperPaths = [
+            path.join(helpersDir),
+            path.join(CWD, 'node_modules', 'monomind', '.claude', 'helpers'),
+            path.join(CWD, 'node_modules', '@monoes', 'monomindcli', '.claude', 'helpers'),
+          ];
           try {
-            var hashL = crypto.createHash('sha256').update(fs.readFileSync(localF)).digest('hex');
-            var hashB = crypto.createHash('sha256').update(fs.readFileSync(bundledF)).digest('hex');
-            if (hashL !== hashB) stale.push(hName);
+            var globalRoot = require('child_process')
+              .execSync('npm root -g 2>/dev/null', { encoding: 'utf-8', timeout: 2000 })
+              .trim();
+            if (globalRoot) {
+              helperPaths.push(path.join(globalRoot, 'monomind', '.claude', 'helpers'));
+              helperPaths.push(path.join(globalRoot, '@monoes', 'monomindcli', '.claude', 'helpers'));
+            }
           } catch (_) {}
+          for (var i = 0; i < helperPaths.length; i++) {
+            if (fs.existsSync(path.join(helperPaths[i], 'hook-handler.cjs')) &&
+                helperPaths[i] !== path.join(CWD, '.claude', 'helpers')) {
+              return helperPaths[i];
+            }
+          }
+          return null;
         }
-        if (stale.length > 0) {
-          console.log('[STALE_HELPERS] Project helpers differ from bundled version: ' + stale.join(', '));
-          console.log('  Run `npx monomind@latest init upgrade` to refresh and pick up the latest features.');
+
+        var bundledDir = _findBundledHelpers();
+        if (bundledDir) {
+          var helpersToCheck = ['hook-handler.cjs', 'statusline.cjs'];
+          var stale = [];
+          for (var hi = 0; hi < helpersToCheck.length; hi++) {
+            var hName = helpersToCheck[hi];
+            var localF   = path.join(CWD, '.claude', 'helpers', hName);
+            var bundledF = path.join(bundledDir, hName);
+            if (!fs.existsSync(localF) || !fs.existsSync(bundledF)) continue;
+            try {
+              var hashL = crypto.createHash('sha256').update(fs.readFileSync(localF)).digest('hex');
+              var hashB = crypto.createHash('sha256').update(fs.readFileSync(bundledF)).digest('hex');
+              if (hashL !== hashB) stale.push(hName);
+            } catch (_) {}
+          }
+          if (stale.length > 0) {
+            console.log('[STALE_HELPERS] Project helpers differ from bundled version: ' + stale.join(', '));
+            console.log('  Run `npx monomind@latest init upgrade` to refresh and pick up the latest features.');
+          }
         }
       }
     } catch (e) { /* non-fatal */ }

package/.claude/helpers/hook-handler.cjs

@@ -279,170 +279,18 @@ const handlers = {
   },
 
   'agent-start': () => {
-    // Called by SubagentStart hook — register this agent so the statusline can count it
-    const regDir = path.join(CWD, '.monomind', 'agents', 'registrations');
-    try {
-      fs.mkdirSync(regDir, { recursive: true });
-      const id = Date.now() + '-' + Math.random().toString(36).slice(2, 6);
-      const regFile = path.join(regDir, 'agent-' + id + '.json');
-      fs.writeFileSync(regFile, JSON.stringify({
-        agentId: id,
-        startedAt: new Date().toISOString(),
-        pid: process.pid,
-      }));
-      // Also refresh swarm-activity.json so it's within the 5-min staleness window
-      const activityDir = path.join(CWD, '.monomind', 'metrics');
-      fs.mkdirSync(activityDir, { recursive: true });
-      const activityPath = path.join(activityDir, 'swarm-activity.json');
-      const active = fs.readdirSync(regDir).filter(f => f.endsWith('.json')).length;
-      // Preserve lastActive (peak) across agent lifecycle so statusline shows non-zero after completion
-      let prevLastActive = 0;
-      try { prevLastActive = (JSON.parse(fs.readFileSync(activityPath, 'utf-8'))?.swarm?.lastActive) || 0; } catch { /* ignore */ }
-      fs.writeFileSync(activityPath, JSON.stringify({
-        timestamp: new Date().toISOString(),
-        swarm: {
-          active: active > 0,
-          agent_count: active,
-          coordination_active: active > 0,
-          lastActive: Math.max(active, prevLastActive),
-        },
-      }));
-
-      // Write last-dispatch.json so the route handler can suppress redundant suggestions
-      // on the next turn when the same type of agent is recommended.
-      const agentType = hookInput.subagent_type || hookInput.agentType || hookInput.agent_type || hookInput.agentSlug || 'unknown';
-      const agentDesc = hookInput.description || hookInput.prompt_description || '';
-      fs.writeFileSync(
-        path.join(CWD, '.monomind', 'last-dispatch.json'),
-        JSON.stringify({
-          agentType: agentType,
-          description: agentDesc.substring(0, 120),
-          dispatchedAt: new Date().toISOString(),
-        }),
-        'utf-8'
-      );
-    } catch (e) { /* non-fatal — never block a subagent from starting */ }
-
-    // Subagent context inheritance — inject graph god nodes + parent's last
-    // pre-resolved suggestions so the spawned agent inherits spatial map
-    // instead of starting blind.
-    try {
-      var subDb = _openMonographDb();
-      if (subDb) {
-        try {
-          var godRows = subDb.prepare(
-            "SELECT n.name, n.label, n.file_path AS file, " +
-            "(SELECT COUNT(*) FROM edges WHERE source_id=n.id OR target_id=n.id) AS deg " +
-            "FROM nodes n " +
-            "WHERE n.label NOT IN ('Concept') AND n.file_path IS NOT NULL AND n.file_path != '' " +
-            "ORDER BY deg DESC LIMIT 5"
-          ).all();
-          if (godRows.length > 0) {
-            console.log('[MONOGRAPH_SUBAGENT_CTX] Graph map inherited from parent:');
-            for (var gi = 0; gi < godRows.length; gi++) {
-              var gr = godRows[gi];
-              console.log('  · ' + gr.name + ' [' + gr.label + '] — ' + (gr.file || '') + ' (deg ' + gr.deg + ')');
-            }
-            // Also forward parent's last routing suggestion text if any
-            try {
-              var subAgentDesc = hookInput.description || hookInput.prompt_description || '';
-              if (subAgentDesc && subAgentDesc.length > 8) {
-                var subHints = getMonographSuggestions(subAgentDesc, 3);
-                if (subHints.length > 0) {
-                  console.log('  Top files for this subagent task:');
-                  for (var si2 = 0; si2 < subHints.length; si2++) {
-                    var sh = subHints[si2];
-                    console.log('    · ' + sh.name + ' [' + sh.label + '] — ' + (sh.file || ''));
-                  }
-                }
-              }
-            } catch (_) {}
-            console.log('  Use mcp__monomind__monograph_suggest / monograph_query in this subagent before grepping.');
-          }
-        } catch (e) { /* non-fatal */ }
-      }
-    } catch (e) { /* non-fatal */ }
-
-    console.log('[OK] Agent registered');
+    const h = require('./handlers/agent-start-handler.cjs');
+    h.handle(hCtx);
   },
 
-  // Draft an ADR from accumulated decision markers in .monomind/decisions.jsonl.
-  // Usage: node hook-handler.cjs adr-draft   (or via /adr slash command)
   'adr-draft': () => {
-    var jsonl = path.join(CWD, '.monomind', 'decisions.jsonl');
-    if (!fs.existsSync(jsonl)) {
-      console.log('[ADR] No decisions recorded yet. Type prompts containing markers like "let\'s go with X", "we chose Y", "decision: Z" to populate the log.');
-      return;
-    }
-    var lines = fs.readFileSync(jsonl, 'utf-8').trim().split('\n').filter(Boolean);
-    if (lines.length === 0) {
-      console.log('[ADR] decisions.jsonl is empty.');
-      return;
-    }
-    // Group decisions captured in the last 7 days
-    var cutoff = Date.now() - 7 * 24 * 60 * 60 * 1000;
-    var recent = lines.map(function(l) { try { return JSON.parse(l); } catch (_) { return null; } })
-                       .filter(function(d) { return d && d.ts >= cutoff; });
-    if (recent.length === 0) {
-      console.log('[ADR] No decisions in the last 7 days. Older entries: ' + lines.length + '.');
-      return;
-    }
-
-    var adrsDir = path.join(CWD, 'docs', 'adrs');
-    try { fs.mkdirSync(adrsDir, { recursive: true }); } catch (_) {}
-    // Pick next ADR number
-    var existing = [];
-    try { existing = fs.readdirSync(adrsDir).filter(function(f) { return /^ADR-\d{4}/.test(f); }); } catch (_) {}
-    var nextNum = existing.length + 1;
-    var num = String(nextNum).padStart(4, '0');
-    var stamp = new Date().toISOString().slice(0,10);
-    var slug = 'session-decisions';
-    var fname = 'ADR-' + num + '-' + stamp + '-' + slug + '.md';
-    var outPath = path.join(adrsDir, fname);
-
-    var body = '# ADR-' + num + ': Session decisions (' + stamp + ')\n\n' +
-               '**Status:** Proposed\n**Date:** ' + stamp + '\n\n' +
-               '## Context\n\n' +
-               'During recent sessions, the following decision markers were captured ' +
-               'from user prompts. Each excerpt is the surrounding sentence at the time.\n\n' +
-               '## Decisions\n\n';
-    for (var i = 0; i < recent.length; i++) {
-      var d = recent[i];
-      var date = new Date(d.ts).toISOString().slice(0,16).replace('T',' ');
-      body += '### ' + (i + 1) + '. ' + date + '\n\n';
-      for (var j = 0; j < d.excerpts.length; j++) {
-        body += '> ' + d.excerpts[j].trim() + '\n\n';
-      }
-      if (d.prompt) body += '_Prompt:_ ' + d.prompt.slice(0, 200) + (d.prompt.length > 200 ? '…' : '') + '\n\n';
-    }
-    body += '## Consequences\n\n_(fill in after review)_\n\n' +
-            '## Status\n\nProposed — awaiting human review and refinement.\n';
-    fs.writeFileSync(outPath, body);
-    console.log('[ADR_DRAFT] Wrote ' + recent.length + ' decision(s) to ' + outPath);
-    console.log('  Edit the file to fill in Context and Consequences, then change Status to Accepted/Rejected.');
+    const h = require('./handlers/adr-draft-handler.cjs');
+    h.handle(hCtx);
   },
 
   'graph-status': () => {
-    var db = _openMonographDb();
-    if (!db) { console.log('No monograph.db found. Run /monomind:understand to build.'); return; }
-    try {
-      var n = db.prepare("SELECT COUNT(*) AS c FROM nodes").get().c;
-      var e = db.prepare("SELECT COUNT(*) AS c FROM edges").get().c;
-      var usage = (function() {
-        try { return JSON.parse(fs.readFileSync(path.join(CWD, '.monomind', 'metrics', 'graph-usage.json'), 'utf-8')); }
-        catch (_) { return {}; }
-      })();
-      var wins = (usage.monograph_call || 0) + (usage.preresolve_hit || 0)
-               + (usage.graph_assist_search || 0) + (usage.graph_assist_neighbors || 0);
-      var search = (usage.grep_call || 0) + (usage.glob_call || 0)
-                 + (usage.bash_grep_call || 0) + (usage.bash_find_call || 0);
-      var pct = (wins + search) > 0 ? Math.round((wins / (wins + search)) * 100) : 0;
-      var saved = usage.dollars_saved || 0;
-      console.log('Monograph: ' + n.toLocaleString() + ' nodes · ' + e.toLocaleString() + ' edges');
-      console.log('Usage: ' + pct + '% graph · ' + (100 - pct) + '% grep · ' +
-                  'wins=' + wins + ' search=' + search +
-                  (saved > 0 ? ' · saved $' + saved.toFixed(2) : ''));
-    } catch (err) { console.log('Error: ' + err.message); }
+    const h = require('./handlers/graph-status-handler.cjs');
+    h.handle(hCtx);
   },
 
   'budget-status': () => {

package/dist/src/browser/actions.d.ts

@@ -9,5 +9,20 @@ export declare function scrollElement(client: CdpClient, sessionId: string, dire
 export declare function hoverElement(client: CdpClient, sessionId: string, ref: ElementRef): Promise<void>;
 export declare function selectOption(client: CdpClient, sessionId: string, ref: ElementRef, value: string): Promise<void>;
 export declare function checkElement(client: CdpClient, sessionId: string, ref: ElementRef, checked?: boolean): Promise<void>;
+export declare function focusElement(client: CdpClient, sessionId: string, ref: ElementRef): Promise<void>;
+export declare function typeIntoElement(client: CdpClient, sessionId: string, ref: ElementRef, text: string): Promise<void>;
+export declare function keyDown(client: CdpClient, sessionId: string, key: string): Promise<void>;
+export declare function keyUp(client: CdpClient, sessionId: string, key: string): Promise<void>;
+export declare function mouseMove(client: CdpClient, sessionId: string, x: number, y: number): Promise<void>;
+export declare function mouseDown(client: CdpClient, sessionId: string, x: number, y: number, button?: 'left' | 'right' | 'middle'): Promise<void>;
+export declare function mouseUp(client: CdpClient, sessionId: string, x: number, y: number, button?: 'left' | 'right' | 'middle'): Promise<void>;
+export declare function mouseWheel(client: CdpClient, sessionId: string, x: number, y: number, deltaY: number, deltaX?: number): Promise<void>;
+export declare function dragAndDrop(client: CdpClient, sessionId: string, src: ElementRef, tgt: ElementRef): Promise<void>;
+export declare function uploadFile(client: CdpClient, sessionId: string, ref: ElementRef, filePaths: string[]): Promise<void>;
+export declare function readClipboard(client: CdpClient, sessionId: string): Promise<string>;
+export declare function writeClipboard(client: CdpClient, sessionId: string, text: string): Promise<void>;
+export declare function pushState(client: CdpClient, sessionId: string, url: string): Promise<void>;
+export declare function addInitScript(client: CdpClient, sessionId: string, script: string): Promise<string>;
+export declare function removeInitScript(client: CdpClient, sessionId: string, identifier: string): Promise<void>;
 export declare function evaluateJs(client: CdpClient, sessionId: string, expression: string): Promise<unknown>;
 //# sourceMappingURL=actions.d.ts.map

package/dist/src/browser/actions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../../src/browser/actions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG3D,wBAAsB,YAAY,CAChC,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,UAAU,EACf,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,IAAI,CAAC,CAmBf;AAED,wBAAsB,UAAU,CAC9B,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,EACjB,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,IAAI,CAAC,CAWf;AAED,wBAAsB,WAAW,CAC/B,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,UAAU,EACf,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC,CA6Bf;AAED,wBAAsB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEhG;AAED,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,IAAI,CAAC,CAmBf;AA+BD,wBAAsB,aAAa,CACjC,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,EAC3C,MAAM,SAAM,EACZ,GAAG,CAAC,EAAE,UAAU,GACf,OAAO,CAAC,IAAI,CAAC,CAkCf;AAED,wBAAsB,YAAY,CAChC,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,UAAU,GACd,OAAO,CAAC,IAAI,CAAC,CASf;AAED,wBAAsB,YAAY,CAChC,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,UAAU,EACf,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC,CAmBf;AAED,wBAAsB,YAAY,CAChC,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,UAAU,EACf,OAAO,UAAO,GACb,OAAO,CAAC,IAAI,CAAC,CAaf;AAED,wBAAsB,UAAU,CAC9B,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,OAAO,CAAC,CAelB"}
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../../src/browser/actions.ts"],"names":[],"mappings":"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"}

package/dist/src/browser/actions.js

@@ -187,6 +187,97 @@ export async function checkElement(client, sessionId, ref, checked = true) {
         arguments: [{ value: checked }],
     }, sessionId);
 }
+export async function focusElement(client, sessionId, ref) {
+    const objectId = await getObjectIdForRef(client, sessionId, ref);
+    if (objectId) {
+        await client.send('Runtime.callFunctionOn', {
+            functionDeclaration: 'function() { this.focus(); }',
+            objectId,
+        }, sessionId);
+        return;
+    }
+    const box = await getElementBox(client, sessionId, ref);
+    if (box)
+        await clickPoint(client, sessionId, box.x, box.y);
+}
+export async function typeIntoElement(client, sessionId, ref, text) {
+    await focusElement(client, sessionId, ref);
+    await typeText(client, sessionId, text);
+}
+export async function keyDown(client, sessionId, key) {
+    const keyInfo = resolveKey(key);
+    await client.send('Input.dispatchKeyEvent', { type: 'keyDown', ...keyInfo }, sessionId);
+}
+export async function keyUp(client, sessionId, key) {
+    const keyInfo = resolveKey(key);
+    await client.send('Input.dispatchKeyEvent', { type: 'keyUp', ...keyInfo }, sessionId);
+}
+export async function mouseMove(client, sessionId, x, y) {
+    await client.send('Input.dispatchMouseEvent', { type: 'mouseMoved', x, y }, sessionId);
+}
+export async function mouseDown(client, sessionId, x, y, button = 'left') {
+    await client.send('Input.dispatchMouseEvent', { type: 'mousePressed', x, y, button, buttons: 1, clickCount: 1 }, sessionId);
+}
+export async function mouseUp(client, sessionId, x, y, button = 'left') {
+    await client.send('Input.dispatchMouseEvent', { type: 'mouseReleased', x, y, button, buttons: 0, clickCount: 1 }, sessionId);
+}
+export async function mouseWheel(client, sessionId, x, y, deltaY, deltaX = 0) {
+    await client.send('Input.dispatchMouseEvent', { type: 'mouseWheel', x, y, deltaX, deltaY }, sessionId);
+}
+export async function dragAndDrop(client, sessionId, src, tgt) {
+    const srcBox = await getElementBox(client, sessionId, src);
+    const tgtBox = await getElementBox(client, sessionId, tgt);
+    if (!srcBox || !tgtBox)
+        throw new Error('Cannot drag: one or both elements not found in DOM');
+    await client.send('Input.dispatchMouseEvent', { type: 'mousePressed', x: srcBox.x, y: srcBox.y, button: 'left', buttons: 1, clickCount: 1 }, sessionId);
+    await client.send('Input.dispatchMouseEvent', { type: 'mouseMoved', x: srcBox.x, y: srcBox.y, button: 'left', buttons: 1 }, sessionId);
+    // Move in steps for smooth drag
+    const steps = 10;
+    for (let i = 1; i <= steps; i++) {
+        const x = srcBox.x + (tgtBox.x - srcBox.x) * (i / steps);
+        const y = srcBox.y + (tgtBox.y - srcBox.y) * (i / steps);
+        await client.send('Input.dispatchMouseEvent', { type: 'mouseMoved', x, y, button: 'left', buttons: 1 }, sessionId);
+    }
+    await client.send('Input.dispatchMouseEvent', { type: 'mouseReleased', x: tgtBox.x, y: tgtBox.y, button: 'left', buttons: 0, clickCount: 1 }, sessionId);
+}
+export async function uploadFile(client, sessionId, ref, filePaths) {
+    if (!ref.backendDOMNodeId)
+        throw new Error(`Cannot upload: ref @${ref.ref} has no DOM node`);
+    await client.send('DOM.setFileInputFiles', {
+        files: filePaths,
+        backendNodeId: ref.backendDOMNodeId,
+    }, sessionId);
+}
+export async function readClipboard(client, sessionId) {
+    const result = await evaluateJs(client, sessionId, 'navigator.clipboard.readText()');
+    return result;
+}
+export async function writeClipboard(client, sessionId, text) {
+    await evaluateJs(client, sessionId, `navigator.clipboard.writeText(${JSON.stringify(text)})`);
+}
+export async function pushState(client, sessionId, url) {
+    // Try Next.js router first, then fallback to history.pushState
+    await evaluateJs(client, sessionId, `
+    (function() {
+      const url = ${JSON.stringify(url)};
+      if (window.next && window.next.router) {
+        window.next.router.push(url);
+      } else {
+        history.pushState({}, '', url);
+        window.dispatchEvent(new PopStateEvent('popstate'));
+      }
+    })()
+  `);
+}
+export async function addInitScript(client, sessionId, script) {
+    const result = await client.send('Page.addScriptToEvaluateOnNewDocument', {
+        source: script,
+    }, sessionId);
+    return result.identifier;
+}
+export async function removeInitScript(client, sessionId, identifier) {
+    await client.send('Page.removeScriptToEvaluateOnNewDocument', { identifier }, sessionId);
+}
 export async function evaluateJs(client, sessionId, expression) {
     const result = await client.send('Runtime.evaluate', {
         expression,