tauri-agent-tools 0.5.1 → 0.7.0

package/dist/commands/forensics.js

@@ -0,0 +1,331 @@
+import { Command } from 'commander';
+import { spawn } from 'node:child_process';
+import { mkdir, readdir, stat, writeFile, readFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join, basename } from 'node:path';
+import { LineFramer } from '../util/ndjson.js';
+import { resolveTauriProject } from '../util/tauriConfig.js';
+import { buildArgs as buildDarwinArgs, parseLine as parseDarwinLine } from '../platform/oslog/darwin.js';
+import { buildArgs as buildLinuxArgs, parseLine as parseLinuxLine } from '../platform/oslog/linux.js';
+const PANIC_MARKERS = [
+    'panicked at',
+    'panic occurred',
+    'SIGSEGV',
+    'SIGABRT',
+    'fatal runtime error',
+    'thread \'main\' panicked',
+    'Uncaught',
+    'unhandledRejection',
+];
+export function registerForensics(program) {
+    const cmd = new Command('forensics')
+        .description("Bundle a forensic snapshot of a Tauri app (paths, logs, crash reports). Works on dead apps.")
+        .option('--config <path>', 'Path to tauri.conf.json (or its directory). Auto-detected if omitted.')
+        .option('--identifier <id>', 'Bundle identifier override')
+        .option('-o, --out <dir>', 'Output directory (default: ./forensics-<timestamp>)')
+        .option('--since <duration>', 'How far back to pull from app log files (default: 10m)')
+        .option('--logs-duration <ms>', 'Time budget for the live OS-log tail in milliseconds (default: 3000)', parsePositiveInt)
+        .option('--json', 'Print the summary as JSON to stdout in addition to writing to disk')
+        .action(async (opts) => {
+        const outDir = opts.out ?? `./forensics-${timestampSlug()}`;
+        await mkdir(outDir, { recursive: true });
+        const outcomes = [];
+        const summary = { phases: outcomes };
+        // ── Phase 1: Resolve project + paths ─────────────────────────────────
+        const resolved = await safe(async () => resolveTauriProject({ configPath: opts.config, identifierOverride: opts.identifier }));
+        if (!resolved.ok) {
+            outcomes.push({ phase: 'resolve-config', ok: false, detail: resolved.error });
+            await writeSummary(outDir, summary, opts.json);
+            throw new Error(`Could not resolve Tauri config: ${resolved.error}`);
+        }
+        const project = resolved.value;
+        outcomes.push({
+            phase: 'resolve-config',
+            ok: true,
+            detail: `identifier=${project.identifier} productName=${project.productName}`,
+        });
+        summary['identifier'] = project.identifier;
+        summary['productName'] = project.productName;
+        summary['configPath'] = project.configPath;
+        summary['platform'] = project.platform;
+        summary['paths'] = project.paths[project.platform];
+        // ── Phase 2: List files in app-data + app-log directories ────────────
+        const dataFiles = await safeListDir(project.paths[project.platform].appDataDir);
+        const logFiles = await safeListDir(project.paths[project.platform].appLogDir);
+        summary['appDataFiles'] = dataFiles.files;
+        summary['appLogFiles'] = logFiles.files;
+        outcomes.push({
+            phase: 'list-app-data',
+            ok: dataFiles.ok,
+            detail: dataFiles.ok ? `${dataFiles.files.length} files` : dataFiles.detail,
+        });
+        outcomes.push({
+            phase: 'list-app-log',
+            ok: logFiles.ok,
+            detail: logFiles.ok ? `${logFiles.files.length} files` : logFiles.detail,
+        });
+        // ── Phase 3: Tail the most-recently-modified app log file ────────────
+        const newestLog = pickNewest(logFiles.files);
+        let logTail = [];
+        let panicLines = [];
+        if (newestLog) {
+            const tailResult = await safe(async () => tailFile(newestLog.path, 200));
+            if (tailResult.ok) {
+                logTail = tailResult.value;
+                panicLines = logTail.filter((l) => PANIC_MARKERS.some((m) => l.includes(m)));
+                outcomes.push({
+                    phase: 'tail-app-log',
+                    ok: true,
+                    detail: `${logTail.length} lines, ${panicLines.length} panic marker(s)`,
+                });
+                await writeFile(join(outDir, 'app-log-tail.txt'), logTail.join('\n'));
+            }
+            else {
+                outcomes.push({ phase: 'tail-app-log', ok: false, detail: tailResult.error });
+            }
+        }
+        else {
+            outcomes.push({ phase: 'tail-app-log', ok: false, detail: 'no app log files found' });
+        }
+        summary['logTailLineCount'] = logTail.length;
+        summary['panicLines'] = panicLines;
+        // ── Phase 4: macOS DiagnosticReports (skip on other platforms) ───────
+        let diagnosticReports = [];
+        if (project.platform === 'darwin') {
+            const drDir = `${homedir()}/Library/Logs/DiagnosticReports`;
+            if (existsSync(drDir)) {
+                const all = await safeListDir(drDir);
+                // Filter to entries whose name starts with productName (macOS naming convention).
+                diagnosticReports = all.files
+                    .filter((f) => basename(f.path).startsWith(project.productName))
+                    .sort((a, b) => (a.mtime < b.mtime ? 1 : -1))
+                    .slice(0, 5);
+                outcomes.push({
+                    phase: 'macos-diagnostic-reports',
+                    ok: true,
+                    detail: `${diagnosticReports.length} report(s) matching productName`,
+                });
+            }
+            else {
+                outcomes.push({
+                    phase: 'macos-diagnostic-reports',
+                    ok: false,
+                    detail: `${drDir} not accessible`,
+                });
+            }
+        }
+        summary['diagnosticReports'] = diagnosticReports;
+        // ── Phase 5: Live OS-log tail (best-effort) ──────────────────────────
+        const liveLogs = [];
+        const budgetMs = opts.logsDuration ?? 3000;
+        if (project.platform === 'darwin' || project.platform === 'linux') {
+            const livRes = await safe(async () => collectLiveLogs(project.identifier, project.productName, budgetMs, project.platform));
+            if (livRes.ok) {
+                liveLogs.push(...livRes.value);
+                outcomes.push({
+                    phase: 'live-os-log-tail',
+                    ok: true,
+                    detail: `${liveLogs.length} entries in ${budgetMs}ms`,
+                });
+                await writeFile(join(outDir, 'live-os-log.ndjson'), liveLogs.map((e) => JSON.stringify(e)).join('\n'));
+            }
+            else {
+                outcomes.push({ phase: 'live-os-log-tail', ok: false, detail: livRes.error });
+            }
+        }
+        else {
+            outcomes.push({
+                phase: 'live-os-log-tail',
+                ok: false,
+                detail: `not implemented on ${project.platform}`,
+            });
+        }
+        summary['liveLogEntries'] = liveLogs.length;
+        // ── Phase 6: Write artifacts to outDir ───────────────────────────────
+        await writeFile(join(outDir, 'project.json'), JSON.stringify(project, null, 2));
+        await writeFile(join(outDir, 'summary.json'), JSON.stringify(summary, null, 2));
+        await writeFile(join(outDir, 'summary.md'), renderMarkdown(summary, outcomes, project, panicLines, logTail));
+        summary['outDir'] = outDir;
+        if (opts.json) {
+            console.log(JSON.stringify(summary, null, 2));
+        }
+        else {
+            console.log(`✓ Forensic bundle written to ${outDir}`);
+            console.log(`  ${outcomes.filter((o) => o.ok).length}/${outcomes.length} phases succeeded`);
+            if (panicLines.length > 0) {
+                console.log(`  ⚠ ${panicLines.length} panic marker(s) in the most-recent log`);
+            }
+        }
+    });
+    program.addCommand(cmd);
+}
+function timestampSlug() {
+    return new Date().toISOString().replace(/[:.]/g, '-');
+}
+async function safe(fn) {
+    try {
+        return { ok: true, value: await fn() };
+    }
+    catch (err) {
+        return { ok: false, error: err instanceof Error ? err.message : String(err) };
+    }
+}
+async function safeListDir(dir) {
+    if (!existsSync(dir)) {
+        return { ok: false, files: [], detail: `${dir} does not exist` };
+    }
+    try {
+        const entries = await readdir(dir);
+        const files = [];
+        for (const name of entries) {
+            const path = join(dir, name);
+            try {
+                const st = await stat(path);
+                if (!st.isFile())
+                    continue;
+                files.push({ path, size: st.size, mtime: st.mtime.toISOString() });
+            }
+            catch {
+                // Skip unreadable entries (permission denied, etc.)
+            }
+        }
+        return { ok: true, files, detail: `${files.length} files` };
+    }
+    catch (err) {
+        return {
+            ok: false,
+            files: [],
+            detail: err instanceof Error ? err.message : String(err),
+        };
+    }
+}
+function pickNewest(files) {
+    if (files.length === 0)
+        return null;
+    return [...files].sort((a, b) => (a.mtime < b.mtime ? 1 : -1))[0] ?? null;
+}
+async function tailFile(path, lines) {
+    // Naive impl: read whole file, slice last N. Good enough for "tail the most
+    // recent app log" since these files are typically rotated/small.
+    const text = await readFile(path, 'utf-8');
+    return text.split(/\r?\n/).slice(-lines).filter((l) => l.length > 0);
+}
+async function collectLiveLogs(identifier, productName, budgetMs, platform) {
+    if (platform === 'win32')
+        return [];
+    const args = platform === 'darwin'
+        ? buildDarwinArgs({ identifier, productName })
+        : buildLinuxArgs({ identifier, productName, since: `${Math.ceil(budgetMs / 1000)}s ago` });
+    const cmdBin = platform === 'darwin' ? 'log' : 'journalctl';
+    const parser = platform === 'darwin' ? parseDarwinLine : parseLinuxLine;
+    const child = spawn(cmdBin, args, { stdio: ['ignore', 'pipe', 'pipe'] });
+    const framer = new LineFramer();
+    const entries = [];
+    child.stdout.setEncoding('utf-8');
+    child.stdout.on('data', (chunk) => {
+        for (const line of framer.push(chunk)) {
+            const e = parser(line);
+            if (e)
+                entries.push(e);
+        }
+    });
+    const timer = setTimeout(() => child.kill('SIGTERM'), budgetMs);
+    await new Promise((resolve) => {
+        child.on('close', () => {
+            clearTimeout(timer);
+            resolve();
+        });
+        child.on('error', () => {
+            clearTimeout(timer);
+            resolve(); // swallow — forensics is best-effort
+        });
+    });
+    return entries;
+}
+async function writeSummary(outDir, summary, alsoStdout) {
+    await writeFile(join(outDir, 'summary.json'), JSON.stringify(summary, null, 2));
+    if (alsoStdout)
+        console.log(JSON.stringify(summary, null, 2));
+}
+function renderMarkdown(summary, outcomes, project, panicLines, logTail) {
+    const phases = outcomes
+        .map((o) => `- ${o.ok ? '✓' : '✗'} **${o.phase}** — ${o.detail}`)
+        .join('\n');
+    const dataFiles = summary['appDataFiles'] ?? [];
+    const logFiles = summary['appLogFiles'] ?? [];
+    const dataList = dataFiles.length === 0
+        ? '_no files_'
+        : dataFiles.map((f) => `- \`${f.path}\` (${f.size} bytes, ${f.mtime})`).join('\n');
+    const logList = logFiles.length === 0
+        ? '_no files_'
+        : logFiles.map((f) => `- \`${f.path}\` (${f.size} bytes, ${f.mtime})`).join('\n');
+    const panicBlock = panicLines.length === 0
+        ? '_none_'
+        : panicLines.map((l) => '    ' + l).join('\n');
+    const tailBlock = logTail.length === 0
+        ? '_no log file to tail_'
+        : '```\n' + logTail.slice(-20).join('\n') + '\n```';
+    return `# Forensics: ${project.productName}
+
+- **Identifier:** \`${project.identifier}\`
+- **Platform:** ${project.platform}
+- **Config:** \`${project.configPath}\`
+
+## Phases
+
+${phases}
+
+## Resolved paths (current platform)
+
+\`\`\`json
+${JSON.stringify(project.paths[project.platform], null, 2)}
+\`\`\`
+
+## App data files
+
+${dataList}
+
+## App log files
+
+${logList}
+
+## Panic markers in most-recent log
+
+\`\`\`
+${panicBlock}
+\`\`\`
+
+## Tail of most-recent log (last 20 lines)
+
+${tailBlock}
+
+## Suggested next steps
+
+${suggestNextSteps(project, panicLines, logTail, outcomes)}
+`;
+}
+function suggestNextSteps(project, panicLines, logTail, outcomes) {
+    const tips = [];
+    if (panicLines.length > 0) {
+        tips.push(`- A panic was detected. Run \`tauri-agent-tools os-logs --identifier ${project.identifier} --level error --since 30m --json\` to fetch surrounding error-level entries.`);
+    }
+    if (logTail.length === 0) {
+        tips.push(`- No app log file found. Verify the app actually writes to \`appLogDir\` (default for Tauri is via \`tauri-plugin-log\`).`);
+    }
+    if (outcomes.some((o) => o.phase === 'live-os-log-tail' && !o.ok)) {
+        tips.push(`- Live OS-log tail failed. Check that \`${project.platform === 'darwin' ? 'log' : 'journalctl'}\` is on PATH.`);
+    }
+    if (tips.length === 0) {
+        tips.push(`- No specific anomalies detected. Inspect the artifacts in this folder for context.`);
+    }
+    return tips.join('\n');
+}
+function parsePositiveInt(value) {
+    const n = parseInt(value, 10);
+    if (!Number.isFinite(n) || n <= 0) {
+        throw new Error(`Expected a positive integer, got: ${value}`);
+    }
+    return n;
+}
+//# sourceMappingURL=forensics.js.map

