opensteer 0.6.13 → 0.7.0

package/skills/electron/SKILL.md

@@ -1,87 +0,0 @@
----
-name: electron
-description: "Automate Electron desktop apps (Slack, VS Code, Discord, Notion, and other Chromium-based desktop apps) with Opensteer by connecting to a running Chrome DevTools endpoint. Use when tasks require interacting with Electron UI, testing desktop app workflows, extracting structured data from app windows, or capturing Electron screenshots."
----
-
-# Electron App Automation with Opensteer
-
-Use this skill when a task targets an Electron desktop app instead of a normal browser tab.
-
-Read [opensteer-electron-workflow.md](references/opensteer-electron-workflow.md) first for the Opensteer connection model and execution flow.
-
-## Core Workflow
-
-1. Launch the Electron app with `--remote-debugging-port=<port>`.
-2. Connect Opensteer with `open --cdp-url http://127.0.0.1:<port>`.
-3. List windows/webviews with `tabs`, then switch with `tab-switch`.
-4. Run `snapshot action`, interact (`click`, `input`, `press`), then re-snapshot.
-5. Use `snapshot extraction` and `extract` for structured data.
-
-```bash
-# Connect Opensteer to a running Electron app on port 9222
-opensteer open --cdp-url http://127.0.0.1:9222 --session slack-desktop --name slack-desktop
-
-# Discover available windows/webviews
-opensteer tabs --session slack-desktop
-opensteer tab-switch 0 --session slack-desktop
-
-# Standard action loop
-opensteer snapshot action --session slack-desktop
-opensteer click 12 --session slack-desktop
-opensteer input 8 "release notes" --pressEnter --session slack-desktop
-opensteer snapshot action --session slack-desktop
-```
-
-## Launching Electron Apps
-
-If the app is already running, quit it first, then relaunch with the debugging flag.
-
-```bash
-# macOS examples
-open -a "Slack" --args --remote-debugging-port=9222
-open -a "Visual Studio Code" --args --remote-debugging-port=9223
-open -a "Discord" --args --remote-debugging-port=9224
-
-# Linux examples
-slack --remote-debugging-port=9222
-code --remote-debugging-port=9223
-discord --remote-debugging-port=9224
-```
-
-## Structured Extraction Pattern
-
-```bash
-opensteer snapshot extraction --session slack-desktop
-
-opensteer extract '{"channels":[{"name":{"element":21},"unread":{"element":22}}]}' \
-  --description "sidebar channels with unread state" \
-  --session slack-desktop
-```
-
-Use `--description` when possible so selector paths persist for replay.
-
-## Multiple Apps at Once
-
-Use one Opensteer session per app:
-
-```bash
-opensteer open --cdp-url http://127.0.0.1:9222 --session slack --name slack-electron
-opensteer open --cdp-url http://127.0.0.1:9223 --session vscode --name vscode-electron
-
-opensteer snapshot action --session slack
-opensteer snapshot action --session vscode
-```
-
-## Guardrails
-
-- Prefer Opensteer commands over raw Playwright for interaction/extraction.
-- Re-snapshot after each navigation or large UI change before reusing counters.
-- Keep `--name` stable inside a session for deterministic selector replay.
-- Close sessions when done: `opensteer close --session <id>`.
-- If the app has no visible page targets, Opensteer creates one automatically.
-- If `--cdp-url` connection fails, verify with `curl -s http://127.0.0.1:<port>/json/version`.
-
-## References
-
-- [opensteer-electron-workflow.md](references/opensteer-electron-workflow.md)
-- [opensteer-electron-recipes.md](references/opensteer-electron-recipes.md)

package/skills/electron/references/opensteer-electron-recipes.md

