lightcone-session

# Lightcone Session Control Three tools for manual step-by-step control of a cloud computer. Use when you need precise multi-step interaction with a website or desktop application. For simple "go do this" tasks, prefer **lightcone-browse** (the `/lightcone-browse` command) instead. ## Tools | Tool | Purpose | |------|---------| | `lightcone_session_create` | Create a cloud computer (browser or desktop) | | `lightcone_session_action` | Send actions (click, type, scroll, screenshot, etc.) | | `lightcone_session_close` | Shut down the computer | ## Workflow Pattern ``` 1. lightcone_session_create → get session ID + initial screenshot 2. lightcone_session_action → navigate, click, type, screenshot (repeat) 3. lightcone_session_close → shut down ``` ## lightcone_session_create | Parameter | Required | Description | |-----------|----------|-------------| | `url` | No | URL to navigate to immediately | | `kind` | No | `"browser"` (default) or `"desktop"` | Returns: session ID (e.g., `lc-a1b2c3d4`) + screenshot of initial state. ## lightcone_session_action | Parameter | Required | Description | |-----------|----------|-------------| | `sessionId` | Yes | Session ID from create | | `action` | Yes | One of the actions below | | `url` | For navigate | Target URL | | `x`, `y` | For click/scroll | Pixel coordinates | | `text` | For type | Text to enter | | `keys` | For hotkey | Comma-separated keys, e.g. `"Control,c"` | | `dx`, `dy` | For scroll | Scroll deltas | | `seconds` | For wait | Duration in seconds | | `command` | For debug | Shell command to run | ### Actions | Action | Returns | Use for | |--------|---------|---------| | `screenshot` | Screenshot | See current state | | `navigate` | Screenshot | Go to a URL | | `click` | Screenshot | Click at (x, y) | | `doubleClick` | Screenshot | Double-click at (x, y) | | `rightClick` | Screenshot | Right-click for context menu | | `type` | Screenshot | Enter text at cursor | | `hotkey` | Screenshot | Keyboard shortcut (e.g., Enter, Tab, Control+a) | | `scroll` | Screenshot | Scroll at position | | `html` | Page HTML | Extract page source | | `wait` | Screenshot | Pause before next action | | `debug` | Command output | Run shell command in the computer | ## Example: Login and extract data ``` Step 1: Create a cloud computer at the login page lightcone_session_create { url: "https://app.example.com/login" } Step 2: Type username (click the email field first) lightcone_session_action { sessionId: "lc-...", action: "click", x: 640, y: 300 } lightcone_session_action { sessionId: "lc-...", action: "type", text: "user@example.com" } Step 3: Type password lightcone_session_action { sessionId: "lc-...", action: "hotkey", keys: "Tab" } lightcone_session_action { sessionId: "lc-...", action: "type", text: "password123" } Step 4: Submit lightcone_session_action { sessionId: "lc-...", action: "hotkey", keys: "Return" } lightcone_session_action { sessionId: "lc-...", action: "wait", seconds: 3 } Step 5: Screenshot to verify login succeeded lightcone_session_action { sessionId: "lc-...", action: "screenshot" } Step 6: Extract page content lightcone_session_action { sessionId: "lc-...", action: "html" } Step 7: Shut down lightcone_session_close { sessionId: "lc-..." } ``` ## Tips - Always take a screenshot after navigation to see the current state before clicking - Use coordinates from the screenshot to target clicks accurately - Wait 2-3 seconds after navigation or form submission for pages to load - Use `html` action to extract structured data from the page - Always close sessions when done to free resources