package/dist/commands/forensics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"forensics.js","sourceRoot":"","sources":["../../src/commands/forensics.ts"],"names":[],"mappings":"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"}

package/dist/commands/health.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function registerHealth(program: Command): void;

package/dist/commands/health.js

@@ -0,0 +1,39 @@
+import { Command } from 'commander';
+import { addBridgeOptions, resolveBridge } from './shared.js';
+export function registerHealth(program) {
+    const cmd = new Command('health')
+        .description('Quick "is this Tauri app sick" check (requires bridge v0.7.0+)')
+        .option('--json', 'Output as JSON');
+    addBridgeOptions(cmd);
+    cmd.action(async (opts) => {
+        const bridge = await resolveBridge(opts);
+        const h = await bridge.health();
+        if (opts.json) {
+            console.log(JSON.stringify(h, null, 2));
+            // Exit non-zero on detected issues so this can drive CI gates.
+            if (!h.webview_ready || !h.sidecars_alive)
+                process.exitCode = 1;
+            return;
+        }
+        renderHuman(h);
+        if (!h.webview_ready || !h.sidecars_alive)
+            process.exitCode = 1;
+    });
+    program.addCommand(cmd);
+}
+function renderHuman(h) {
+    const uptimeSec = Math.floor(h.uptime_ms / 1000);
+    console.log(`Uptime:         ${uptimeSec}s`);
+    console.log(`Webview ready:  ${h.webview_ready ? 'yes' : 'NO'}`);
+    console.log(`Sidecars alive: ${h.sidecars_alive ? 'yes' : 'NO'}`);
+    if (h.sidecars.length === 0) {
+        console.log(`Sidecars:       (none registered)`);
+        return;
+    }
+    console.log(`Sidecars (${h.sidecars.length}):`);
+    for (const s of h.sidecars) {
+        const alive = s.alive === null || s.alive === undefined ? '?' : s.alive ? 'alive' : 'DEAD';
+        console.log(`  ${s.name.padEnd(20)} pid=${s.pid} ${alive}`);
+    }
+}
+//# sourceMappingURL=health.js.map

