tauri-agent-tools 0.5.1 → 0.7.0

package/dist/commands/probe.js

@@ -0,0 +1,117 @@
+import { Command } from 'commander';
+import { detectDisplayServer } from '../platform/detect.js';
+import { addBridgeOptions, resolveBridge } from './shared.js';
+import { discoverBridgesByPid, discoverBridge } from '../bridge/tokenDiscovery.js';
+export function registerProbe(program) {
+    const cmd = new Command('probe')
+        .description('Discover and report Tauri app targets and bridge health')
+        .option('--json', 'Output as JSON');
+    addBridgeOptions(cmd);
+    cmd.action(async (opts) => {
+        // 1. Discover all bridges by PID
+        const bridgesByPid = await discoverBridgesByPid();
+        const allBridges = [...bridgesByPid.entries()].map(([pid, cfg]) => ({
+            pid,
+            port: cfg.port,
+        }));
+        // 2. Resolve specific bridge (may throw if none found)
+        const bridge = await resolveBridge(opts);
+        // 3. Ping
+        const alive = await bridge.ping();
+        // 4. Get version (graceful null on 404)
+        const versionInfo = await bridge.version();
+        // 5. Get describe (graceful null on 404)
+        const describeInfo = await bridge.describe();
+        // 6. Get page info via eval (try/catch each independently)
+        let url = null;
+        let title = null;
+        let viewport = null;
+        try {
+            url = String(await bridge.eval('window.location.href'));
+        }
+        catch {
+            // bridge may be unreachable or page not loaded
+        }
+        try {
+            title = String(await bridge.eval('document.title'));
+        }
+        catch {
+            // ignore
+        }
+        try {
+            viewport = await bridge.getViewportSize();
+        }
+        catch {
+            // ignore
+        }
+        // 7. Detect platform
+        const platform = detectDisplayServer();
+        // Determine the port for the target by checking opts or discovered bridge
+        let targetPort = opts.port;
+        if (targetPort === undefined) {
+            if (opts.pid !== undefined) {
+                const pidEntry = bridgesByPid.get(opts.pid);
+                targetPort = pidEntry?.port;
+            }
+            if (targetPort === undefined) {
+                const first = await discoverBridge();
+                targetPort = first?.port;
+            }
+        }
+        const result = {
+            bridges: allBridges,
+            target: {
+                alive,
+                version: versionInfo,
+                describe: describeInfo,
+                page: { url, title, viewport },
+            },
+            platform,
+        };
+        if (opts.json) {
+            console.log(JSON.stringify(result, null, 2));
+            return;
+        }
+        // Human-readable output
+        console.log('=== Tauri Bridge Probe ===');
+        console.log('');
+        if (allBridges.length === 0) {
+            console.log('Running bridges:  none');
+        }
+        else {
+            console.log(`Running bridges:  ${allBridges.length}`);
+            for (const b of allBridges) {
+                console.log(`  PID ${b.pid}  port ${b.port}`);
+            }
+        }
+        console.log('');
+        console.log(`Platform:         ${platform}`);
+        console.log(`Bridge alive:     ${alive ? 'yes' : 'no'}`);
+        if (versionInfo) {
+            console.log(`Bridge version:   ${versionInfo.version}`);
+            console.log(`Endpoints:        ${versionInfo.endpoints.join(', ')}`);
+        }
+        if (describeInfo) {
+            if (describeInfo.app !== undefined)
+                console.log(`App:              ${describeInfo.app}`);
+            if (describeInfo.pid !== undefined)
+                console.log(`App PID:          ${describeInfo.pid}`);
+            if (describeInfo.windows !== undefined)
+                console.log(`Windows:          ${describeInfo.windows.join(', ')}`);
+            if (describeInfo.capabilities !== undefined)
+                console.log(`Capabilities:     ${describeInfo.capabilities.join(', ')}`);
+        }
+        console.log('');
+        console.log('Page:');
+        console.log(`  URL:      ${url ?? '(unavailable)'}`);
+        console.log(`  Title:    ${title ?? '(unavailable)'}`);
+        if (viewport) {
+            console.log(`  Viewport: ${viewport.width}x${viewport.height}`);
+        }
+        else {
+            console.log('  Viewport: (unavailable)');
+        }
+    });
+    program.addCommand(cmd);
+}
+//# sourceMappingURL=probe.js.map

package/dist/commands/probe.js.map

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

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/shared.d.ts

@@ -1,13 +1,19 @@
 import type { Command } from 'commander';
 import type { z } from 'zod';
 import { BridgeClient } from '../bridge/client.js';
+/**
+ * Options parsed from the bridge-related CLI flags.
+ */
+export interface BridgeOpts {
+    port?: number;
+    token?: string;
+    pid?: number;
+    windowLabel?: string;
+}
 /**
  * Parse a value with a Zod enum schema, throwing a human-readable error on failure.
  * Replaces raw `.parse()` calls that would surface cryptic ZodError messages.
  */
 export declare function parseEnum<T extends [string, ...string[]]>(schema: z.ZodEnum<T>, value: string, label: string): T[number];
 export declare function addBridgeOptions(cmd: Command): Command;
