@ytspar/sweetlink 1.13.0 → 1.14.0

package/dist/daemon/refs.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Ref System
+ *
+ * Uses Playwright's ariaSnapshot API to assign sequential @e refs to interactive elements.
+ * No DOM mutation — works through Shadow DOM and CSP-restricted pages.
+ *
+ * ariaSnapshot() returns YAML-like lines:
+ *   - heading "Hello" [level=1]
+ *   - button "Click me"
+ *   - textbox "Search"
+ *   - link "Home"
+ */
+type Page = import('playwright').Page;
+type Locator = import('playwright').Locator;
+export interface RefEntry {
+    ref: string;
+    role: string;
+    name: string;
+    attrs: Record<string, string>;
+}
+export interface RefMap {
+    entries: RefEntry[];
+    byRef: Map<string, RefEntry>;
+    rawSnapshot: string;
+    timestamp: number;
+}
+/**
+ * Parse ariaSnapshot YAML output into RefEntry objects.
+ *
+ * Format examples:
+ *   - heading "Dashboard" [level=1]
+ *   - button "Submit"
+ *   - textbox "Email" [disabled]
+ *   - link "Settings":
+ *       - /url: /settings
+ */
+export declare function parseAriaSnapshot(snapshot: string, options?: {
+    interactive?: boolean;
+}): RefEntry[];
+/**
+ * Build a ref map from the page's accessibility tree.
+ * Uses locator.ariaSnapshot() (Playwright 1.49+).
+ */
+export declare function buildRefMap(page: Page, options?: {
+    interactive?: boolean;
+}): Promise<RefMap>;
+/**
+ * Resolve a @ref to a Playwright Locator.
+ * Uses getByRole with name matching for robustness.
+ */
+export declare function resolveRef(page: Page, ref: string): Locator;
+/**
+ * Check if a ref is still valid (element exists in DOM).
+ * ~5ms overhead vs 30s Playwright timeout on stale refs.
+ */
+export declare function checkRefStale(page: Page, ref: string): Promise<boolean>;
+/**
+ * Format a ref map as human-readable text.
+ */
+export declare function formatRefMap(refMap: RefMap): string;
+/** Store current snapshot as baseline for future diffs. */
+export declare function setBaseline(): void;
+/** Get the current baseline ref map. */
+export declare function getBaseline(): RefMap | null;
+/** Get the current ref map. */
+export declare function getCurrentRefMap(): RefMap | null;
+/** Clear both current and baseline ref maps. */
+export declare function clearRefMaps(): void;
+export {};
+//# sourceMappingURL=refs.d.ts.map

package/dist/daemon/refs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refs.d.ts","sourceRoot":"","sources":["../../src/daemon/refs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,KAAK,IAAI,GAAG,OAAO,YAAY,EAAE,IAAI,CAAC;AACtC,KAAK,OAAO,GAAG,OAAO,YAAY,EAAE,OAAO,CAAC;AAM5C,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,MAAM;IACrB,OAAO,EAAE,QAAQ,EAAE,CAAC;IACpB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAkCD;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,OAAO,CAAA;CAAE,GAClC,QAAQ,EAAE,CA0CZ;AAMD;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,IAAI,EACV,OAAO,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,OAAO,CAAA;CAAE,GAClC,OAAO,CAAC,MAAM,CAAC,CAYjB;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAmB3D;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQ7E;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAqBnD;AAMD,2DAA2D;AAC3D,wBAAgB,WAAW,IAAI,IAAI,CAGlC;AAED,wCAAwC;AACxC,wBAAgB,WAAW,IAAI,MAAM,GAAG,IAAI,CAE3C;AAED,+BAA+B;AAC/B,wBAAgB,gBAAgB,IAAI,MAAM,GAAG,IAAI,CAEhD;AAED,gDAAgD;AAChD,wBAAgB,YAAY,IAAI,IAAI,CAGnC"}

package/dist/daemon/refs.js

