Selector Pipeline

Local selector pipeline service for Semantic DOM browser extension clients.

The service listens on 127.0.0.1:4317 by default. The extension sends page snapshots over WebSocket, the service runs the multi-stage selector pipeline, and the extension verifies candidate selectors in the browser.

Quick Start

npx @kien-le/selector-pipeline

This also accepts an explicit serve subcommand:

npx @kien-le/selector-pipeline serve

The CLI prompts for missing model configuration in an interactive terminal:

• endpoint
• deployment
• subscription_key
• api_version

You can also provide them as environment variables:

endpoint="https://your-resource.openai.azure.com" \
deployment="your-deployment" \
subscription_key="your-key" \
api_version="2024-02-01" \
npx @kien-le/selector-pipeline

Options

selector-pipeline --host 127.0.0.1 --port 4317 --checkpoints ./checkpoints

• --host changes the host to bind. Defaults to 127.0.0.1.
• --port changes the HTTP/WebSocket port. Defaults to 4317.
• --checkpoints changes where run artifacts are written. Defaults to ./checkpoints.

Runtime Shortcuts

When running in an interactive terminal:

• e edits model configuration without restarting the service.
• p prints the current model configuration, masking subscription_key.
• q stops the service.

Extension Integration

Start this service before using the extension's local pipeline mode. The extension connects to:

ws://127.0.0.1:4317

The health endpoint is available at:

http://127.0.0.1:4317/health