@upbeat-works/fisgon 0.1.0

package/dist/cli/commands/start.js

@@ -0,0 +1,169 @@
+import { spawn } from 'node:child_process';
+import { existsSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { resolve, join } from 'node:path';
+import { Command } from 'commander';
+import { createBrowserHandler } from '../browser-handler.js';
+import { launchBrowser } from '../browser-setup.js';
+import { loadConfig } from '../config.js';
+import { connectToAgent } from '../connection.js';
+export const startCommand = new Command('start')
+    .description('Start a Fisgon test session')
+    .option('-p, --port <port>', 'Agent port (local mode)', '9876')
+    .option('--agent <url>', 'Remote agent URL (e.g. wss://fisgon.example.workers.dev)')
+    .option('--env <name>', 'DO instance name (e.g. staging, pr-123)', 'default')
+    .option('--remote', 'Use remote browser (Browser Rendering) instead of local Playwright')
+    .option('--no-browser', 'Skip launching browser (browser commands will fail)')
+    .option('--identity <entries...>', 'Session identity entries: name:email:password (can specify multiple)')
+    .action(async (options) => {
+    const port = parseInt(options.port, 10);
+    const config = await loadConfig();
+    if (!config) {
+        console.error('No fisgon.config.ts found in current directory');
+        process.exit(1);
+    }
+    const agentUrl = options.agent ?? config.agent;
+    const isRemote = !!agentUrl;
+    const effectivePort = config.port ?? port;
+    const envName = options.env;
+    const browserMode = options.remote ? 'remote' : 'local';
+    // Parse --identity entries (format: name:email:password)
+    let sessionIdentity;
+    if (options.identity) {
+        sessionIdentity = {};
+        for (const entry of options.identity) {
+            const [name, email, ...passwordParts] = entry.split(':');
+            const password = passwordParts.join(':');
+            if (!name || !email || !password) {
+                console.error(`Invalid identity format: ${entry}. Use name:email:password`);
+                process.exit(1);
+            }
+            sessionIdentity[name] = { email, password };
+        }
+    }
+    let wranglerPid;
+    // 1. In local mode, spawn wrangler dev for the agent
+    if (!isRemote) {
+        console.log('Starting Fisgon agent...');
+        const fisgonRoot = resolve(import.meta.dirname, '../../..');
+        const wranglerConfigPath = resolve(fisgonRoot, 'wrangler.jsonc');
+        const devVarsPath = resolve(fisgonRoot, '.dev.vars');
+        const wranglerArgs = [
+            'wrangler',
+            'dev',
+            '--config',
+            wranglerConfigPath,
+            '--port',
+            String(effectivePort),
+        ];
+        if (existsSync(devVarsPath)) {
+            wranglerArgs.push('--env-file', devVarsPath);
+        }
+        const wrangler = spawn('npx', wranglerArgs, {
+            stdio: ['pipe', 'pipe', 'pipe'],
+            env: { ...process.env },
+        });
+        wranglerPid = wrangler.pid;
+        try {
+            await new Promise((waitResolve, reject) => {
+                const timeout = setTimeout(() => reject(new Error('Wrangler startup timed out')), 30000);
+                wrangler.stderr?.on('data', (data) => {
+                    if (data.toString().includes('Ready on')) {
+                        clearTimeout(timeout);
+                        waitResolve();
+                    }
+                });
+                wrangler.stdout?.on('data', (data) => {
+                    if (data.toString().includes('Ready on')) {
+                        clearTimeout(timeout);
+                        waitResolve();
+                    }
+                });
+                wrangler.on('error', (err) => {
+                    clearTimeout(timeout);
+                    reject(err);
+                });
+                wrangler.on('exit', (code) => {
+                    clearTimeout(timeout);
+                    if (code !== 0)
+                        reject(new Error(`Wrangler exited with code ${code}`));
+                });
+            });
+        }
+        catch (err) {
+            console.error('Failed to start wrangler:', err);
+            process.exit(1);
+        }
+        console.log(`Agent running on port ${effectivePort}`);
+        // Cleanup on exit
+        const cleanup = () => {
+            wrangler.kill();
+            process.exit(0);
+        };
+        process.on('SIGINT', cleanup);
+        process.on('SIGTERM', cleanup);
+    }
+    else {
+        console.log(`Connecting to remote agent: ${agentUrl}`);
+    }
+    // 2. Connect to the agent
+    let conn;
+    try {
+        if (!isRemote) {
+            await new Promise((r) => setTimeout(r, 1000));
+        }
+        conn = await connectToAgent({
+            port: isRemote ? undefined : effectivePort,
+            agent: agentUrl,
+            env: envName,
+        });
+    }
+    catch (err) {
+        console.error('Failed to connect to agent:', err);
+        process.exit(1);
+    }
+    // 3. Start session on the agent via RPC
+    const startResult = await conn.call('startSession', [config, browserMode, sessionIdentity]);
+    const { sessionId } = startResult;
+    console.log(`Session started: ${sessionId}`);
+    // Reconnect with sessionId so the agent associates this CLI connection.
+    // hasBrowser tells the agent this is the browser-owning connection,
+    // so it survives DO hibernation and is preferred during recovery.
+    conn.close();
+    conn = await connectToAgent({
+        port: isRemote ? undefined : effectivePort,
+        agent: agentUrl,
+        env: envName,
+        sessionId,
+        hasBrowser: true,
+    });
+    // 4. Launch local Playwright browser if in local browser mode
+    if (browserMode === 'local' && options.browser !== false) {
+        try {
+            const { page } = await launchBrowser(config, sessionId);
+            // Register browser command handler — sends results via AgentClient
+            const handleBrowserCommand = createBrowserHandler(conn.client, page);
+            conn.onBrowserCommand(handleBrowserCommand);
+            console.log(`Browser ready at ${config.url}`);
+        }
+        catch (err) {
+            console.error('Failed to launch browser:', err);
+            console.log('Continuing without browser — browser commands will fail');
+        }
+    }
+    else if (browserMode === 'remote') {
+        console.log('Using remote browser (Browser Rendering)');
+    }
+    // Write session info so other commands can find it
+    writeFileSync(join(tmpdir(), 'fisgon.json'), JSON.stringify({
+        port: effectivePort,
+        pid: process.pid,
+        sessionId,
+        agent: agentUrl,
+        env: envName,
+        wranglerPid,
+    }));
+    console.log('Fisgon is running. Use other commands in a separate terminal.');
+    console.log('Press Ctrl+C to stop.');
+});
+//# sourceMappingURL=start.js.map

package/dist/cli/commands/start.js.map

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

package/dist/cli/commands/stop.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare const stopCommand: Command;
+//# sourceMappingURL=stop.d.ts.map

package/dist/cli/commands/stop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/stop.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAKnC,eAAO,MAAM,WAAW,SAgCrB,CAAA"}

package/dist/cli/commands/stop.js

@@ -0,0 +1,37 @@
+import { Command } from 'commander';
+import { connectToAgent } from '../connection.js';
+import { getRunningSession } from '../session-file.js';
+export const stopCommand = new Command('stop')
+    .description('Stop the current Fisgon session')
+    .action(async () => {
+    const session = getRunningSession();
+    if (!session) {
+        console.error('No running Fisgon session found');
+        process.exit(1);
+    }
+    try {
+        const conn = await connectToAgent({
+            port: session.port,
+            agent: session.agent,
+            env: session.env,
+            sessionId: session.sessionId,
+        });
+        await conn.call('stopSession', [session.sessionId]);
+        console.log('Session stopped');
+        conn.close();
+    }
+    catch (err) {
+        console.error('Failed to stop session:', err);
+        process.exit(1);
+    }
+    // Kill the start process (local mode only)
+    if (session.pid && !session.agent) {
+        try {
+            process.kill(session.pid, 'SIGTERM');
+        }
+        catch {
+            // Process may already be dead
+        }
+    }
+});
+//# sourceMappingURL=stop.js.map

package/dist/cli/commands/stop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop.js","sourceRoot":"","sources":["../../../src/cli/commands/stop.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAEnC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAEtD,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC;KAC5C,WAAW,CAAC,iCAAiC,CAAC;KAC9C,MAAM,CAAC,KAAK,IAAI,EAAE;IAClB,MAAM,OAAO,GAAG,iBAAiB,EAAE,CAAA;IACnC,IAAI,CAAC,OAAO,EAAE,CAAC;QACd,OAAO,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAA;QAChD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IAChB,CAAC;IAED,IAAI,CAAC;QACJ,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC;YACjC,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,SAAS,EAAE,OAAO,CAAC,SAAS;SAC5B,CAAC,CAAA;QACF,MAAM,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAA;QACnD,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAA;QAC9B,IAAI,CAAC,KAAK,EAAE,CAAA;IACb,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACd,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,GAAG,CAAC,CAAA;QAC7C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IAChB,CAAC;IAED,2CAA2C;IAC3C,IAAI,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACnC,IAAI,CAAC;YACJ,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,SAAS,CAAC,CAAA;QACrC,CAAC;QAAC,MAAM,CAAC;YACR,8BAA8B;QAC/B,CAAC;IACF,CAAC;AACF,CAAC,CAAC,CAAA"}

package/dist/cli/commands/tick.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare const tickCommand: Command;
+//# sourceMappingURL=tick.d.ts.map

package/dist/cli/commands/tick.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tick.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/tick.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAMnC,eAAO,MAAM,WAAW,SAyCrB,CAAA"}

package/dist/cli/commands/tick.js

@@ -0,0 +1,34 @@
+import { Command } from 'commander';
+import { connectToAgent } from '../connection.js';
+import { getRunningSession } from '../session-file.js';
+export const tickCommand = new Command('tick')
+    .description('Wait for the next tick and print its events')
+    .option('-t, --timeout <ms>', 'Timeout in milliseconds', '30000')
+    .action(async (options) => {
+    const session = getRunningSession();
+    if (!session) {
+        console.error('No running Fisgon session. Run `fisgon start` first.');
+        process.exit(1);
+    }
+    const timeout = parseInt(options.timeout, 10);
+    try {
+        const conn = await connectToAgent({
+            port: session.port,
+            agent: session.agent,
+            env: session.env,
+            sessionId: session.sessionId,
+        });
+        const result = await conn.call('waitForNextTick', [session.sessionId, timeout], { timeout: timeout + 5000 });
+        const tick = result.tick;
+        console.log(`Tick #${tick.id} (${tick.duration}ms, ${tick.events.length} events):`);
+        for (const event of tick.events) {
+            console.log(`  ${event.source}:${event.type}`, JSON.stringify(event.data));
+        }
+        conn.close();
+    }
+    catch (err) {
+        console.error('Tick failed:', err);
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=tick.js.map

package/dist/cli/commands/tick.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tick.js","sourceRoot":"","sources":["../../../src/cli/commands/tick.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAGnC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAEtD,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC;KAC5C,WAAW,CAAC,6CAA6C,CAAC;KAC1D,MAAM,CAAC,oBAAoB,EAAE,yBAAyB,EAAE,OAAO,CAAC;KAChE,MAAM,CAAC,KAAK,EAAE,OAA4B,EAAE,EAAE;IAC9C,MAAM,OAAO,GAAG,iBAAiB,EAAE,CAAA;IACnC,IAAI,CAAC,OAAO,EAAE,CAAC;QACd,OAAO,CAAC,KAAK,CAAC,sDAAsD,CAAC,CAAA;QACrE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IAChB,CAAC;IAED,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAA;IAE7C,IAAI,CAAC;QACJ,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC;YACjC,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,SAAS,EAAE,OAAO,CAAC,SAAS;SAC5B,CAAC,CAAA;QACF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAC7B,iBAAiB,EACjB,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,EAC5B,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,EAAE,CAC3B,CAAA;QAED,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAA;QACxB,OAAO,CAAC,GAAG,CACV,SAAS,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,QAAQ,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,WAAW,CACtE,CAAA;QACD,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACjC,OAAO,CAAC,GAAG,CACV,KAAK,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,IAAI,EAAE,EACjC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAC1B,CAAA;QACF,CAAC;QAED,IAAI,CAAC,KAAK,EAAE,CAAA;IACb,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACd,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,GAAG,CAAC,CAAA;QAClC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IAChB,CAAC;AACF,CAAC,CAAC,CAAA"}

package/dist/cli/config.d.ts

@@ -0,0 +1,3 @@
+import { type FisgonConfig } from '../core/types.js';
+export declare function loadConfig(cwd?: string): Promise<FisgonConfig | null>;
+//# sourceMappingURL=config.d.ts.map

package/dist/cli/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/cli/config.ts"],"names":[],"mappings":"AAGA,OAAQ,EAAE,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAIrD,wBAAsB,UAAU,CAAC,GAAG,SAAgB,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAalF"}

package/dist/cli/config.js

@@ -0,0 +1,20 @@
+import { existsSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { pathToFileURL } from 'node:url';
+const CONFIG_FILES = ['fisgon.config.ts', 'fisgon.config.js', 'fisgon.config.mjs'];
+export async function loadConfig(cwd = process.cwd()) {
+    for (const file of CONFIG_FILES) {
+        const fullPath = resolve(cwd, file);
+        if (existsSync(fullPath)) {
+            try {
+                const mod = await import(pathToFileURL(fullPath).href);
+                return mod.default ?? mod;
+            }
+            catch {
+                // Try next
+            }
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=config.js.map

package/dist/cli/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/cli/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAGxC,MAAM,YAAY,GAAG,CAAC,kBAAkB,EAAE,kBAAkB,EAAE,mBAAmB,CAAC,CAAA;AAElF,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE;IAClD,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;QAChC,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;QACnC,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YACzB,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAA;gBACtD,OAAO,GAAG,CAAC,OAAO,IAAI,GAAG,CAAA;YAC3B,CAAC;YAAC,MAAM,CAAC;gBACP,WAAW;YACb,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC"}

package/dist/cli/connection.d.ts

@@ -0,0 +1,18 @@
+import { AgentClient } from 'agents/client';
+import { type AgentState } from '../agent/session-state.js';
+type ConnectOptions = {
+    port?: number;
+    agent?: string;
+    env?: string;
+    sessionId?: string;
+    hasBrowser?: boolean;
+};
+export type AgentConnection = {
+    client: AgentClient<AgentState>;
+    call: AgentClient<AgentState>['call'];
+    onBrowserCommand(handler: (command: unknown) => void): void;
+    close(): void;
+};
+export declare function connectToAgent(options: ConnectOptions): Promise<AgentConnection>;
+export {};
+//# sourceMappingURL=connection.d.ts.map

package/dist/cli/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../src/cli/connection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAA2B,MAAM,eAAe,CAAA;AAGpE,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,2BAA2B,CAAA;AAE3D,KAAK,cAAc,GAAG;IACrB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,OAAO,CAAA;CACpB,CAAA;AAED,MAAM,MAAM,eAAe,GAAG;IAC7B,MAAM,EAAE,WAAW,CAAC,UAAU,CAAC,CAAA;IAC/B,IAAI,EAAE,WAAW,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAA;IACrC,gBAAgB,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAAA;IAC3D,KAAK,IAAI,IAAI,CAAA;CACb,CAAA;AAKD,wBAAgB,cAAc,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,CA4EhF"}

package/dist/cli/connection.js

@@ -0,0 +1,79 @@
+import { AgentClient } from 'agents/client';
+import WebSocket from 'ws';
+const DEFAULT_PORT = 9876;
+const AGENT_NAME = 'fisgon';
+export function connectToAgent(options) {
+    return new Promise((resolve, reject) => {
+        const env = options.env ?? 'default';
+        const host = options.agent
+            ? new URL(options.agent).host
+            : `localhost:${options.port ?? DEFAULT_PORT}`;
+        const protocol = options.agent?.startsWith('wss') ? 'wss' : 'ws';
+        const query = { role: 'cli' };
+        if (options.sessionId) {
+            query.sessionId = options.sessionId;
+        }
+        if (options.hasBrowser) {
+            query.hasBrowser = 'true';
+        }
+        const clientOptions = {
+            agent: AGENT_NAME,
+            name: env,
+            host,
+            protocol: protocol,
+            query,
+            // Use Node.js ws package as the WebSocket implementation
+            WebSocket: WebSocket,
+        };
+        const client = new AgentClient(clientOptions);
+        let browserCommandHandler = null;
+        // The underlying PartySocket handles reconnection.
+        // We listen for raw messages to intercept browser commands from the agent.
+        client.addEventListener('message', (event) => {
+            try {
+                const msg = JSON.parse(String(event.data));
+                if (msg.type?.startsWith('browser-') && msg.commandId) {
+                    browserCommandHandler?.(msg);
+                }
+            }
+            catch {
+                // Ignore malformed messages
+            }
+        });
+        let settled = false;
+        // Wait for the agent to send identity (connection is ready).
+        // PartySocket retries on transient WebSocket errors, so we don't
+        // reject on individual error events — only on ready-rejection or timeout.
+        client.ready
+            .then(() => {
+            if (settled)
+                return;
+            settled = true;
+            const connection = {
+                client,
+                call: client.call.bind(client),
+                onBrowserCommand(handler) {
+                    browserCommandHandler = handler;
+                },
+                close() {
+                    client.close();
+                },
+            };
+            resolve(connection);
+        })
+            .catch((err) => {
+            if (settled)
+                return;
+            settled = true;
+            reject(err);
+        });
+        setTimeout(() => {
+            if (settled)
+                return;
+            settled = true;
+            client.close();
+            reject(new Error('Connection to agent timed out'));
+        }, 15000);
+    });
+}
+//# sourceMappingURL=connection.js.map

package/dist/cli/connection.js.map

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

package/dist/cli/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":""}

package/dist/cli/index.js

@@ -0,0 +1,29 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { actionsCommand } from './commands/actions.js';
+import { doCommand } from './commands/do.js';
+import { eventsCommand } from './commands/events.js';
+import { interactCommand } from './commands/interact.js';
+import { navigateCommand } from './commands/navigate.js';
+import { openCommand } from './commands/open.js';
+import { runCommand } from './commands/run.js';
+import { startCommand } from './commands/start.js';
+import { stopCommand } from './commands/stop.js';
+import { tickCommand } from './commands/tick.js';
+const program = new Command();
+program
+    .name('fisgon')
+    .description('Low-level primitives for LLM-driven application testing')
+    .version('0.1.0');
+program.addCommand(startCommand);
+program.addCommand(stopCommand);
+program.addCommand(navigateCommand);
+program.addCommand(actionsCommand);
+program.addCommand(openCommand);
+program.addCommand(interactCommand);
+program.addCommand(tickCommand);
+program.addCommand(eventsCommand);
+program.addCommand(doCommand);
+program.addCommand(runCommand);
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAEhD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAA;AAE7B,OAAO;KACJ,IAAI,CAAC,QAAQ,CAAC;KACd,WAAW,CAAC,yDAAyD,CAAC;KACtE,OAAO,CAAC,OAAO,CAAC,CAAA;AAEnB,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAA;AAChC,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAA;AAC/B,OAAO,CAAC,UAAU,CAAC,eAAe,CAAC,CAAA;AACnC,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC,CAAA;AAClC,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAA;AAC/B,OAAO,CAAC,UAAU,CAAC,eAAe,CAAC,CAAA;AACnC,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAA;AAC/B,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,CAAA;AACjC,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,CAAA;AAC7B,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,CAAA;AAE9B,OAAO,CAAC,KAAK,EAAE,CAAA"}

package/dist/cli/session-file.d.ts

@@ -0,0 +1,9 @@
+export type SessionInfo = {
+    port: number;
+    pid: number;
+    sessionId: string;
+    agent?: string;
+    env?: string;
+};
+export declare function getRunningSession(): SessionInfo | null;
+//# sourceMappingURL=session-file.d.ts.map

package/dist/cli/session-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-file.d.ts","sourceRoot":"","sources":["../../src/cli/session-file.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,WAAW,GAAG;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;IACX,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,GAAG,CAAC,EAAE,MAAM,CAAA;CACZ,CAAA;AAED,wBAAgB,iBAAiB,IAAI,WAAW,GAAG,IAAI,CAetD"}

package/dist/cli/session-file.js

@@ -0,0 +1,23 @@
+import { readFileSync, existsSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+const SESSION_FILE = join(tmpdir(), 'fisgon.json');
+export function getRunningSession() {
+    if (!existsSync(SESSION_FILE))
+        return null;
+    try {
+        const data = JSON.parse(readFileSync(SESSION_FILE, 'utf-8'));
+        // Check if the process is still alive
+        try {
+            process.kill(data.pid, 0);
+            return data;
+        }
+        catch {
+            return null;
+        }
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=session-file.js.map

package/dist/cli/session-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-file.js","sourceRoot":"","sources":["../../src/cli/session-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAClD,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAChC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEhC,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,EAAE,EAAE,aAAa,CAAC,CAAA;AAUlD,MAAM,UAAU,iBAAiB;IAChC,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC;QAAE,OAAO,IAAI,CAAA;IAE1C,IAAI,CAAC;QACJ,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,CAAA;QAC5D,sCAAsC;QACtC,IAAI,CAAC;YACJ,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAA;YACzB,OAAO,IAAI,CAAA;QACZ,CAAC;QAAC,MAAM,CAAC;YACR,OAAO,IAAI,CAAA;QACZ,CAAC;IACF,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,IAAI,CAAA;IACZ,CAAC;AACF,CAAC"}

package/dist/cli/task-runner.d.ts

@@ -0,0 +1,20 @@
+import { type TaskFile } from '../core/task-file.js';
+import { type PlaywrightPage } from './browser-handler.js';
+import { type AgentConnection } from './connection.js';
+type ReplayOptions = {
+    fallback?: boolean;
+    verbose?: boolean;
+    page?: PlaywrightPage;
+};
+type ReplayResult = {
+    success: boolean;
+    failedStep?: number;
+    error?: string;
+};
+/**
+ * Replay a persisted task by executing its steps directly via agent RPC.
+ * Falls back to LLM for individual steps if they fail and fallback is enabled.
+ */
+export declare function replayTask(conn: AgentConnection, sessionId: string, task: TaskFile, params: Record<string, string>, options?: ReplayOptions): Promise<ReplayResult>;
+export {};
+//# sourceMappingURL=task-runner.d.ts.map

package/dist/cli/task-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-runner.d.ts","sourceRoot":"","sources":["../../src/cli/task-runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAC1D,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAEtD,KAAK,aAAa,GAAG;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,IAAI,CAAC,EAAE,cAAc,CAAA;CACrB,CAAA;AAED,KAAK,YAAY,GAAG;IACnB,OAAO,EAAE,OAAO,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,KAAK,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AAuOD;;;GAGG;AACH,wBAAsB,UAAU,CAC/B,IAAI,EAAE,eAAe,EACrB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,OAAO,GAAE,aAAkB,GACzB,OAAO,CAAC,YAAY,CAAC,CAkFvB"}