package/dist/commands/health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.js","sourceRoot":"","sources":["../../src/commands/health.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAI9D,MAAM,UAAU,cAAc,CAAC,OAAgB;IAC7C,MAAM,GAAG,GAAG,IAAI,OAAO,CAAC,QAAQ,CAAC;SAC9B,WAAW,CAAC,gEAAgE,CAAC;SAC7E,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC;IAEtC,gBAAgB,CAAC,GAAG,CAAC,CAAC;IAEtB,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,IAAqC,EAAE,EAAE;QACzD,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,CAAC;QACzC,MAAM,CAAC,GAAG,MAAM,MAAM,CAAC,MAAM,EAAE,CAAC;QAChC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YACxC,+DAA+D;YAC/D,IAAI,CAAC,CAAC,CAAC,aAAa,IAAI,CAAC,CAAC,CAAC,cAAc;gBAAE,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YAChE,OAAO;QACT,CAAC;QACD,WAAW,CAAC,CAAC,CAAC,CAAC;QACf,IAAI,CAAC,CAAC,CAAC,aAAa,IAAI,CAAC,CAAC,CAAC,cAAc;YAAE,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,WAAW,CAAC,CAAiB;IACpC,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;IACjD,OAAO,CAAC,GAAG,CAAC,mBAAmB,SAAS,GAAG,CAAC,CAAC;IAC7C,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACjE,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAClE,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC;QACjD,OAAO;IACT,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,QAAQ,CAAC,MAAM,IAAI,CAAC,CAAC;IAChD,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,KAAK,IAAI,IAAI,CAAC,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;QAC3F,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,KAAK,EAAE,CAAC,CAAC;IAC9D,CAAC;AACH,CAAC"}

