@upbeat-works/fisgon 0.1.0

package/dist/cli/task-runner.js

@@ -0,0 +1,318 @@
+/**
+ * Substitute {{paramName}} placeholders in all string values of an object.
+ */
+function substituteParams(obj, vars) {
+    const result = {};
+    for (const [key, value] of Object.entries(obj)) {
+        if (typeof value === 'string') {
+            let resolved = value;
+            for (const [varName, varValue] of Object.entries(vars)) {
+                resolved = resolved.replaceAll(`{{${varName}}}`, varValue);
+            }
+            result[key] = resolved;
+        }
+        else {
+            result[key] = value;
+        }
+    }
+    return result;
+}
+/**
+ * Unwrap common RPC response shapes to get at the raw data.
+ * e.g. { tick: { events: [...] } } → { events: [...] }
+ */
+function unwrapResult(result) {
+    if (result == null || typeof result !== 'object')
+        return result;
+    const obj = result;
+    // { tick: { ... } } from waitForNextTick / navigate RPCs
+    if ('tick' in obj && typeof obj.tick === 'object')
+        return obj.tick;
+    return result;
+}
+/**
+ * Extract events array from various result shapes.
+ */
+function extractEvents(result) {
+    if (result == null || typeof result !== 'object')
+        return [];
+    // Direct tick object with events array
+    if ('events' in result) {
+        return result.events ?? [];
+    }
+    // Array of events directly
+    if (Array.isArray(result))
+        return result;
+    return [];
+}
+/**
+ * Evaluate a simple extract expression against a tool result.
+ *
+ * Supported formats:
+ * - `events[source=X].data.field` — find event with matching source, traverse path
+ * - `events[source=X].data.text | match(/regex/)` — find event, extract regex match
+ * - `data.field.subfield` — simple dot-path traversal on the result
+ */
+function evaluateExtract(expression, result) {
+    const parts = expression.split('|').map((p) => p.trim());
+    const path = parts[0];
+    const matchExpr = parts[1];
+    let value = result;
+    // Unwrap RPC response wrappers: { tick: { events: [...] } } or { events: [...] }
+    const unwrapped = unwrapResult(result);
+    // Handle events[source=X] prefix
+    const eventsMatch = path.match(/^events\[source=(\w+)\]\.(.+)$/);
+    if (eventsMatch) {
+        const source = eventsMatch[1];
+        const restPath = eventsMatch[2];
+        // Collect events from whatever shape we got
+        const events = extractEvents(unwrapped);
+        const event = events.find((e) => e.source === source);
+        if (!event)
+            return null;
+        value = traversePath(event, restPath);
+    }
+    else {
+        value = traversePath(unwrapped, path);
+    }
+    if (value == null)
+        return null;
+    // Apply match() regex if present
+    if (matchExpr) {
+        const regexMatch = matchExpr.match(/^match\(\/(.+)\/\)$/);
+        if (regexMatch) {
+            const regex = new RegExp(regexMatch[1]);
+            const str = String(value);
+            const m = str.match(regex);
+            return m ? (m[1] ?? m[0]) : null;
+        }
+    }
+    return String(value);
+}
+function traversePath(obj, path) {
+    const segments = path.split('.');
+    let current = obj;
+    for (const seg of segments) {
+        if (current == null || typeof current !== 'object')
+            return null;
+        current = current[seg];
+    }
+    return current;
+}
+/**
+ * Map a task step's tool name to the corresponding agent RPC call.
+ * For interact, wait for tick but don't fail if it times out (e.g. typing
+ * into an input won't generate probe events).
+ */
+async function executeStep(conn, sessionId, tool, args, hasExtract, page) {
+    switch (tool) {
+        case 'navigate': {
+            if (page) {
+                await page.goto(args.url, { waitUntil: 'networkidle' });
+                // Wait for probe events from the navigation
+                try {
+                    return await conn.call('waitForNextTick', [sessionId, 5000], { timeout: 15000 });
+                }
+                catch {
+                    if (hasExtract)
+                        throw new Error('Tick timed out (needed for extract)');
+                    return null;
+                }
+            }
+            return conn.call('navigate', [sessionId, args.url], { timeout: 30000 });
+        }
+        case 'get_actions':
+            return conn.call('getActions', [sessionId], { timeout: 30000 });
+        case 'open_action':
+            return conn.call('openAction', [sessionId, args.actionId], { timeout: 30000 });
+        case 'interact': {
+            if (page) {
+                const action = args.action;
+                const selector = args.selector;
+                switch (action) {
+                    case 'type':
+                        await page.fill(selector, args.value);
+                        break;
+                    case 'click':
+                        await page.click(selector);
+                        break;
+                    case 'select':
+                        await page.selectOption(selector, args.value);
+                        break;
+                }
+            }
+            else {
+                await conn.call('interact', [sessionId, {
+                        action: args.action,
+                        selector: args.selector,
+                        ...(args.value != null ? { value: args.value } : {}),
+                    }], { timeout: 30000 });
+            }
+            // Wait for tick but tolerate timeout — some interactions (typing)
+            // don't generate probe events. Only fail if we need extract data.
+            try {
+                return await conn.call('waitForNextTick', [sessionId, 5000], { timeout: 15000 });
+            }
+            catch {
+                if (hasExtract)
+                    throw new Error('Tick timed out (needed for extract)');
+                return null;
+            }
+        }
+        case 'wait_for_tick':
+            return conn.call('waitForNextTick', [sessionId, args.timeout ?? 10000], { timeout: 30000 });
+        case 'get_events':
+            return conn.call('getEvents', [sessionId], { timeout: 30000 });
+        default:
+            throw new Error(`Unknown tool: ${tool}`);
+    }
+}
+/**
+ * Validate the task's success conditions against current browser state.
+ */
+async function validateTask(conn, sessionId, validate) {
+    if (!validate)
+        return { passed: true };
+    const { events } = await conn.call('getEvents', [sessionId], { timeout: 10000 });
+    // Collect all nav URLs (some intermediate ones matter, not just the last)
+    const navUrls = events
+        .filter((e) => e.source === 'nav')
+        .map((e) => String(e.data.url ?? ''))
+        .filter((url) => url && url !== 'blank');
+    const currentUrl = navUrls[navUrls.length - 1] ?? '';
+    if (validate.url_contains) {
+        // Check if any recent nav URL contains the expected string
+        const found = navUrls.some((url) => url.includes(validate.url_contains));
+        if (!found) {
+            return { passed: false, reason: `No navigation URL contains "${validate.url_contains}" (last: "${currentUrl}")` };
+        }
+    }
+    if (validate.url_matches) {
+        const regex = new RegExp(validate.url_matches);
+        const found = navUrls.some((url) => regex.test(url));
+        if (!found) {
+            return { passed: false, reason: `No navigation URL matches /${validate.url_matches}/ (last: "${currentUrl}")` };
+        }
+    }
+    if (validate.event_exists) {
+        const found = events.some((e) => e.source === validate.event_exists.source && e.type === validate.event_exists.type);
+        if (!found) {
+            return { passed: false, reason: `No event with source="${validate.event_exists.source}" type="${validate.event_exists.type}"` };
+        }
+    }
+    return { passed: true };
+}
+/**
+ * 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 async function replayTask(conn, sessionId, task, params, options = {}) {
+    // Merge task defaults with provided params
+    const vars = { ...task.params, ...params };
+    for (let i = 0; i < task.steps.length; i++) {
+        const step = task.steps[i];
+        const resolvedArgs = step.args ? substituteParams(step.args, vars) : {};
+        if (options.verbose) {
+            const argStr = Object.entries(resolvedArgs)
+                .map(([k, v]) => `${k}=${typeof v === 'string' ? v : JSON.stringify(v)}`)
+                .join(' ');
+            console.log(`  [step ${i + 1}/${task.steps.length}] ${step.tool}(${argStr})`);
+        }
+        let result;
+        try {
+            result = await executeStep(conn, sessionId, step.tool, resolvedArgs, !!step.extract, options.page);
+        }
+        catch (err) {
+            if (options.fallback) {
+                if (options.verbose) {
+                    console.log(`  [step ${i + 1}] failed, falling back to LLM...`);
+                }
+                // Describe the intent of this step for the LLM
+                const stepDescription = describeStep(step, resolvedArgs);
+                try {
+                    await conn.call('performTask', [sessionId, stepDescription], { timeout: 300000 });
+                    continue;
+                }
+                catch (fallbackErr) {
+                    return {
+                        success: false,
+                        failedStep: i + 1,
+                        error: `Step ${i + 1} failed (LLM fallback also failed): ${fallbackErr}`,
+                    };
+                }
+            }
+            return {
+                success: false,
+                failedStep: i + 1,
+                error: `Step ${i + 1} (${step.tool}) failed: ${err}`,
+            };
+        }
+        // Process extract expressions
+        if (step.extract) {
+            for (const [varName, expression] of Object.entries(step.extract)) {
+                const extracted = evaluateExtract(expression, result);
+                if (extracted) {
+                    vars[varName] = extracted;
+                    if (options.verbose) {
+                        console.log(`  [extract] ${varName} = ${extracted.length > 80 ? extracted.slice(0, 77) + '...' : extracted}`);
+                    }
+                }
+                else if (options.verbose) {
+                    console.log(`  [extract] ${varName} = (not found)`);
+                }
+            }
+        }
+    }
+    // Validate
+    const validation = await validateTask(conn, sessionId, task.validate);
+    if (!validation.passed) {
+        if (options.fallback) {
+            if (options.verbose) {
+                console.log(`  [validate] failed: ${validation.reason}`);
+                console.log(`  [validate] falling back to LLM for full task...`);
+            }
+            try {
+                await conn.call('performTask', [sessionId, task.description], { timeout: 300000 });
+                const revalidation = await validateTask(conn, sessionId, task.validate);
+                return {
+                    success: revalidation.passed,
+                    error: revalidation.passed ? undefined : `Validation failed after LLM fallback: ${revalidation.reason}`,
+                };
+            }
+            catch (err) {
+                return { success: false, error: `LLM fallback failed: ${err}` };
+            }
+        }
+        return { success: false, error: `Validation failed: ${validation.reason}` };
+    }
+    return { success: true };
+}
+/**
+ * Generate a natural-language description of a step for LLM fallback.
+ */
+function describeStep(step, resolvedArgs) {
+    switch (step.tool) {
+        case 'navigate':
+            return `Navigate the browser to ${resolvedArgs.url}`;
+        case 'interact':
+            if (resolvedArgs.action === 'click') {
+                return `Click the element matching selector "${resolvedArgs.selector}" on the current page`;
+            }
+            if (resolvedArgs.action === 'type') {
+                return `Type "${resolvedArgs.value}" into the element matching selector "${resolvedArgs.selector}"`;
+            }
+            if (resolvedArgs.action === 'select') {
+                return `Select the value "${resolvedArgs.value}" in the dropdown matching selector "${resolvedArgs.selector}"`;
+            }
+            return `Interact with element "${resolvedArgs.selector}" (${resolvedArgs.action})`;
+        case 'wait_for_tick':
+            return 'Wait for the page to settle and observe any new events';
+        case 'get_actions':
+            return 'List available actions on the current page';
+        case 'get_events':
+            return 'Review all events captured so far';
+        default:
+            return `Execute ${step.tool} with args: ${JSON.stringify(resolvedArgs)}`;
+    }
+}
+//# sourceMappingURL=task-runner.js.map

