Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 

Repository files navigation

✨ Starlight Protocol

Resilient browser automation through autonomous Sentinel coordination.


What is Starlight?

Starlight is an open protocol for building self-healing browser automation systems. Instead of brittle scripts that break when the DOM changes, Starlight uses a constellation of autonomous Sentinels that detect and clear obstacles in real-time.

The Problem

  • 🔴 Flaky tests fail randomly due to popups, spinners, network delays
  • 🔴 Hardcoded waits slow down execution and still fail
  • 🔴 Selector changes break entire test suites

The Solution

  • Autonomous Sentinels handle popups, cookies, modals automatically
  • Entropy-based stability waits only as long as needed
  • Self-healing learns to clear new obstacles without code changes

Quick Start

Python SDK

pip install starlight-protocol
from starlight_protocol import SentinelBase

class MySentinel(SentinelBase):
    async def on_pre_check(self, params, msg_id):
        # Your obstacle detection logic
        await self.send_clear()

sentinel = MySentinel()
sentinel.run()

Repositories

Repo Description
starlight Reference implementation (Node.js Hub + Python SDK)

Resources


Architecture

┌─────────────────────────────────────────────────────────────────┐
│                        INTENT LAYER                             │
│                   (Your Test Script)                            │
└─────────────────────────────────────────────────────────────────┘
                              │ starlight.intent
                              ▼
┌─────────────────────────────────────────────────────────────────┐
│                          HUB                                    │
│              (Orchestrator + Browser Control)                   │
└─────────────────────────────────────────────────────────────────┘
        ▲                     ▲                     ▲
        │                     │                     │
┌───────────────┐     ┌─────────────┐     ┌─────────────┐
│    Pulse      │     │   Janitor   │     │   Vision    │
│  (Stability)  │     │ (Obstacles) │     │    (AI)     │
│  Priority: 1  │     │ Priority: 5 │     │ Priority: 7 │
└───────────────┘     └─────────────┘     └─────────────┘

License

MIT - Created by Dhiraj Das

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors