rdesktop-dev 0.1.2

Agent-first development server for rdesktop - browser mode for AI agent workflows
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126

// rdesktop bridge script
// This script is injected into the browser during development mode.
// It provides IPC communication and state reporting to the dev server.

(function() {
    'use strict';

    const RDESKTOP_BASE = '/__rdesktop__';

    // IPC bridge: allows frontend to call Rust backend commands
    window.__RDESKTOP_INVOKE__ = async function(cmd, payload) {
        const id = Math.random().toString(36).slice(2);
        const response = await fetch(`${RDESKTOP_BASE}/agent/ipc`, {
            method: 'POST',
            headers: { 'Content-Type': 'application/json' },
            body: JSON.stringify({ id, cmd, payload }),
        });
        return response.json();
    };

    // State reporter: sends app state to the dev server
    window.__RDESKTOP_SET_STATE__ = async function(state) {
        await fetch(`${RDESKTOP_BASE}/state`, {
            method: 'POST',
            headers: { 'Content-Type': 'application/json' },
            body: JSON.stringify(state),
        });
    };

    // DOM reporter: sends DOM snapshot to the dev server
    let domReportTimer = null;
    function reportDom() {
        const html = document.documentElement.outerHTML;
        fetch(`${RDESKTOP_BASE}/dom`, {
            method: 'POST',
            headers: { 'Content-Type': 'application/json' },
            body: JSON.stringify({ html }),
        }).catch(() => {}); // silent fail
    }

    // Report DOM on changes (debounced)
    let domReportTimeout = null;
    const observer = new MutationObserver(() => {
        clearTimeout(domReportTimeout);
        domReportTimeout = setTimeout(reportDom, 500);
    });

    // Start observing once DOM is ready
    if (document.readyState === 'loading') {
        document.addEventListener('DOMContentLoaded', () => {
            observer.observe(document.body, { childList: true, subtree: true, attributes: true });
            reportDom(); // initial report
        });
    } else {
        observer.observe(document.body, { childList: true, subtree: true, attributes: true });
        reportDom(); // initial report
    }

    // Action executor: polls for pending actions from the agent
    let pendingActions = [];
    async function pollActions() {
        try {
            const resp = await fetch(`${RDESKTOP_BASE}/agent/action/pending`);
            if (resp.ok) {
                const actions = await resp.json();
                for (const action of actions) {
                    executeAction(action);
                }
            }
        } catch (e) {
            // silent fail
        }
    }

    function executeAction(action) {
        const el = document.querySelector(action.selector);
        if (!el) {
            console.warn('[rdesktop] Element not found:', action.selector);
            return;
        }

        switch (action.action) {
            case 'click':
                el.click();
                break;
            case 'double_click':
                el.dispatchEvent(new MouseEvent('dblclick', { bubbles: true }));
                break;
            case 'right_click':
                el.dispatchEvent(new MouseEvent('contextmenu', { bubbles: true }));
                break;
            case 'type':
                el.focus();
                el.value = (el.value || '') + (action.value || '');
                el.dispatchEvent(new Event('input', { bubbles: true }));
                break;
            case 'fill':
                el.focus();
                el.value = action.value || '';
                el.dispatchEvent(new Event('input', { bubbles: true }));
                break;
            case 'clear':
                el.value = '';
                el.dispatchEvent(new Event('input', { bubbles: true }));
                break;
            case 'hover':
                el.dispatchEvent(new MouseEvent('mouseenter', { bubbles: true }));
                break;
            case 'focus':
                el.focus();
                break;
            default:
                console.warn('[rdesktop] Unknown action:', action.action);
        }
    }

    // DevTools overlay (optional)
    if (new URLSearchParams(window.location.search).has('__rdesktop_devtools')) {
        const badge = document.createElement('div');
        badge.style.cssText = 'position:fixed;bottom:8px;right:8px;background:#667eea;color:white;padding:4px 8px;border-radius:4px;font-size:11px;z-index:99999;font-family:monospace;opacity:0.7;';
        badge.textContent = 'rdesktop dev';
        document.body.appendChild(badge);
    }

    console.log('[rdesktop] Bridge script loaded');
})();