package/dist/cli/task-runner.js.map

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

package/dist/core/task-file.d.ts

@@ -0,0 +1,32 @@
+export type TaskStep = {
+    tool: string;
+    args?: Record<string, string>;
+    extract?: Record<string, string>;
+};
+export type TaskValidation = {
+    url_contains?: string;
+    url_matches?: string;
+    event_exists?: {
+        source: string;
+        type: string;
+    };
+};
+export type TaskFile = {
+    name: string;
+    description: string;
+    params?: Record<string, string>;
+    steps: TaskStep[];
+    validate?: TaskValidation;
+};
+export type CaseFile = {
+    name: string;
+    description: string;
+    tasks: string[];
+};
+export declare function readTaskFile(projectDir: string, name: string): TaskFile | null;
+export declare function writeTaskFile(projectDir: string, task: TaskFile): void;
+export declare function readCaseFile(projectDir: string, name: string): CaseFile | null;
+export declare function writeCaseFile(projectDir: string, caseFile: CaseFile): void;
+export declare function listTasks(projectDir: string): string[];
+export declare function listCases(projectDir: string): string[];
+//# sourceMappingURL=task-file.d.ts.map

package/dist/core/task-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-file.d.ts","sourceRoot":"","sources":["../../src/core/task-file.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,QAAQ,GAAG;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAChC,CAAA;AAED,MAAM,MAAM,cAAc,GAAG;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,YAAY,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;CAC/C,CAAA;AAED,MAAM,MAAM,QAAQ,GAAG;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/B,KAAK,EAAE,QAAQ,EAAE,CAAA;IACjB,QAAQ,CAAC,EAAE,cAAc,CAAA;CACzB,CAAA;AAED,MAAM,MAAM,QAAQ,GAAG;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,MAAM,EAAE,CAAA;CACf,CAAA;AAWD,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAI9E;AAED,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,IAAI,CAKtE;AAED,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAI9E;AAED,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAK1E;AAED,wBAAgB,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAMtD;AAED,wBAAgB,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAMtD"}