package/dist/commands/interact/click.d.ts

@@ -0,0 +1,6 @@
+import { Command } from 'commander';
+export declare function buildClickScript(selector: string, opts: {
+    double: boolean;
+    right: boolean;
+}): string;
+export declare function registerClick(program: Command): void;

package/dist/commands/interact/click.js

@@ -0,0 +1,102 @@
+import { Command } from 'commander';
+import { resolveBridge } from '../shared.js';
+import { addInteractOptions, escapeSelector } from './shared.js';
+import { ClickResultSchema } from '../../schemas/interact.js';
+export function buildClickScript(selector, opts) {
+    const escaped = escapeSelector(selector);
+    const button = opts.right ? 2 : 0;
+    return `(() => {
+  var el = document.querySelector('${escaped}');
+  if (!el) return JSON.stringify({ success: false, selector: '${escaped}', error: 'Element not found' });
+  var r = el.getBoundingClientRect();
+  var clientX = r.left + r.width / 2;
+  var clientY = r.top + r.height / 2;
+  var eventOpts = { bubbles: true, cancelable: true, clientX: clientX, clientY: clientY, button: ${button} };
+  el.dispatchEvent(new MouseEvent('mousedown', eventOpts));
+  el.dispatchEvent(new MouseEvent('mouseup', eventOpts));
+  ${opts.right
+        ? `el.dispatchEvent(new MouseEvent('contextmenu', eventOpts));`
+        : opts.double
+            ? `el.dispatchEvent(new MouseEvent('click', eventOpts));
+  el.dispatchEvent(new MouseEvent('dblclick', eventOpts));`
+            : `el.dispatchEvent(new MouseEvent('click', eventOpts));`}
+  var text = (el.textContent || '').trim().slice(0, 100);
+  return JSON.stringify({ success: true, selector: '${escaped}', tagName: el.tagName.toLowerCase(), text: text });
+})()`;
+}
+function buildWaitAndClickScript(selector, opts, waitMs) {
+    const escaped = escapeSelector(selector);
+    const button = opts.right ? 2 : 0;
+    const clickEvents = opts.right
+        ? `el.dispatchEvent(new MouseEvent('contextmenu', eventOpts));`
+        : opts.double
+            ? `el.dispatchEvent(new MouseEvent('click', eventOpts));
+      el.dispatchEvent(new MouseEvent('dblclick', eventOpts));`
+            : `el.dispatchEvent(new MouseEvent('click', eventOpts));`;
+    return `(() => {
+  var deadline = Date.now() + ${waitMs};
+  function attempt() {
+    var el = document.querySelector('${escaped}');
+    if (el) {
+      var r = el.getBoundingClientRect();
+      var clientX = r.left + r.width / 2;
+      var clientY = r.top + r.height / 2;
+      var eventOpts = { bubbles: true, cancelable: true, clientX: clientX, clientY: clientY, button: ${button} };
+      el.dispatchEvent(new MouseEvent('mousedown', eventOpts));
+      el.dispatchEvent(new MouseEvent('mouseup', eventOpts));
+      ${clickEvents}
+      var text = (el.textContent || '').trim().slice(0, 100);
+      return JSON.stringify({ success: true, selector: '${escaped}', tagName: el.tagName.toLowerCase(), text: text });
+    }
+    if (Date.now() >= deadline) {
+      return JSON.stringify({ success: false, selector: '${escaped}', error: 'Element not found' });
+    }
+    return null;
+  }
+  return new Promise(function(resolve) {
+    function poll() {
+      var result = attempt();
+      if (result !== null) { resolve(result); return; }
+      setTimeout(poll, 100);
+    }
+    poll();
+  });
+})()`;
+}
+export function registerClick(program) {
+    const cmd = new Command('click')
+        .description('Dispatch mouse click events on a DOM element')
+        .argument('<selector>', 'CSS selector of the element to click')
+        .option('--double', 'Dispatch a double-click (dblclick) instead of a single click')
+        .option('--right', 'Dispatch a right-click (contextmenu) instead of a left click')
+        .option('--wait <ms>', 'Wait up to <ms> milliseconds for element to appear', parseInt, 0)
+        .addHelpText('after', `
+Examples:
+  $ tauri-agent-tools click "button.submit"
+  $ tauri-agent-tools click "#menu-toggle" --double
+  $ tauri-agent-tools click ".context-target" --right
+  $ tauri-agent-tools click ".lazy-item" --wait 3000 --json`);
+    addInteractOptions(cmd);
+    cmd.action(async (selector, opts) => {
+        const bridge = await resolveBridge(opts);
+        const clickOpts = { double: !!opts.double, right: !!opts.right };
+        const script = opts.wait > 0
+            ? buildWaitAndClickScript(selector, clickOpts, opts.wait)
+            : buildClickScript(selector, clickOpts);
+        const raw = await bridge.eval(script);
+        const result = ClickResultSchema.parse(JSON.parse(String(raw)));
+        if (!result.success) {
+            throw new Error(`Click failed: ${result.error} (selector: ${result.selector})`);
+        }
+        if (opts.json) {
+            console.log(JSON.stringify(result, null, 2));
+        }
+        else {
+            const actionLabel = opts.right ? 'right-clicked' : opts.double ? 'double-clicked' : 'clicked';
+            const textHint = result.text ? ` "${result.text.slice(0, 40)}"` : '';
+            console.log(`${actionLabel} <${result.tagName}${textHint}> (${result.selector})`);
+        }
+    });
+    program.addCommand(cmd);
+}
+//# sourceMappingURL=click.js.map