@@ -0,0 +1,185 @@
+/**
+ * Ref System
+ *
+ * Uses Playwright's ariaSnapshot API to assign sequential @e refs to interactive elements.
+ * No DOM mutation — works through Shadow DOM and CSP-restricted pages.
+ *
+ * ariaSnapshot() returns YAML-like lines:
+ *   - heading "Hello" [level=1]
+ *   - button "Click me"
+ *   - textbox "Search"
+ *   - link "Home"
+ */
+// ============================================================================
+// State
+// ============================================================================
+let currentRefMap = null;
+let baselineRefMap = null;
+// Roles that are interactive and worth assigning refs to
+const INTERACTIVE_ROLES = new Set([
+    'button',
+    'link',
+    'textbox',
+    'checkbox',
+    'radio',
+    'combobox',
+    'listbox',
+    'menuitem',
+    'menuitemcheckbox',
+    'menuitemradio',
+    'option',
+    'searchbox',
+    'slider',
+    'spinbutton',
+    'switch',
+    'tab',
+    'treeitem',
+]);
+// ============================================================================
+// Parsing
+// ============================================================================
+/**
+ * Parse ariaSnapshot YAML output into RefEntry objects.
+ *
+ * Format examples:
+ *   - heading "Dashboard" [level=1]
+ *   - button "Submit"
+ *   - textbox "Email" [disabled]
+ *   - link "Settings":
+ *       - /url: /settings
+ */
+export function parseAriaSnapshot(snapshot, options) {
+    const entries = [];
+    let counter = 1;
+    for (const line of snapshot.split('\n')) {
+        // Match lines like: - role "name" [attr=value, ...]
+        const match = line.match(/^\s*-\s+(\w+)\s+"([^"]*)"(?:\s+\[([^\]]*)\])?/);
+        if (!match)
+            continue;
+        const role = match[1];
+        const name = match[2];
+        const attrStr = match[3];
+        // Filter by role if interactive-only mode
+        if (options?.interactive && !INTERACTIVE_ROLES.has(role))
+            continue;
+        // Skip elements without names (they're structural, not actionable)
+        if (!name.trim())
+            continue;
+        const attrs = {};
+        if (attrStr) {
+            // Parse attrs like "level=1, disabled, checked=true"
+            for (const part of attrStr.split(',')) {
+                const trimmed = part.trim();
+                const eqIdx = trimmed.indexOf('=');
+                if (eqIdx !== -1) {
+                    attrs[trimmed.slice(0, eqIdx)] = trimmed.slice(eqIdx + 1);
+                }
+                else {
+                    attrs[trimmed] = 'true';
+                }
+            }
+        }
+        entries.push({
+            ref: `@e${counter++}`,
+            role,
+            name,
+            attrs,
+        });
+    }
+    return entries;
+}
+// ============================================================================
+// Core Functions
+// ============================================================================
+/**
+ * Build a ref map from the page's accessibility tree.
+ * Uses locator.ariaSnapshot() (Playwright 1.49+).
+ */
+export async function buildRefMap(page, options) {
+    const snapshot = await page.locator('body').ariaSnapshot();
+    const entries = parseAriaSnapshot(snapshot, options);
+    const byRef = new Map();
+    for (const entry of entries) {
+        byRef.set(entry.ref, entry);
+    }
+    const refMap = { entries, byRef, rawSnapshot: snapshot, timestamp: Date.now() };
+    currentRefMap = refMap;
+    return refMap;
+}
+/**
+ * Resolve a @ref to a Playwright Locator.
+ * Uses getByRole with name matching for robustness.
+ */
+export function resolveRef(page, ref) {
+    if (!currentRefMap) {
+        throw new Error('No snapshot taken yet. Run `snapshot -i` first.');
+    }
+    const entry = currentRefMap.byRef.get(ref);
+    if (!entry) {
+        throw new Error(`Unknown ref ${ref}. Available refs: ${Array.from(currentRefMap.byRef.keys()).join(', ')}`);
+    }
+    // Build locator from role + name
+    const locator = page.getByRole(entry.role, {
+        name: entry.name,
+        exact: false,
+    });
+    return locator;
+}
+/**
+ * Check if a ref is still valid (element exists in DOM).
+ * ~5ms overhead vs 30s Playwright timeout on stale refs.
+ */
+export async function checkRefStale(page, ref) {
+    try {
+        const locator = resolveRef(page, ref);
+        const count = await locator.count();
+        return count === 0;
+    }
+    catch {
+        return true;
+    }
+}
+/**
+ * Format a ref map as human-readable text.
+ */
+export function formatRefMap(refMap) {
+    if (refMap.entries.length === 0) {
+        return '(no elements found)';
+    }
+    const lines = [];
+    for (const entry of refMap.entries) {
+        let line = `  ${entry.ref} [${entry.role}] "${entry.name}"`;
+        const attrParts = [];
+        for (const [key, value] of Object.entries(entry.attrs)) {
+            attrParts.push(value === 'true' ? key : `${key}=${value}`);
+        }
+        if (attrParts.length > 0) {
+            line += ` [${attrParts.join(', ')}]`;
+        }
+        lines.push(line);
+    }
+    return lines.join('\n');
+}
+// ============================================================================
+// Baseline / Diff
+// ============================================================================
+/** Store current snapshot as baseline for future diffs. */
+export function setBaseline() {
+    if (!currentRefMap)
+        throw new Error('No snapshot taken yet. Run `snapshot` first.');
+    baselineRefMap = currentRefMap;
+}
+/** Get the current baseline ref map. */
+export function getBaseline() {
+    return baselineRefMap;
+}
+/** Get the current ref map. */
+export function getCurrentRefMap() {
+    return currentRefMap;
+}
+/** Clear both current and baseline ref maps. */
+export function clearRefMaps() {
+    currentRefMap = null;
+    baselineRefMap = null;
+}
+//# sourceMappingURL=refs.js.map