@@ -1,88 +0,0 @@
-# Opensteer Electron Recipes
-
-## Launch Commands
-
-Relaunch the app with a debugging port before connecting.
-
-```bash
-# macOS
-open -a "Slack" --args --remote-debugging-port=9222
-open -a "Visual Studio Code" --args --remote-debugging-port=9223
-open -a "Discord" --args --remote-debugging-port=9224
-
-# Linux
-slack --remote-debugging-port=9222
-code --remote-debugging-port=9223
-discord --remote-debugging-port=9224
-
-# Windows (PowerShell examples)
-"$env:LOCALAPPDATA\slack\slack.exe" --remote-debugging-port=9222
-"$env:LOCALAPPDATA\Programs\Microsoft VS Code\Code.exe" --remote-debugging-port=9223
-```
-
-Optional health check:
-
-```bash
-curl -s http://127.0.0.1:9222/json/version
-```
-
-## Connect and Select Target
-
-```bash
-opensteer open --cdp-url http://127.0.0.1:9222 --session electron --name electron
-opensteer tabs --session electron
-opensteer tab-switch 0 --session electron
-opensteer snapshot action --session electron
-```
-
-If the wrong content appears, iterate with `tab-switch` and `snapshot action` until you reach the correct window/webview.
-
-## Navigation and Interaction
-
-```bash
-opensteer snapshot action --session electron
-opensteer click 11 --description "left sidebar channel" --session electron
-opensteer input 7 "deployment notes" --pressEnter --description "search input" --session electron
-opensteer press Enter --session electron
-opensteer screenshot electron-state.png --session electron
-```
-
-## Structured Data Extraction
-
-```bash
-# Inspect extraction-focused DOM
-opensteer snapshot extraction --session electron
-
-# Build schema from observed counters
-opensteer extract '{"items":[{"title":{"element":15},"meta":{"element":16}}]}' \
-  --description "visible item list with metadata" \
-  --session electron
-```
-
-## Multi-App Pattern
-
-```bash
-# Slack
-opensteer open --cdp-url http://127.0.0.1:9222 --session slack --name slack-electron
-
-# VS Code
-opensteer open --cdp-url http://127.0.0.1:9223 --session vscode --name vscode-electron
-
-opensteer snapshot action --session slack
-opensteer snapshot action --session vscode
-```
-
-## Troubleshooting
-
-- `connection refused`:
-  - App was not launched with `--remote-debugging-port`.
-  - Port is wrong or blocked by another process.
-- Empty or incorrect snapshot:
-  - You are in the wrong target window; use `tabs` and `tab-switch`.
-  - The app has not finished rendering; wait briefly and snapshot again.
-- Counter failures (`element not found`):
-  - UI changed and counters are stale; take a fresh `snapshot action`.
-- Wrong selectors on replay:
-  - `--description` string differs from the original text; use exact wording.
-- Connection works but extraction returns empty:
-  - The Electron app may render in a webview. Use `opensteer tabs` + `opensteer tab-switch` to find the correct target.

package/skills/electron/references/opensteer-electron-workflow.md

@@ -1,85 +0,0 @@
-# Opensteer Electron Workflow
-
-This document describes the Opensteer-native flow for automating Electron apps.
-
-## 1. Connection Model
-
-Electron apps embed Chromium. Opensteer connects through Chrome DevTools Protocol (CDP):
-
-- Launch app with `--remote-debugging-port=<port>`
-- Attach with `opensteer open --cdp-url http://127.0.0.1:<port>`
-
-Example:
-
-```bash
-opensteer open --cdp-url http://127.0.0.1:9222 --session electron --name electron
-```
-
-`--session` controls runtime routing (which daemon/browser instance handles commands).
-`--name` controls selector cache namespace for deterministic replay.
-
-## 2. Window/Webview Targeting
-
-Electron apps often expose multiple targets. After connecting:
-
-```bash
-opensteer tabs --session electron
-opensteer tab-switch 0 --session electron
-opensteer snapshot action --session electron
-```
-
-Iterate `tab-switch` + `snapshot action` until you are on the correct app window/webview.
-
-## 3. Action Loop
-
-Use this loop for all interactions:
-
-1. `snapshot action`
-2. `click` / `input` / `press`
-3. re-run `snapshot action`
-
-Example:
-
-```bash
-opensteer snapshot action --session electron
-opensteer click 10 --description "navigation item" --session electron
-opensteer input 6 "release checklist" --pressEnter --description "search input" --session electron
-opensteer snapshot action --session electron
-```
-
-## 4. Extraction Loop
-
-For structured data:
-
-1. `snapshot extraction`
-2. build schema from element counters
-3. `extract <schema-json>`
-
-Example:
-
-```bash
-opensteer snapshot extraction --session electron
-opensteer extract '{"rows":[{"title":{"element":14},"status":{"element":15}}]}' \
-  --description "current visible rows with status" \
-  --session electron
-```
-
-## 5. Replay Stability
-
-- Keep `--name` stable for the same automation namespace.
-- Keep `--description` text exact across runs.
-- Re-snapshot after meaningful UI changes before reusing counters.
-
-## 6. Session Cleanup
-
-Close the session when done:
-
-```bash
-opensteer close --session electron
-```
-
-Or list active sessions:
-
-```bash
-opensteer sessions
-```

