tauri-agent-tools 0.6.0 → 0.7.1

package/dist/commands/osLogs.js

@@ -0,0 +1,130 @@
+import { Command } from 'commander';
+import { spawn } from 'node:child_process';
+import * as darwin from '../platform/oslog/darwin.js';
+import * as linux from '../platform/oslog/linux.js';
+import * as windows from '../platform/oslog/windows.js';
+import { resolveTauriProject } from '../util/tauriConfig.js';
+import { LineFramer } from '../util/ndjson.js';
+const LEVEL_RANK = { debug: 0, info: 1, warn: 2, error: 3 };
+export function registerOsLogs(program) {
+    const cmd = new Command('os-logs')
+        .description("Tail the host OS's log stream filtered to a Tauri bundle id")
+        .option('--config <path>', 'Path to tauri.conf.json (or its directory). Auto-detected if omitted.')
+        .option('--identifier <id>', 'Bundle identifier override')
+        .option('--product-name <name>', 'Product name override (used for log-source matching)')
+        .option('--since <duration>', 'How far back to start (e.g., 5m, 1h). Linux only.')
+        .option('--level <level>', 'Minimum level: debug | info | warn | error')
+        .option('--source <source>', 'Filter source: main | webview | sidecar | all', 'all')
+        .option('--duration <ms>', 'Stop after N milliseconds', parseIntOrInfinity)
+        .option('--json', 'Output as one NDJSON envelope per line (default)')
+        .action(async (opts) => {
+        const minLevel = opts.level ? validateLevel(opts.level) : null;
+        const sourceFilter = opts.source ?? 'all';
+        let identifier;
+        let productName;
+        if (opts.identifier) {
+            identifier = opts.identifier;
+            productName = opts.productName ?? opts.identifier;
+        }
+        else {
+            const resolved = await resolveTauriProject({ configPath: opts.config });
+            identifier = resolved.identifier;
+            productName = opts.productName ?? resolved.productName;
+        }
+        const adapter = pickAdapter();
+        const args = adapter.buildArgs({
+            identifier,
+            productName,
+            since: opts.since,
+        });
+        const child = spawn(adapter.command, args, {
+            stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        const framer = new LineFramer();
+        child.stdout.setEncoding('utf-8');
+        child.stdout.on('data', (chunk) => {
+            for (const line of framer.push(chunk)) {
+                handleLine(line, adapter, minLevel, sourceFilter);
+            }
+        });
+        let stderrBuf = '';
+        child.stderr.setEncoding('utf-8');
+        child.stderr.on('data', (chunk) => {
+            stderrBuf += chunk;
+            if (stderrBuf.length > 1024 * 16)
+                stderrBuf = stderrBuf.slice(-1024 * 16);
+        });
+        let timeoutHandle = null;
+        if (opts.duration && Number.isFinite(opts.duration)) {
+            timeoutHandle = setTimeout(() => child.kill('SIGTERM'), opts.duration);
+        }
+        await new Promise((resolve, reject) => {
+            child.on('error', (err) => {
+                if (timeoutHandle)
+                    clearTimeout(timeoutHandle);
+                if (err.code === 'ENOENT') {
+                    reject(new Error(`${adapter.command} not found on PATH. ` +
+                        `os-logs needs the host OS's log streaming tool.`));
+                    return;
+                }
+                reject(err);
+            });
+            child.on('close', (code) => {
+                if (timeoutHandle)
+                    clearTimeout(timeoutHandle);
+                const trailing = framer.flush();
+                if (trailing)
+                    handleLine(trailing, adapter, minLevel, sourceFilter);
+                // Non-zero exits from `log stream` on SIGTERM are expected; only fail
+                // if we got nothing meaningful and stderr has content.
+                if (code && code !== 0 && code !== 143 /* SIGTERM */) {
+                    const detail = stderrBuf.trim();
+                    reject(new Error(`${adapter.command} exited with code ${code}${detail ? `: ${detail}` : ''}`));
+                    return;
+                }
+                resolve();
+            });
+        });
+    });
+    program.addCommand(cmd);
+}
+function pickAdapter() {
+    if (process.platform === 'darwin') {
+        return { command: darwin.COMMAND, buildArgs: darwin.buildArgs, parseLine: darwin.parseLine };
+    }
+    if (process.platform === 'linux') {
+        return { command: linux.COMMAND, buildArgs: linux.buildArgs, parseLine: linux.parseLine };
+    }
+    if (process.platform === 'win32') {
+        return { command: windows.COMMAND, buildArgs: windows.buildArgs, parseLine: windows.parseLine };
+    }
+    throw new Error(`os-logs is not supported on platform: ${process.platform}`);
+}
+function handleLine(line, adapter, minLevel, sourceFilter) {
+    if (line.length === 0)
+        return;
+    const entry = adapter.parseLine(line);
+    if (!entry)
+        return;
+    if (minLevel && LEVEL_RANK[entry.level] < LEVEL_RANK[minLevel])
+        return;
+    if (sourceFilter !== 'all' && entry.source !== sourceFilter)
+        return;
+    console.log(JSON.stringify(entry));
+}
+function validateLevel(input) {
+    if (input === 'debug' || input === 'info' || input === 'warn' || input === 'error') {
+        return input;
+    }
+    throw new Error(`Invalid --level: ${input}. Expected one of: debug, info, warn, error.`);
+}
+function parseIntOrInfinity(value) {
+    if (value === 'infinity' || value === 'inf')
+        return Number.POSITIVE_INFINITY;
+    const n = parseInt(value, 10);
+    if (!Number.isFinite(n) || n <= 0) {
+        throw new Error(`--duration must be a positive integer (milliseconds), got: ${value}`);
+    }
+    return n;
+}
+//# sourceMappingURL=osLogs.js.map

package/dist/commands/osLogs.js.map

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

package/dist/commands/pageState.d.ts

@@ -1,2 +1,3 @@
 import { Command } from 'commander';
+export declare const PAGE_STATE_SCRIPT = "(() => {\n  var state = {\n    url: window.location.href,\n    title: document.title,\n    viewport: { width: window.innerWidth, height: window.innerHeight },\n    scroll: { x: Math.round(window.scrollX), y: Math.round(window.scrollY) },\n    document: { width: document.documentElement.scrollWidth, height: document.documentElement.scrollHeight },\n    hasTauri: !!(window.__TAURI_INTERNALS__ || window.__TAURI__)\n  };\n  return JSON.stringify(state);\n})()";
 export declare function registerPageState(program: Command): void;

package/dist/commands/pageState.js

@@ -1,14 +1,14 @@
 import { Command } from 'commander';
 import { addBridgeOptions, resolveBridge } from './shared.js';
 import { PageStateSchema } from '../schemas/commands.js';
-const PAGE_STATE_SCRIPT = `(() => {
+export const PAGE_STATE_SCRIPT = `(() => {
   var state = {
     url: window.location.href,
     title: document.title,
     viewport: { width: window.innerWidth, height: window.innerHeight },
     scroll: { x: Math.round(window.scrollX), y: Math.round(window.scrollY) },
     document: { width: document.documentElement.scrollWidth, height: document.documentElement.scrollHeight },
-    hasTauri: !!(window.__TAURI__)
+    hasTauri: !!(window.__TAURI_INTERNALS__ || window.__TAURI__)
   };
   return JSON.stringify(state);
 })()`;

package/dist/commands/pageState.js.map

@@ -1 +1 @@
-{"version":3,"file":"pageState.js","sourceRoot":"","sources":["../../src/commands/pageState.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAGzD,MAAM,iBAAiB,GAAG;;;;;;;;;;KAUrB,CAAC;AAEN,SAAS,eAAe,CAAC,KAAgB;IACvC,MAAM,KAAK,GAAG;QACZ,oBAAoB,KAAK,CAAC,GAAG,EAAE;QAC/B,oBAAoB,KAAK,CAAC,KAAK,EAAE;QACjC,oBAAoB,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE;QACnE,oBAAoB,KAAK,CAAC,MAAM,CAAC,CAAC,KAAK,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE;QACvD,oBAAoB,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE;QACnE,oBAAoB,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE;KACpD,CAAC;IACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,OAAgB;IAChD,MAAM,GAAG,GAAG,IAAI,OAAO,CAAC,YAAY,CAAC;SAClC,WAAW,CAAC,wEAAwE,CAAC;SACrF,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC;IAEtC,gBAAgB,CAAC,GAAG,CAAC,CAAC;IAEtB,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,IAAuD,EAAE,EAAE;QAC3E,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,CAAC;QACzC,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QACjD,MAAM,KAAK,GAAG,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAE7D,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC9C,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC;QACtC,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;AAC1B,CAAC"}
+{"version":3,"file":"pageState.js","sourceRoot":"","sources":["../../src/commands/pageState.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAGzD,MAAM,CAAC,MAAM,iBAAiB,GAAG;;;;;;;;;;KAU5B,CAAC;AAEN,SAAS,eAAe,CAAC,KAAgB;IACvC,MAAM,KAAK,GAAG;QACZ,oBAAoB,KAAK,CAAC,GAAG,EAAE;QAC/B,oBAAoB,KAAK,CAAC,KAAK,EAAE;QACjC,oBAAoB,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE;QACnE,oBAAoB,KAAK,CAAC,MAAM,CAAC,CAAC,KAAK,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE;QACvD,oBAAoB,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE;QACnE,oBAAoB,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE;KACpD,CAAC;IACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,OAAgB;IAChD,MAAM,GAAG,GAAG,IAAI,OAAO,CAAC,YAAY,CAAC;SAClC,WAAW,CAAC,wEAAwE,CAAC;SACrF,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC;IAEtC,gBAAgB,CAAC,GAAG,CAAC,CAAC;IAEtB,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,IAAuD,EAAE,EAAE;QAC3E,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,CAAC;QACzC,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QACjD,MAAM,KAAK,GAAG,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAE7D,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC9C,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC;QACtC,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;AAC1B,CAAC"}

package/dist/commands/processTree.d.ts

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

package/dist/commands/processTree.js

@@ -0,0 +1,45 @@
+import { Command } from 'commander';
+import { addBridgeOptions, resolveBridge } from './shared.js';
+export function registerProcessTree(program) {
+    const cmd = new Command('process-tree')
+        .description('Show the Tauri PID and its registered sidecar processes (requires bridge v0.7.0+)')
+        .option('--json', 'Output as JSON');
+    addBridgeOptions(cmd);
+    cmd.action(async (opts) => {
+        const bridge = await resolveBridge(opts);
+        const proc = await bridge.process();
+        if (opts.json) {
+            console.log(JSON.stringify(proc, null, 2));
+            return;
+        }
+        renderHuman(proc);
+    });
+    program.addCommand(cmd);
+}
+function renderHuman(p) {
+    const uptimeSec = Math.floor(p.tauri.uptime_ms / 1000);
+    console.log(`tauri  pid=${p.tauri.pid}  uptime=${uptimeSec}s`);
+    if (p.tauri.exe)
+        console.log(`       exe=${p.tauri.exe}`);
+    if (p.tauri.args.length > 0)
+        console.log(`       args=[${p.tauri.args.join(', ')}]`);
+    if (p.sidecars.length === 0) {
+        console.log(`└── (no sidecars registered)`);
+        console.log(`     Tip: use \`dev_bridge::spawn_sidecar_monitored(name, cmd, args, &buf, Some(&registry))\``);
+        console.log(`     or call \`dev_bridge::register_sidecar(&registry, ...)\` after spawning your own.`);
+        return;
+    }
+    for (let i = 0; i < p.sidecars.length; i++) {
+        const s = p.sidecars[i];
+        const last = i === p.sidecars.length - 1;
+        const connector = last ? '└──' : '├──';
+        const alive = s.alive === null || s.alive === undefined ? '?' : s.alive ? 'alive' : 'DEAD';
+        console.log(`${connector} ${s.name}  pid=${s.pid}  ${alive}`);
+        const indent = last ? '    ' : '│   ';
+        if (s.exe)
+            console.log(`${indent}exe=${s.exe}`);
+        if (s.args.length > 0)
+            console.log(`${indent}args=[${s.args.join(', ')}]`);
+    }
+}
+//# sourceMappingURL=processTree.js.map