package/dist/daemon/refs.js.map

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

package/dist/daemon/ringBuffer.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Ring Buffer
+ *
+ * Fixed-capacity circular buffer with O(1) push.
+ * Used for always-on console/network/dialog event capture.
+ */
+export declare class RingBuffer<T> {
+    private readonly capacity;
+    private buffer;
+    private head;
+    private count;
+    constructor(capacity?: number);
+    /** Add an item. Overwrites oldest if at capacity. */
+    push(item: T): void;
+    /** Get all items in insertion order (oldest first). */
+    toArray(): T[];
+    /** Get items matching a predicate. */
+    filter(predicate: (item: T) => boolean): T[];
+    /** Get the last N items. */
+    last(n: number): T[];
+    /** Clear all items. */
+    clear(): void;
+    /** Current number of items. */
+    get size(): number;
+}
+//# sourceMappingURL=ringBuffer.d.ts.map

package/dist/daemon/ringBuffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ringBuffer.d.ts","sourceRoot":"","sources":["../../src/daemon/ringBuffer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,qBAAa,UAAU,CAAC,CAAC;IAKX,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAJrC,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,KAAK,CAAK;gBAEW,QAAQ,GAAE,MAAe;IAItD,qDAAqD;IACrD,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI;IAMnB,uDAAuD;IACvD,OAAO,IAAI,CAAC,EAAE;IAUd,sCAAsC;IACtC,MAAM,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,GAAG,CAAC,EAAE;IAI5C,4BAA4B;IAC5B,IAAI,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,EAAE;IAKpB,uBAAuB;IACvB,KAAK,IAAI,IAAI;IAMb,+BAA+B;IAC/B,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}

package/dist/daemon/ringBuffer.js