package/skills/opensteer/references/examples.md

@@ -1,118 +0,0 @@
-# Opensteer Examples
-
-## Full Workflow: CLI Exploration to Scraper Script
-
-### Step 1: Explore and cache with CLI
-
-```bash
-export OPENSTEER_SESSION=eures-session
-
-opensteer open https://europa.eu/eures/portal/jv-se/home --name "eures-jobs"
-
-opensteer snapshot action
-opensteer input 5 "software engineer" --pressEnter --description "the job search input"
-opensteer click 12 --description "the search button"
-
-# Wait for results, then extract job listings
-opensteer snapshot extraction
-opensteer extract '{"jobs":[{"title":{"element":20},"company":{"element":22},"url":{"element":20,"attribute":"href"}},{"title":{"element":35},"company":{"element":37},"url":{"element":35,"attribute":"href"}},{"title":{"element":50},"company":{"element":52},"url":{"element":50,"attribute":"href"}}]}' \
-  --description "job listing with title company and url"
-
-# Cache detail page extraction too
-opensteer click 20 --description "first job link"
-opensteer snapshot extraction
-opensteer extract '{"title":{"element":3},"company":{"element":7},"location":{"element":12},"description":{"element":18}}' \
-  --description "job detail page"
-
-opensteer close
-```
-
-### Step 2: Generate replay script (same namespace, same descriptions)
-
-```typescript
-import { Opensteer } from "opensteer";
-
-async function run() {
-  const opensteer = new Opensteer({
-    name: "eures-jobs",
-    storage: { rootDir: process.cwd() },
-  });
-
-  await opensteer.launch({ headless: false });
-
-  try {
-    await opensteer.goto("https://europa.eu/eures/portal/jv-se/home");
-
-    await opensteer.input({
-      text: "software engineer",
-      description: "the job search input",
-    });
-    await opensteer.click({ description: "the search button" });
-
-    await opensteer.waitForText("Showing 1 to 10");
-
-    // Extract all job listings using cached description — no schema needed
-    const listings = await opensteer.extract({
-      description: "job listing with title company and url",
-    });
-
-    // Visit each detail page and extract using cached description
-    for (const job of listings.jobs) {
-      await opensteer.goto(job.url);
-      await opensteer.waitForText(job.title || "Job details");
-
-      const detail = await opensteer.extract({
-        description: "job detail page",
-      });
-      console.log(JSON.stringify(detail, null, 2));
-    }
-  } finally {
-    await opensteer.close();
-  }
-}
-
-run().catch((err) => {
-  console.error(err);
-  process.exit(1);
-});
-```
-
-## Advanced: API-Based Extraction (uses direct page access)
-
-> This is a rare pattern. Only use it when the site has internal REST/GraphQL endpoints and DOM extraction via `opensteer.extract()` is insufficient.
-
-```typescript
-import { Opensteer } from "opensteer";
-
-async function run() {
-  const opensteer = new Opensteer({
-    name: "api-scraper",
-    storage: { rootDir: process.cwd() },
-  });
-
-  await opensteer.launch({ headless: false });
-
-  try {
-    // Navigate first to establish session cookies
-    await opensteer.goto("https://example.com");
-
-    const data = await opensteer.page.evaluate(async () => {
-      const res = await fetch("https://api.example.com/search?q=shoes&limit=100", {
-        headers: { "Content-Type": "application/json" },
-      });
-      return res.json();
-    });
-
-    console.log(JSON.stringify(data, null, 2));
-  } finally {
-    await opensteer.close();
-  }
-}
-
-run().catch((err) => {
-  console.error(err);
-  process.exit(1);
-});
-```
-
-> **SDK Rule**: For all other data extraction, use `opensteer.extract()`.