package/dist/commands/interact/click.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"click.js","sourceRoot":"","sources":["../../../src/commands/interact/click.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAE9D,MAAM,UAAU,gBAAgB,CAC9B,QAAgB,EAChB,IAAyC;IAEzC,MAAM,OAAO,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;IACzC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAElC,OAAO;qCAC4B,OAAO;gEACoB,OAAO;;;;mGAI4B,MAAM;;;IAGrG,IAAI,CAAC,KAAK;QACV,CAAC,CAAC,6DAA6D;QAC/D,CAAC,CAAC,IAAI,CAAC,MAAM;YACX,CAAC,CAAC;2DACmD;YACrD,CAAC,CAAC,uDAAuD;;sDAET,OAAO;KACxD,CAAC;AACN,CAAC;AAED,SAAS,uBAAuB,CAC9B,QAAgB,EAChB,IAAyC,EACzC,MAAc;IAEd,MAAM,OAAO,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;IACzC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAClC,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK;QAC5B,CAAC,CAAC,6DAA6D;QAC/D,CAAC,CAAC,IAAI,CAAC,MAAM;YACX,CAAC,CAAC;+DACuD;YACzD,CAAC,CAAC,uDAAuD,CAAC;IAE9D,OAAO;gCACuB,MAAM;;uCAEC,OAAO;;;;;uGAKyD,MAAM;;;QAGrG,WAAW;;0DAEuC,OAAO;;;2DAGN,OAAO;;;;;;;;;;;;KAY7D,CAAC;AACN,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAAgB;IAC5C,MAAM,GAAG,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC;SAC7B,WAAW,CAAC,8CAA8C,CAAC;SAC3D,QAAQ,CAAC,YAAY,EAAE,sCAAsC,CAAC;SAC9D,MAAM,CAAC,UAAU,EAAE,8DAA8D,CAAC;SAClF,MAAM,CAAC,SAAS,EAAE,8DAA8D,CAAC;SACjF,MAAM,CAAC,aAAa,EAAE,oDAAoD,EAAE,QAAQ,EAAE,CAAC,CAAC;SACxF,WAAW,CAAC,OAAO,EAAE;;;;;4DAKkC,CAAC,CAAC;IAE5D,kBAAkB,CAAC,GAAG,CAAC,CAAC;IAExB,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,QAAgB,EAAE,IAOnC,EAAE,EAAE;QACH,MAAM,MAAM,GAAiB,MAAM,aAAa,CAAC,IAAI,CAAC,CAAC;QAEvD,MAAM,SAAS,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QACjE,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,GAAG,CAAC;YAC1B,CAAC,CAAC,uBAAuB,CAAC,QAAQ,EAAE,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC;YACzD,CAAC,CAAC,gBAAgB,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;QAE1C,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACtC,MAAM,MAAM,GAAG,iBAAiB,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAEhE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,iBAAiB,MAAM,CAAC,KAAK,eAAe,MAAM,CAAC,QAAQ,GAAG,CAAC,CAAC;QAClF,CAAC;QAED,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC/C,CAAC;aAAM,CAAC;YACN,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,SAAS,CAAC;YAC9F,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YACrE,OAAO,CAAC,GAAG,CAAC,GAAG,WAAW,KAAK,MAAM,CAAC,OAAO,GAAG,QAAQ,MAAM,MAAM,CAAC,QAAQ,GAAG,CAAC,CAAC;QACpF,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;AAC1B,CAAC"}