package/dist/commands/processTree.js.map

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

package/dist/commands/sidecarReplay.d.ts

@@ -0,0 +1,7 @@
+import { Command } from 'commander';
+/**
+ * Register the `sidecar` parent command's `replay` subcommand alongside `tap`.
+ * Note: this file does NOT define a top-level "sidecar" parent — that lives in
+ * sidecarTap.ts. Instead we expose a helper that the CLI bootstrap composes.
+ */
+export declare function registerSidecarReplay(program: Command): void;

package/dist/commands/sidecarReplay.js

@@ -0,0 +1,93 @@
+import { spawn } from 'node:child_process';
+import { readFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+/**
+ * Register the `sidecar` parent command's `replay` subcommand alongside `tap`.
+ * Note: this file does NOT define a top-level "sidecar" parent — that lives in
+ * sidecarTap.ts. Instead we expose a helper that the CLI bootstrap composes.
+ */
+export function registerSidecarReplay(program) {
+    // Find the existing "sidecar" parent command registered by sidecarTap.
+    const sidecar = program.commands.find((c) => c.name() === 'sidecar');
+    if (!sidecar) {
+        throw new Error('registerSidecarReplay must run after registerSidecarTap');
+    }
+    sidecar
+        .command('replay')
+        .description('Replay a recorded NDJSON stream (from `sidecar tap --record`)')
+        .argument('<file>', 'Path to NDJSON file produced by `sidecar tap --record`')
+        .option('--to-stdout', 'Emit lines verbatim to stdout (default)')
+        .option('--to-exec <cmd>', 'Pipe lines into the stdin of this command (split with spaces for args)')
+        .option('--rate <lps>', 'Lines per second (default: unlimited — emit as fast as possible)')
+        .option('--loop', 'After EOF, restart the file from the top until interrupted')
+        .action(async (file, opts) => {
+        if (!existsSync(file)) {
+            throw new Error(`Recording file not found: ${file}`);
+        }
+        const rate = opts.rate ? parseRate(opts.rate) : Number.POSITIVE_INFINITY;
+        const delayMs = Number.isFinite(rate) ? Math.round(1000 / rate) : 0;
+        const lines = (await readFile(file, 'utf-8'))
+            .split(/\r?\n/)
+            .filter((l) => l.length > 0);
+        if (lines.length === 0) {
+            process.stderr.write(`[sidecar-replay] recording is empty: ${file}\n`);
+            return;
+        }
+        if (opts.toExec) {
+            await replayToExec(lines, opts.toExec, delayMs, opts.loop ?? false);
+        }
+        else {
+            await replayToStdout(lines, delayMs, opts.loop ?? false);
+        }
+    });
+}
+function parseRate(input) {
+    const n = Number(input);
+    if (!Number.isFinite(n) || n <= 0) {
+        throw new Error(`--rate must be a positive number (lines per second), got: ${input}`);
+    }
+    return n;
+}
+async function replayToStdout(lines, delayMs, loop) {
+    do {
+        for (const line of lines) {
+            process.stdout.write(line + '\n');
+            if (delayMs > 0)
+                await sleep(delayMs);
+        }
+    } while (loop);
+}
+async function replayToExec(lines, cmdLine, delayMs, loop) {
+    // Naive whitespace split. Users with quoted args should pre-tokenize via shell.
+    const [exec, ...args] = cmdLine.split(/\s+/);
+    if (!exec)
+        throw new Error('--to-exec must include a command');
+    const child = spawn(exec, args, { stdio: ['pipe', 'inherit', 'inherit'] });
+    const closed = new Promise((resolve, reject) => {
+        child.on('error', (err) => reject(err));
+        child.on('close', (code) => resolve(code ?? 0));
+    });
+    try {
+        do {
+            for (const line of lines) {
+                if (!child.stdin.write(line + '\n')) {
+                    await new Promise((r) => child.stdin.once('drain', r));
+                }
+                if (delayMs > 0)
+                    await sleep(delayMs);
+            }
+        } while (loop);
+        child.stdin.end();
+    }
+    catch (err) {
+        child.kill('SIGTERM');
+        throw err;
+    }
+    const exitCode = await closed;
+    if (exitCode !== 0)
+        process.exitCode = exitCode;
+}
+function sleep(ms) {
+    return new Promise((r) => setTimeout(r, ms));
+}
+//# sourceMappingURL=sidecarReplay.js.map

package/dist/commands/sidecarReplay.js.map

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

package/dist/commands/sidecarTap.d.ts

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

package/dist/commands/sidecarTap.js

@@ -0,0 +1,118 @@
+import { Command } from 'commander';
+import { spawn } from 'node:child_process';
+import { readFile, appendFile, writeFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { LineFramer, NdjsonValidator } from '../util/ndjson.js';
+export function registerSidecarTap(program) {
+    const cmd = new Command('sidecar')
+        .description('Sidecar process tools (wrap-and-run NDJSON tap, recorded replay)');
+    cmd
+        .command('tap')
+        .description('Spawn a sidecar via its exec command, frame stdout as NDJSON, optionally validate + record')
+        .argument('<command...>', 'Sidecar command and args (use -- to delimit)')
+        .option('--schema <path>', 'JSON Schema (file path) to validate each envelope against')
+        .option('--record <path>', 'Append the raw NDJSON stream to this file as it arrives')
+        .option('--raw', 'Echo the original sidecar stdout to our stdout (alongside structured envelopes on stderr)')
+        .option('--json', 'Emit structured envelopes as JSON (default)')
+        .action(async (commandTokens, opts) => {
+        if (commandTokens.length === 0) {
+            throw new Error('sidecar tap requires a command. Example: sidecar tap -- node my-sidecar.js');
+        }
+        const [exec, ...args] = commandTokens;
+        let validator;
+        if (opts.schema) {
+            if (!existsSync(opts.schema)) {
+                throw new Error(`Schema file not found: ${opts.schema}`);
+            }
+            const text = await readFile(opts.schema, 'utf-8');
+            let schemaJson;
+            try {
+                schemaJson = JSON.parse(text);
+            }
+            catch (err) {
+                throw new Error(`Failed to parse schema ${opts.schema}: ${err instanceof Error ? err.message : String(err)}`);
+            }
+            validator = new NdjsonValidator(schemaJson);
+        }
+        else {
+            validator = new NdjsonValidator();
+        }
+        if (opts.record) {
+            // Reset the recording file at the start of a tap session.
+            await writeFile(opts.record, '');
+        }
+        const child = spawn(exec, args, { stdio: ['ignore', 'pipe', 'pipe'] });
+        const framer = new LineFramer();
+        child.stdout.setEncoding('utf-8');
+        let envelopesEmitted = 0;
+        let invalidCount = 0;
+        child.stdout.on('data', async (chunk) => {
+            const lines = framer.push(chunk);
+            for (const line of lines) {
+                if (line.length === 0)
+                    continue;
+                await processLine(line, validator, opts);
+                envelopesEmitted++;
+                if (!validator.parse(line).ok)
+                    invalidCount++;
+            }
+        });
+        let stderrBuf = '';
+        child.stderr.setEncoding('utf-8');
+        child.stderr.on('data', (chunk) => {
+            // Forward sidecar stderr to ours, prefixed so it's distinguishable.
+            stderrBuf += chunk;
+            process.stderr.write(`[sidecar-stderr] ${chunk}`);
+        });
+        const exitCode = await new Promise((resolve, reject) => {
+            child.on('error', (err) => {
+                if (err.code === 'ENOENT') {
+                    reject(new Error(`sidecar exec not found: ${exec}`));
+                    return;
+                }
+                reject(err);
+            });
+            child.on('close', async (code) => {
+                const trailing = framer.flush();
+                if (trailing) {
+                    await processLine(trailing, validator, opts);
+                    envelopesEmitted++;
+                }
+                resolve(code ?? 0);
+            });
+        });
+        // Final summary on stderr so it doesn't pollute the NDJSON stream on stdout.
+        process.stderr.write(`[sidecar-tap] exited code=${exitCode} envelopes=${envelopesEmitted} invalid=${invalidCount}${stderrBuf.length > 0 ? ' stderr_bytes=' + stderrBuf.length : ''}\n`);
+        if (exitCode !== 0)
+            process.exitCode = exitCode;
+    });
+    program.addCommand(cmd);
+}
+async function processLine(line, validator, opts) {
+    if (opts.record) {
+        await appendFile(opts.record, line + '\n');
+    }
+    if (opts.raw) {
+        // Echo original line verbatim
+        process.stdout.write(line + '\n');
+        return;
+    }
+    const result = validator.parse(line);
+    const envelope = result.ok
+        ? {
+            ts: new Date().toISOString(),
+            direction: 'sidecar→',
+            valid: result.valid,
+            payload: result.value,
+            ...(result.errors.length > 0 ? { schemaErrors: result.errors } : {}),
+        }
+        : {
+            ts: new Date().toISOString(),
+            direction: 'sidecar→',
+            valid: false,
+            rawLine: line,
+            parseError: result.error,
+        };
+    console.log(JSON.stringify(envelope));
+}
+//# sourceMappingURL=sidecarTap.js.map

package/dist/commands/sidecarTap.js.map

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

package/dist/commands/snapshot.js

@@ -12,7 +12,7 @@ const PAGE_STATE_SCRIPT = `(() => {
     viewport: { width: window.innerWidth, height: window.innerHeight },
     scroll: { x: Math.round(window.scrollX), y: Math.round(window.scrollY) },
     document: { width: document.documentElement.scrollWidth, height: document.documentElement.scrollHeight },
-    hasTauri: !!(window.__TAURI__)
+    hasTauri: !!(window.__TAURI_INTERNALS__ || window.__TAURI__)
   });
 })()`;
 const STORAGE_SCRIPT = `(() => {

package/dist/commands/webviewAttach.d.ts

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

package/dist/commands/webviewAttach.js

@@ -0,0 +1,64 @@
+import { Command } from 'commander';
+import { exec } from '../util/exec.js';
+import { addBridgeOptions, resolveBridge } from './shared.js';
+export function registerWebviewAttach(program) {
+    const cmd = new Command('webview')
+        .description('Webview/devtools introspection (requires bridge v0.7.0+)');
+    const sub = cmd
+        .command('attach')
+        .description('Print the platform devtools URL or hint, optionally open in a browser')
+        .option('--print-url', 'Print only the inspector URL (or empty string if none)')
+        .option('--open', 'Open the inspector URL in the default browser (if available)')
+        .option('--json', 'Output as JSON');
+    addBridgeOptions(sub);
+    sub.action(async (opts) => {
+        const bridge = await resolveBridge(opts);
+        const dt = await bridge.devtools();
+        if (opts.json) {
+            console.log(JSON.stringify(dt, null, 2));
+            return;
+        }
+        if (opts.printUrl) {
+            console.log(dt.url ?? '');
+            return;
+        }
+        renderHuman(dt);
+        if (opts.open) {
+            if (!dt.url) {
+                console.error('--open requested but no inspector URL is available on this platform.');
+                process.exitCode = 2;
+                return;
+            }
+            await openInBrowser(dt.url);
+        }
+    });
+    program.addCommand(cmd);
+}
+function renderHuman(dt) {
+    console.log(`Webview platform: ${dt.platform}`);
+    console.log(`Inspectable:      ${dt.inspectable ? 'yes' : 'no'}`);
+    if (dt.url) {
+        console.log(`Inspector URL:    ${dt.url}`);
+    }
+    else {
+        console.log(`Inspector URL:    (not exposed)`);
+    }
+    console.log(`Hint:             ${dt.hint}`);
+}
+async function openInBrowser(url) {
+    // Cross-platform default-browser open via the host's standard tool.
+    const bin = process.platform === 'darwin'
+        ? 'open'
+        : process.platform === 'win32'
+            ? 'cmd'
+            : 'xdg-open';
+    const args = process.platform === 'win32' ? ['/c', 'start', '', url] : [url];
+    try {
+        await exec(bin, args, { timeout: 5000 });
+    }
+    catch (err) {
+        console.error(`Failed to launch browser: ${err instanceof Error ? err.message : String(err)}`);
+        process.exitCode = 2;
+    }
+}
+//# sourceMappingURL=webviewAttach.js.map

package/dist/commands/webviewAttach.js.map

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

package/dist/platform/oslog/darwin.d.ts

@@ -0,0 +1,21 @@
+import type { NormalizedLogEntry } from '../../schemas/osLog.js';
+export interface DarwinSpawnArgs {
+    identifier: string;
+    productName: string;
+    since?: string;
+}
+/**
+ * Build `log stream` args for the macOS unified log. We filter by either the
+ * subsystem (matches `OSLog.Logger`/Rust `tracing` subsystem when configured)
+ * or by sender image path (catches everything the app process emits even when
+ * the subsystem isn't set). Returns argv suitable for execFile.
+ */
+export declare function buildArgs({ identifier, productName, since }: DarwinSpawnArgs): string[];
+/**
+ * Parse a single `log stream --style ndjson` line into our normalized shape.
+ * Returns null when the line is metadata (e.g., the initial "Filtering the
+ * log data using…" line which is not valid JSON).
+ */
+export declare function parseLine(line: string): NormalizedLogEntry | null;
+/** The actual command binary the adapter shells out to. */
+export declare const COMMAND = "log";