@@ -0,0 +1,54 @@
+/**
+ * Ring Buffer
+ *
+ * Fixed-capacity circular buffer with O(1) push.
+ * Used for always-on console/network/dialog event capture.
+ */
+export class RingBuffer {
+    capacity;
+    buffer;
+    head = 0;
+    count = 0;
+    constructor(capacity = 50_000) {
+        this.capacity = capacity;
+        this.buffer = new Array(capacity);
+    }
+    /** Add an item. Overwrites oldest if at capacity. */
+    push(item) {
+        this.buffer[this.head] = item;
+        this.head = (this.head + 1) % this.capacity;
+        if (this.count < this.capacity)
+            this.count++;
+    }
+    /** Get all items in insertion order (oldest first). */
+    toArray() {
+        if (this.count === 0)
+            return [];
+        const result = [];
+        const start = this.count < this.capacity ? 0 : this.head;
+        for (let i = 0; i < this.count; i++) {
+            result.push(this.buffer[(start + i) % this.capacity]);
+        }
+        return result;
+    }
+    /** Get items matching a predicate. */
+    filter(predicate) {
+        return this.toArray().filter(predicate);
+    }
+    /** Get the last N items. */
+    last(n) {
+        const all = this.toArray();
+        return all.slice(Math.max(0, all.length - n));
+    }
+    /** Clear all items. */
+    clear() {
+        this.buffer = new Array(this.capacity);
+        this.head = 0;
+        this.count = 0;
+    }
+    /** Current number of items. */
+    get size() {
+        return this.count;
+    }
+}
+//# sourceMappingURL=ringBuffer.js.map

package/dist/daemon/ringBuffer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ringBuffer.js","sourceRoot":"","sources":["../../src/daemon/ringBuffer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,OAAO,UAAU;IAKQ;IAJrB,MAAM,CAAoB;IAC1B,IAAI,GAAG,CAAC,CAAC;IACT,KAAK,GAAG,CAAC,CAAC;IAElB,YAA6B,WAAmB,MAAM;QAAzB,aAAQ,GAAR,QAAQ,CAAiB;QACpD,IAAI,CAAC,MAAM,GAAG,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC;IACpC,CAAC;IAED,qDAAqD;IACrD,IAAI,CAAC,IAAO;QACV,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC5C,IAAI,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,QAAQ;YAAE,IAAI,CAAC,KAAK,EAAE,CAAC;IAC/C,CAAC;IAED,uDAAuD;IACvD,OAAO;QACL,IAAI,IAAI,CAAC,KAAK,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAChC,MAAM,MAAM,GAAQ,EAAE,CAAC;QACvB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QACzD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;YACpC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAE,CAAC,CAAC;QACzD,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,sCAAsC;IACtC,MAAM,CAAC,SAA+B;QACpC,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAC1C,CAAC;IAED,4BAA4B;IAC5B,IAAI,CAAC,CAAS;QACZ,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QAC3B,OAAO,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;IAChD,CAAC;IAED,uBAAuB;IACvB,KAAK;QACH,IAAI,CAAC,MAAM,GAAG,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACvC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;QACd,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;IACjB,CAAC;IAED,+BAA+B;IAC/B,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;CACF"}

package/dist/daemon/server.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Daemon HTTP Server
+ *
+ * Localhost-only HTTP server with bearer token auth.
+ * Routes POST requests to /api/{action} and dispatches to handlers.
+ * Manages idle timer for auto-shutdown.
+ */
+export interface StartServerOptions {
+    port: number;
+    token: string;
+    url: string;
+    onShutdown: () => void;
+}
+/**
+ * Start the daemon HTTP server.
+ * Binds to 127.0.0.1 (localhost only) on the specified port.
+ */
+export declare function startServer(options: StartServerOptions): Promise<void>;
+/**
+ * Shut down the daemon: close browser, close HTTP server, call shutdown callback.
+ */
+export declare function shutdown(): Promise<void>;
+//# sourceMappingURL=server.d.ts.map

package/dist/daemon/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/daemon/server.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA2hBH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,IAAI,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqEtE;AAED;;GAEG;AACH,wBAAsB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAgB9C"}