package/dist/commands/interact/focus.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function buildFocusScript(selector: string): string;
+export declare function registerFocus(program: Command): void;

package/dist/commands/interact/focus.js

@@ -0,0 +1,40 @@
+import { Command } from 'commander';
+import { resolveBridge } from '../shared.js';
+import { addInteractOptions, escapeSelector } from './shared.js';
+import { InteractionResultSchema } from '../../schemas/interact.js';
+export function buildFocusScript(selector) {
+    const escaped = escapeSelector(selector);
+    return `(function() {
+  try {
+    var el = document.querySelector('${escaped}');
+    if (!el) return JSON.stringify({ success: false, error: 'Element not found: ${escaped}' });
+    el.focus();
+    return JSON.stringify({ success: true, selector: '${escaped}', tagName: el.tagName.toLowerCase() });
+  } catch (e) {
+    return JSON.stringify({ success: false, error: String(e) });
+  }
+})()`;
+}
+export function registerFocus(program) {
+    const cmd = new Command('focus')
+        .description('Focus a DOM element by CSS selector')
+        .argument('<selector>', 'CSS selector of the element to focus')
+        .addHelpText('after', `
+Examples:
+  $ tauri-agent-tools focus "input[name='email']"
+  $ tauri-agent-tools focus "#submit-button"
+  $ tauri-agent-tools focus ".search-field"`);
+    addInteractOptions(cmd);
+    cmd.action(async (selector, opts) => {
+        const bridge = await resolveBridge(opts);
+        const script = buildFocusScript(selector);
+        const raw = await bridge.eval(script);
+        const result = InteractionResultSchema.parse(JSON.parse(String(raw)));
+        if (!result.success) {
+            throw new Error(result.error ?? 'Focus failed');
+        }
+        console.log(JSON.stringify(result, null, 2));
+    });
+    program.addCommand(cmd);
+}
+//# sourceMappingURL=focus.js.map