-export declare function resolveBridge(opts: {
-    port?: number;
-    token?: string;
-}): Promise<BridgeClient>;
+export declare function resolveBridge(opts: BridgeOpts): Promise<BridgeClient>;

package/dist/commands/shared.js

@@ -1,5 +1,5 @@
 import { BridgeClient } from '../bridge/client.js';
-import { discoverBridge } from '../bridge/tokenDiscovery.js';
+import { discoverBridge, discoverBridgesByPid } from '../bridge/tokenDiscovery.js';
 /**
  * Parse a value with a Zod enum schema, throwing a human-readable error on failure.
  * Replaces raw `.parse()` calls that would surface cryptic ZodError messages.
@@ -14,14 +14,34 @@ export function parseEnum(schema, value, label) {
 export function addBridgeOptions(cmd) {
     return cmd
         .option('--port <number>', 'Bridge port (auto-discover if omitted)', parseInt)
-        .option('--token <string>', 'Bridge token (auto-discover if omitted)');
+        .option('--token <string>', 'Bridge token (auto-discover if omitted)')
+        .option('--pid <number>', 'Target app PID (auto-discover if omitted)', parseInt)
+        .option('--window-label <label>', 'Target window label (default: main)');
 }
 export async function resolveBridge(opts) {
     let config;
     if (opts.port && opts.token) {
+        // Explicit port + token: skip discovery entirely
         config = { port: opts.port, token: opts.token };
     }
+    else if (opts.pid !== undefined) {
+        // PID-targeted discovery
+        const bridges = await discoverBridgesByPid();
+        const match = bridges.get(opts.pid);
+        if (!match) {
+            const pids = [...bridges.keys()];
+            const listing = pids.length > 0
+                ? `Running bridges:\n${pids.map((p) => `  PID ${p}`).join('\n')}`
+                : 'No running bridges found.';
+            throw new Error(`No bridge found for PID ${opts.pid}.\n${listing}`);
+        }
+        config = {
+            port: opts.port ?? match.port,
+            token: opts.token ?? match.token,
+        };
+    }
     else {
+        // First-match discovery
         const discovered = await discoverBridge();
         if (!discovered) {
             throw new Error('No bridge found. Either:\n' +
@@ -33,6 +53,6 @@ export async function resolveBridge(opts) {
             token: opts.token ?? discovered.token,
         };
     }
-    return new BridgeClient(config);
+    return new BridgeClient(config, opts.windowLabel);
 }
 //# sourceMappingURL=shared.js.map

package/dist/commands/shared.js.map

@@ -1 +1 @@
-{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../src/commands/shared.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAE7D;;;GAGG;AACH,MAAM,UAAU,SAAS,CACvB,MAAoB,EACpB,KAAa,EACb,KAAa;IAEb,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACvC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,WAAW,KAAK,KAAK,KAAK,qBAAqB,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC9F,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,GAAY;IAC3C,OAAO,GAAG;SACP,MAAM,CAAC,iBAAiB,EAAE,wCAAwC,EAAE,QAAQ,CAAC;SAC7E,MAAM,CAAC,kBAAkB,EAAE,yCAAyC,CAAC,CAAC;AAC3E,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAGnC;IACC,IAAI,MAAoB,CAAC;IAEzB,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QAC5B,MAAM,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;IAClD,CAAC;SAAM,CAAC;QACN,MAAM,UAAU,GAAG,MAAM,cAAc,EAAE,CAAC;QAC1C,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CACb,4BAA4B;gBAC1B,mDAAmD;gBACnD,0CAA0C,CAC7C,CAAC;QACJ,CAAC;QACD,MAAM,GAAG;YACP,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,UAAU,CAAC,IAAI;YAClC,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,UAAU,CAAC,KAAK;SACtC,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC;AAClC,CAAC"}
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../src/commands/shared.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAYnF;;;GAGG;AACH,MAAM,UAAU,SAAS,CACvB,MAAoB,EACpB,KAAa,EACb,KAAa;IAEb,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACvC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,WAAW,KAAK,KAAK,KAAK,qBAAqB,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC9F,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,GAAY;IAC3C,OAAO,GAAG;SACP,MAAM,CAAC,iBAAiB,EAAE,wCAAwC,EAAE,QAAQ,CAAC;SAC7E,MAAM,CAAC,kBAAkB,EAAE,yCAAyC,CAAC;SACrE,MAAM,CAAC,gBAAgB,EAAE,2CAA2C,EAAE,QAAQ,CAAC;SAC/E,MAAM,CAAC,wBAAwB,EAAE,qCAAqC,CAAC,CAAC;AAC7E,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAgB;IAClD,IAAI,MAAoB,CAAC;IAEzB,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QAC5B,iDAAiD;QACjD,MAAM,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;IAClD,CAAC;SAAM,IAAI,IAAI,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;QAClC,yBAAyB;QACzB,MAAM,OAAO,GAAG,MAAM,oBAAoB,EAAE,CAAC;QAC7C,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACpC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;YACjC,MAAM,OAAO,GACX,IAAI,CAAC,MAAM,GAAG,CAAC;gBACb,CAAC,CAAC,qBAAqB,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;gBACjE,CAAC,CAAC,2BAA2B,CAAC;YAClC,MAAM,IAAI,KAAK,CACb,2BAA2B,IAAI,CAAC,GAAG,MAAM,OAAO,EAAE,CACnD,CAAC;QACJ,CAAC;QACD,MAAM,GAAG;YACP,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI;YAC7B,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK;SACjC,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,wBAAwB;QACxB,MAAM,UAAU,GAAG,MAAM,cAAc,EAAE,CAAC;QAC1C,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CACb,4BAA4B;gBAC1B,mDAAmD;gBACnD,0CAA0C,CAC7C,CAAC;QACJ,CAAC;QACD,MAAM,GAAG;YACP,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,UAAU,CAAC,IAAI;YAClC,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,UAAU,CAAC,KAAK;SACtC,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;AACpD,CAAC"}

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":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AASrC;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAgB;IACpD,uEAAuE;IACvE,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,SAAS,CAAC,CAAC;IACrE,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;IAC7E,CAAC;IAED,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,+DAA+D,CAAC;SAC5E,QAAQ,CAAC,QAAQ,EAAE,wDAAwD,CAAC;SAC5E,MAAM,CAAC,aAAa,EAAE,yCAAyC,CAAC;SAChE,MAAM,CAAC,iBAAiB,EAAE,wEAAwE,CAAC;SACnG,MAAM,CAAC,cAAc,EAAE,kEAAkE,CAAC;SAC1F,MAAM,CAAC,QAAQ,EAAE,4DAA4D,CAAC;SAC9E,MAAM,CAAC,KAAK,EAAE,IAAY,EAAE,IAAuB,EAAE,EAAE;QACtD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,6BAA6B,IAAI,EAAE,CAAC,CAAC;QACvD,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,iBAAiB,CAAC;QACzE,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAEpE,MAAM,KAAK,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;aAC1C,KAAK,CAAC,OAAO,CAAC;aACd,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAE/B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,wCAAwC,IAAI,IAAI,CAAC,CAAC;YACvE,OAAO;QACT,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,MAAM,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,IAAI,KAAK,CAAC,CAAC;QACtE,CAAC;aAAM,CAAC;YACN,MAAM,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,IAAI,KAAK,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC;AAED,SAAS,SAAS,CAAC,KAAa;IAC9B,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IACxB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,6DAA6D,KAAK,EAAE,CAAC,CAAC;IACxF,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,KAAK,UAAU,cAAc,CAAC,KAAe,EAAE,OAAe,EAAE,IAAa;IAC3E,GAAG,CAAC;QACF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;YAClC,IAAI,OAAO,GAAG,CAAC;gBAAE,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC;QACxC,CAAC;IACH,CAAC,QAAQ,IAAI,EAAE;AACjB,CAAC;AAED,KAAK,UAAU,YAAY,CACzB,KAAe,EACf,OAAe,EACf,OAAe,EACf,IAAa;IAEb,gFAAgF;IAChF,MAAM,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC7C,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;IAC/D,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,CAAC,EAAE,CAAC,CAAC;IAE3E,MAAM,MAAM,GAAG,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrD,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACxC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,GAAG,CAAC;YACF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC;oBACpC,MAAM,IAAI,OAAO,CAAO,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;gBAC/D,CAAC;gBACD,IAAI,OAAO,GAAG,CAAC;oBAAE,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC;YACxC,CAAC;QACH,CAAC,QAAQ,IAAI,EAAE;QACf,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;IACpB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACtB,MAAM,GAAG,CAAC;IACZ,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC;IAC9B,IAAI,QAAQ,KAAK,CAAC;QAAE,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC;AAClD,CAAC;AAED,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;AAC/C,CAAC"}

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/storeInspect.d.ts

@@ -0,0 +1,13 @@
+import { Command } from 'commander';
+/**
+ * Builds a JavaScript IIFE that detects and serializes reactive stores
+ * from the target framework running in the Tauri webview.
+ *
+ * Detection priority:
+ * 1. window.__DEBUG_STORES__ (app-registered hook)
+ * 2. window.__pinia (Pinia store)
+ * 3. window.__VUE_DEVTOOLS_GLOBAL_HOOK__ (Vue devtools hook)
+ * 4. Fallback: unknown with empty stores
+ */
+export declare function buildStoreDetectionScript(framework: string, storeName?: string, depth?: number): string;
+export declare function registerStoreInspect(program: Command): void;