package/dist/core/task-file.js

@@ -0,0 +1,51 @@
+import { readFileSync, writeFileSync, mkdirSync, existsSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { parse, stringify } from 'yaml';
+const TASKS_DIR = '.fisgon/tasks';
+const CASES_DIR = '.fisgon/cases';
+function ensureDir(dir) {
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+}
+export function readTaskFile(projectDir, name) {
+    const filePath = join(projectDir, TASKS_DIR, `${name}.yaml`);
+    if (!existsSync(filePath))
+        return null;
+    return parse(readFileSync(filePath, 'utf-8'));
+}
+export function writeTaskFile(projectDir, task) {
+    const dir = join(projectDir, TASKS_DIR);
+    ensureDir(dir);
+    const filePath = join(dir, `${task.name}.yaml`);
+    writeFileSync(filePath, stringify(task, { lineWidth: 120 }));
+}
+export function readCaseFile(projectDir, name) {
+    const filePath = join(projectDir, CASES_DIR, `${name}.yaml`);
+    if (!existsSync(filePath))
+        return null;
+    return parse(readFileSync(filePath, 'utf-8'));
+}
+export function writeCaseFile(projectDir, caseFile) {
+    const dir = join(projectDir, CASES_DIR);
+    ensureDir(dir);
+    const filePath = join(dir, `${caseFile.name}.yaml`);
+    writeFileSync(filePath, stringify(caseFile, { lineWidth: 120 }));
+}
+export function listTasks(projectDir) {
+    const dir = join(projectDir, TASKS_DIR);
+    if (!existsSync(dir))
+        return [];
+    return readdirSync(dir)
+        .filter((f) => f.endsWith('.yaml'))
+        .map((f) => f.replace(/\.yaml$/, ''));
+}
+export function listCases(projectDir) {
+    const dir = join(projectDir, CASES_DIR);
+    if (!existsSync(dir))
+        return [];
+    return readdirSync(dir)
+        .filter((f) => f.endsWith('.yaml'))
+        .map((f) => f.replace(/\.yaml$/, ''));
+}
+//# sourceMappingURL=task-file.js.map

package/dist/core/task-file.js.map

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

package/dist/core/tick-detector.d.ts

@@ -0,0 +1,24 @@
+import { type ProbeEvent, type Tick } from './types.js';
+export type TickDetectorOptions = {
+    silenceMs?: number;
+    maxMs?: number;
+    onTick: (tick: Tick) => void;
+};
+export declare class TickDetector {
+    private silenceMs;
+    private maxMs;
+    private onTick;
+    private currentEvents;
+    private silenceTimer;
+    private maxTimer;
+    private tickCount;
+    private sessionId;
+    constructor(options: TickDetectorOptions);
+    setSession(sessionId: string | null): void;
+    ingest(event: ProbeEvent): void;
+    private resetSilenceTimer;
+    private completeTick;
+    get pending(): boolean;
+    reset(): void;
+}
+//# sourceMappingURL=tick-detector.d.ts.map

package/dist/core/tick-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tick-detector.d.ts","sourceRoot":"","sources":["../../src/core/tick-detector.ts"],"names":[],"mappings":"AAAA,OAAQ,EAAE,KAAK,UAAU,EAAE,KAAK,IAAI,EAAE,MAAM,YAAY,CAAA;AAExD,MAAM,MAAM,mBAAmB,GAAG;IAChC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAA;CAC7B,CAAA;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,MAAM,CAAsB;IAEpC,OAAO,CAAC,aAAa,CAAmB;IACxC,OAAO,CAAC,YAAY,CAA6C;IACjE,OAAO,CAAC,QAAQ,CAA6C;IAC7D,OAAO,CAAC,SAAS,CAAI;IACrB,OAAO,CAAC,SAAS,CAAsB;gBAE3B,OAAO,EAAE,mBAAmB;IAMxC,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAKnC,MAAM,CAAC,KAAK,EAAE,UAAU;IAcxB,OAAO,CAAC,iBAAiB;IAOzB,OAAO,CAAC,YAAY;IAqBpB,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,KAAK;CAQN"}

package/dist/core/tick-detector.js

@@ -0,0 +1,71 @@
+export class TickDetector {
+    silenceMs;
+    maxMs;
+    onTick;
+    currentEvents = [];
+    silenceTimer = null;
+    maxTimer = null;
+    tickCount = 0;
+    sessionId = null;
+    constructor(options) {
+        this.silenceMs = options.silenceMs ?? 500;
+        this.maxMs = options.maxMs ?? 30000;
+        this.onTick = options.onTick;
+    }
+    setSession(sessionId) {
+        this.sessionId = sessionId;
+        this.reset();
+    }
+    ingest(event) {
+        this.currentEvents.push(event);
+        // Start max timer on first event
+        if (this.currentEvents.length === 1) {
+            this.maxTimer = setTimeout(() => {
+                this.completeTick();
+            }, this.maxMs);
+        }
+        // Reset silence timer on every event
+        this.resetSilenceTimer();
+    }
+    resetSilenceTimer() {
+        if (this.silenceTimer)
+            clearTimeout(this.silenceTimer);
+        this.silenceTimer = setTimeout(() => {
+            this.completeTick();
+        }, this.silenceMs);
+    }
+    completeTick() {
+        if (this.silenceTimer)
+            clearTimeout(this.silenceTimer);
+        if (this.maxTimer)
+            clearTimeout(this.maxTimer);
+        this.silenceTimer = null;
+        this.maxTimer = null;
+        const events = this.currentEvents;
+        if (events.length === 0)
+            return;
+        const tick = {
+            id: this.tickCount++,
+            sessionId: this.sessionId ?? '',
+            startedAt: events[0].timestamp,
+            duration: events[events.length - 1].timestamp - events[0].timestamp,
+            events,
+        };
+        this.currentEvents = [];
+        this.onTick(tick);
+    }
+    get pending() {
+        return this.currentEvents.length > 0;
+    }
+    reset() {
+        if (this.silenceTimer)
+            clearTimeout(this.silenceTimer);
+        if (this.maxTimer)
+            clearTimeout(this.maxTimer);
+        this.silenceTimer = null;
+        this.maxTimer = null;
+        this.currentEvents = [];
+        this.tickCount = 0;
+    }
+}
+//# sourceMappingURL=tick-detector.js.map

package/dist/core/tick-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tick-detector.js","sourceRoot":"","sources":["../../src/core/tick-detector.ts"],"names":[],"mappings":"AAQA,MAAM,OAAO,YAAY;IACf,SAAS,CAAQ;IACjB,KAAK,CAAQ;IACb,MAAM,CAAsB;IAE5B,aAAa,GAAiB,EAAE,CAAA;IAChC,YAAY,GAAyC,IAAI,CAAA;IACzD,QAAQ,GAAyC,IAAI,CAAA;IACrD,SAAS,GAAG,CAAC,CAAA;IACb,SAAS,GAAkB,IAAI,CAAA;IAEvC,YAAY,OAA4B;QACtC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,GAAG,CAAA;QACzC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,KAAK,CAAA;QACnC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAA;IAC9B,CAAC;IAED,UAAU,CAAC,SAAwB;QACjC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;QAC1B,IAAI,CAAC,KAAK,EAAE,CAAA;IACd,CAAC;IAED,MAAM,CAAC,KAAiB;QACtB,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAE9B,iCAAiC;QACjC,IAAI,IAAI,CAAC,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACpC,IAAI,CAAC,QAAQ,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC9B,IAAI,CAAC,YAAY,EAAE,CAAA;YACrB,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAA;QAChB,CAAC;QAED,qCAAqC;QACrC,IAAI,CAAC,iBAAiB,EAAE,CAAA;IAC1B,CAAC;IAEO,iBAAiB;QACvB,IAAI,IAAI,CAAC,YAAY;YAAE,YAAY,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;QACtD,IAAI,CAAC,YAAY,GAAG,UAAU,CAAC,GAAG,EAAE;YAClC,IAAI,CAAC,YAAY,EAAE,CAAA;QACrB,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,CAAA;IACpB,CAAC;IAEO,YAAY;QAClB,IAAI,IAAI,CAAC,YAAY;YAAE,YAAY,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;QACtD,IAAI,IAAI,CAAC,QAAQ;YAAE,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QAC9C,IAAI,CAAC,YAAY,GAAG,IAAI,CAAA;QACxB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAA;QAEpB,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAA;QACjC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAM;QAE/B,MAAM,IAAI,GAAS;YACjB,EAAE,EAAE,IAAI,CAAC,SAAS,EAAE;YACpB,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,EAAE;YAC/B,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS;YAC9B,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS;YACnE,MAAM;SACP,CAAA;QAED,IAAI,CAAC,aAAa,GAAG,EAAE,CAAA;QACvB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IACnB,CAAC;IAED,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,CAAA;IACtC,CAAC;IAED,KAAK;QACH,IAAI,IAAI,CAAC,YAAY;YAAE,YAAY,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;QACtD,IAAI,IAAI,CAAC,QAAQ;YAAE,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QAC9C,IAAI,CAAC,YAAY,GAAG,IAAI,CAAA;QACxB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAA;QACpB,IAAI,CAAC,aAAa,GAAG,EAAE,CAAA;QACvB,IAAI,CAAC,SAAS,GAAG,CAAC,CAAA;IACpB,CAAC;CACF"}

package/dist/core/types.d.ts

@@ -0,0 +1,74 @@
+export type ProbeEvent = {
+    sessionId: string;
+    source: string;
+    type: string;
+    timestamp: number;
+    data: unknown;
+};
+export type Tick = {
+    id: number;
+    sessionId: string;
+    startedAt: number;
+    duration: number;
+    events: ProbeEvent[];
+};
+export type Action = {
+    id: string;
+    elementType: string;
+    textContent: string;
+};
+export type InteractCommand = {
+    action: 'type';
+    selector: string;
+    value: string;
+} | {
+    action: 'click';
+    selector: string;
+} | {
+    action: 'select';
+    selector: string;
+    value: string;
+};
+export type ScopedProbe = {
+    active: boolean;
+    sessionId: string | null;
+    emit(event: Omit<ProbeEvent, 'sessionId'>): void;
+    fromSQL(query: string, params?: unknown[]): void;
+};
+export type Probe = {
+    active: boolean;
+    fromRequest(request: Request | {
+        headers: {
+            cookie?: string;
+            get?(name: string): string | null;
+        };
+    }): ScopedProbe;
+    disconnect(): void;
+};
+export type FetchProbeConfig = {
+    match: string[];
+};
+export type ProbesConfig = {
+    fetch?: FetchProbeConfig;
+    navigation?: boolean;
+};
+export type IdentityConfig = Record<string, {
+    email: string;
+    password: string;
+}>;
+export type TickConfig = {
+    silenceMs?: number;
+    maxMs?: number;
+};
+export type BrowserMode = 'local' | 'remote';
+export type FisgonConfig = {
+    url: string;
+    agent?: string;
+    identity?: IdentityConfig;
+    loginUrl?: string;
+    probes?: ProbesConfig;
+    tick?: TickConfig;
+    port?: number;
+    browserMode?: BrowserMode;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/core/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,UAAU,GAAG;IACvB,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,OAAO,CAAA;CACd,CAAA;AAKD,MAAM,MAAM,IAAI,GAAG;IACjB,EAAE,EAAE,MAAM,CAAA;IACV,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,UAAU,EAAE,CAAA;CACrB,CAAA;AAID,MAAM,MAAM,MAAM,GAAG;IACnB,EAAE,EAAE,MAAM,CAAA;IACV,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,MAAM,CAAA;CACpB,CAAA;AAID,MAAM,MAAM,eAAe,GACvB;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACnD;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAIzD,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,EAAE,OAAO,CAAA;IACf,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,GAAG,IAAI,CAAA;IAChD,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;CACjD,CAAA;AAED,MAAM,MAAM,KAAK,GAAG;IAClB,MAAM,EAAE,OAAO,CAAA;IACf,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG;QAAE,OAAO,EAAE;YAAE,MAAM,CAAC,EAAE,MAAM,CAAC;YAAC,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;SAAE,CAAA;KAAE,GAAG,WAAW,CAAA;IAChH,UAAU,IAAI,IAAI,CAAA;CACnB,CAAA;AAID,MAAM,MAAM,gBAAgB,GAAG;IAC7B,KAAK,EAAE,MAAM,EAAE,CAAA;CAChB,CAAA;AAED,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,CAAC,EAAE,gBAAgB,CAAA;IACxB,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAAA;AAEhF,MAAM,MAAM,UAAU,GAAG;IACvB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,CAAA;AAED,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,QAAQ,CAAA;AAE5C,MAAM,MAAM,YAAY,GAAG;IACzB,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,cAAc,CAAA;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,YAAY,CAAA;IACrB,IAAI,CAAC,EAAE,UAAU,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,WAAW,CAAA;CAC1B,CAAA"}

package/dist/core/types.js

@@ -0,0 +1,4 @@
+// ── ProbeEvent ──────────────────────────────────────────────────
+// The universal unit of information. Every producer emits these.
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,iEAAiE"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+import { type FisgonConfig } from './core/types.js';
+export type { ProbeEvent, Tick, Action, InteractCommand, ScopedProbe, Probe, FisgonConfig, FetchProbeConfig, ProbesConfig, IdentityConfig, TickConfig, BrowserMode, } from './core/types.js';
+export declare function defineConfig(config: FisgonConfig): FisgonConfig;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAEnD,YAAY,EACX,UAAU,EACV,IAAI,EACJ,MAAM,EACN,eAAe,EACf,WAAW,EACX,KAAK,EACL,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,UAAU,EACV,WAAW,GACX,MAAM,iBAAiB,CAAA;AAExB,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,CAE/D"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export function defineConfig(config) {
+    return config;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAiBA,MAAM,UAAU,YAAY,CAAC,MAAoB;IAChD,OAAO,MAAM,CAAA;AACd,CAAC"}

package/dist/probes/action-scanner.d.ts

@@ -0,0 +1,2 @@
+export declare function createActionScannerScript(): string;
+//# sourceMappingURL=action-scanner.d.ts.map

package/dist/probes/action-scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-scanner.d.ts","sourceRoot":"","sources":["../../src/probes/action-scanner.ts"],"names":[],"mappings":"AAOA,wBAAgB,yBAAyB,IAAI,MAAM,CAElD"}