package/dist/commands/interact/focus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"focus.js","sourceRoot":"","sources":["../../../src/commands/interact/focus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAEpE,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,MAAM,OAAO,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;IACzC,OAAO;;uCAE8B,OAAO;kFACoC,OAAO;;wDAEjC,OAAO;;;;KAI1D,CAAC;AACN,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAAgB;IAC5C,MAAM,GAAG,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC;SAC7B,WAAW,CAAC,qCAAqC,CAAC;SAClD,QAAQ,CAAC,YAAY,EAAE,sCAAsC,CAAC;SAC9D,WAAW,CAAC,OAAO,EAAE;;;;4CAIkB,CAAC,CAAC;IAE5C,kBAAkB,CAAC,GAAG,CAAC,CAAC;IAExB,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,QAAgB,EAAE,IAAgB,EAAE,EAAE;QACtD,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,CAAC;QACzC,MAAM,MAAM,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QAC1C,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACtC,MAAM,MAAM,GAAG,uBAAuB,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACtE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,IAAI,cAAc,CAAC,CAAC;QAClD,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;AAC1B,CAAC"}

package/dist/commands/interact/navigate.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function buildNavigateScript(target: string): string;
+export declare function registerNavigate(program: Command): void;

package/dist/commands/interact/navigate.js

@@ -0,0 +1,49 @@
+import { Command } from 'commander';
+import { resolveBridge } from '../shared.js';
+import { addInteractOptions, escapeSelector } from './shared.js';
+import { InteractionResultSchema } from '../../schemas/interact.js';
+export function buildNavigateScript(target) {
+    const escaped = escapeSelector(target);
+    if (target.startsWith('/')) {
+        return `(function() {
+  try {
+    window.history.pushState({}, '', '${escaped}');
+    window.dispatchEvent(new PopStateEvent('popstate', { state: {} }));
+    return JSON.stringify({ success: true, tagName: 'window', selector: '${escaped}' });
+  } catch (e) {
+    return JSON.stringify({ success: false, error: String(e) });
+  }
+})()`;
+    }
+    return `(function() {
+  try {
+    window.location.href = '${escaped}';
+    return JSON.stringify({ success: true, tagName: 'window', selector: '${escaped}' });
+  } catch (e) {
+    return JSON.stringify({ success: false, error: String(e) });
+  }
+})()`;
+}
+export function registerNavigate(program) {
+    const cmd = new Command('navigate')
+        .description('Navigate to a URL or path')
+        .argument('<target>', 'URL or path to navigate to (paths starting with / use pushState)')
+        .addHelpText('after', `
+Examples:
+  $ tauri-agent-tools navigate /dashboard
+  $ tauri-agent-tools navigate /settings/profile
+  $ tauri-agent-tools navigate https://example.com`);
+    addInteractOptions(cmd);
+    cmd.action(async (target, opts) => {
+        const bridge = await resolveBridge(opts);
+        const script = buildNavigateScript(target);
+        const raw = await bridge.eval(script);
+        const result = InteractionResultSchema.parse(JSON.parse(String(raw)));
+        if (!result.success) {
+            throw new Error(result.error ?? 'Navigate failed');
+        }
+        console.log(JSON.stringify(result, null, 2));
+    });
+    program.addCommand(cmd);
+}
+//# sourceMappingURL=navigate.js.map

package/dist/commands/interact/navigate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigate.js","sourceRoot":"","sources":["../../../src/commands/interact/navigate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAEpE,MAAM,UAAU,mBAAmB,CAAC,MAAc;IAChD,MAAM,OAAO,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IACvC,IAAI,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3B,OAAO;;wCAE6B,OAAO;;2EAE4B,OAAO;;;;KAI7E,CAAC;IACJ,CAAC;IAED,OAAO;;8BAEqB,OAAO;2EACsC,OAAO;;;;KAI7E,CAAC;AACN,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,OAAgB;IAC/C,MAAM,GAAG,GAAG,IAAI,OAAO,CAAC,UAAU,CAAC;SAChC,WAAW,CAAC,2BAA2B,CAAC;SACxC,QAAQ,CAAC,UAAU,EAAE,kEAAkE,CAAC;SACxF,WAAW,CAAC,OAAO,EAAE;;;;mDAIyB,CAAC,CAAC;IAEnD,kBAAkB,CAAC,GAAG,CAAC,CAAC;IAExB,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,MAAc,EAAE,IAAgB,EAAE,EAAE;QACpD,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,CAAC;QACzC,MAAM,MAAM,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;QAC3C,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACtC,MAAM,MAAM,GAAG,uBAAuB,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACtE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,IAAI,iBAAiB,CAAC,CAAC;QACrD,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;AAC1B,CAAC"}

package/dist/commands/interact/scroll.d.ts

@@ -0,0 +1,11 @@
+import { Command } from 'commander';
+export interface ScrollOpts {
+    selector?: string;
+    by?: number;
+    to?: number;
+    toTop?: boolean;
+    toBottom?: boolean;
+    intoView?: boolean;
+}
+export declare function buildScrollScript(opts: ScrollOpts): string;
+export declare function registerScroll(program: Command): void;