STAR Tools Documentation

Everything you need to know about STAR Tracker and STAR Annotations. Built for SAFE-T, SSR, and PAT investigators on Paragon.

Chrome Extension Manifest V3 Vanilla JS Zero Dependencies

What is STAR Tools?

STAR Tools is a suite of Chrome extensions built for claim investigators on Paragon. It consists of two independent extensions:

Tracker

STAR Tracker

Automatic AHT tracking per queue, per marketplace. Real-time dashboard, floating widget, agent status monitoring, and quality-of-life automations.

Annotations

STAR Annotations

One-click annotation injection for Paragon cases. Category-based buttons, folder organization, email auto-fill, and tracking data capture.

Installation

1

Download the bundle

Get the latest STAR-Tools-Bundle.zip from the landing page or your team's shared drive.

2

Extract the folders

Unzip to get two folders: STAR-Tracker/ and STAR-Annotations/

3

Load in Chrome

Go to chrome://extensions, enable Developer Mode, click "Load unpacked" and select each folder.

4

Select your profile

Click the STAR Tracker icon and choose your profile: SAFE-T, SSR, or PAT. Open Paragon and start investigating.

Profiles

STAR Tracker supports three independent profiles. Each has its own queue map, dashboard, settings, and detector. Switching profiles is instant via the launcher.

ProfileProgramQueuesMarketplaces
SAFE-TSeller Assurance for E-commerce Transactions~506 (NA, UK, IN, BR, MX, ES)
SSRSeller Support Requests~18421
PATProduct Authenticity~89823

Core Tracking

STAR Tracker automatically detects when a case starts and ends in Paragon, measuring the exact handle time per queue.

Case Detection
MutationObserver on kat-card#taskItem elements in the lobby
Queue Detection
Regex on CTPS iframe header text + backup from #queue_name hidden inputs
Timer
Date.now() based, offset by Paragon's displayed timer
Case End
Card disappearance + Submit button click (5s merge window)
Discards
Cases < 10s ignored. SAFE-T > 1hr ignored (SSR/PAT no limit)
Storage
Stats per queue, daily history, case log with timestamps

Dashboard

The popup dashboard shows live stats grouped by marketplace. Click any MP header to collapse/expand. Navigate between dates to view historical data.

  • Queues grouped by marketplace with color-coded headers
  • Live case count, total time, and average AHT per queue
  • Recent Cases panel (last 5 cases with queue, time, case ID)
  • Date navigation for historical stats
  • Export: CSV with daily stats, aux time, and case log
  • Import: accepts export format and backup format, merges with existing data

Floating Widget

A compact floating timer visible on every page when a profile is active. Shows the current case queue, label, flag, target time, and live aux status.

  • Draggable — position cached in storage
  • Open/closed state persisted across page loads
  • Lite mode: simplified styling, 3s update interval

Settings

Four collapsible sections for full customization:

Personalize
Lite mode toggle, background gradient colors, banner image/color, marketplace folder colors. Lite mode disables all glass effects for low-end PCs.
History
Save daily history toggle, recent cases toggle, import/export stats as CSV backup.
Queue List
Import/export queues as CSV. Add, edit, delete individual queues. Format: MP, Queue Email, Label, Target Minutes.
Additional Quality of Life
Marketplace Badge, Auto-Open Tools, and Keyword Alerts. See dedicated sections below.

Paragon Dark Mode

One toggle inverts Paragon's entire UI into a dark theme using CSS filter: invert(1) hue-rotate(180deg). Images and videos are re-inverted to preserve their original colors.

Auto Features

FeatureDescription
Auto-AcceptAutomatically clicks the Accept button when a case arrives
Auto-CleanClears missed contact notifications
Auto-IncrementClicks the Increase Task button
Auto-Open AttachmentsOpens seller attachment links in new tabs automatically
New in v3.7

Marketplace Badge

A colored badge with the marketplace code (US, UK, DE, IN, etc.) displayed next to the queue name in the case header. Provides instant visual awareness of which marketplace the current case belongs to.

Marketplaces
23 supported, each with a unique color
Colors
Normal mode uses your custom MP colors from Settings. Lite mode uses fixed country-inspired colors.
Toggle
Settings > Additional Quality of Life > Enable Marketplace Badge (OFF by default)
Live Updates
Changing colors in settings reflects immediately on the badge
New in v3.7

Auto-Open Tools

Automatically opens investigation tools when a new case starts, based on which marketplace folder the queue belongs to. Currently available for SAFE-T only.

Available tools: Grass, OBLT, SPOT, PeekNow

How it works

  1. Go to Settings > Additional Quality of Life > Auto-Open Tools
  2. Each tool starts empty (inactive). Click the + button to assign marketplace folders.
  3. When a new case loads and the queue's marketplace matches an assigned folder, the tool opens automatically.
  4. Remove a folder by clicking the X on its badge to stop auto-opening for that marketplace.

Tool locations

ToolActionLocation
GrassOpens URL in new tabClaim Details iframe
OBLTOpens URL in new tabClaim Details iframe
SPOTSimulates clickClaim Details iframe
PeekNowClicks button via Shadow DOMCTPS iframe header

Keyword Alerts

Define keywords that trigger a visual alert when found anywhere in a case. Alerts fire automatically on case load.

  • Add/remove keywords with enable/disable toggle per keyword
  • Scans all frames including sibling iframes
  • Glass modal alert with Acknowledge button
  • Three visual modes: dark glass, light glass, lite flat

STAR Annotations

Injects annotation buttons below the claim action textarea in Paragon. Buttons insert pre-written text for SAFE-T claim resolutions. Supports category-based organization with folder filtering.

Categories
GRNT (Grant), NOGRNT (No Grant), Miscellaneous
Folders
Organize buttons into folders, filter by active folder via toolbar pills
Append Mode
Toggle to append text instead of replacing the textarea content

Button Editor

Click the extension icon to open the editor popup. Manage your annotation buttons with full CRUD operations.

  • Add, edit, delete, and reorder buttons (drag and drop)
  • Category color pickers (GRNT, NOGRNT, Miscellaneous)
  • Folder management: create/delete folders
  • Per-button folder assignment
  • Import/Export as JSON

Tracking Auto-Fill

Automatically captures return and forward tracking data from the case and fills email blurb placeholders.

Return Tracking

Captures carrier, tracking number, status, delivered/shipped dates from the Return Details widget.

Forward Tracking

Reads tracking data from data-show-tracking-events JSON attributes and expanded tracking details.

Sidebar widget on the left panel shows all captured data with editable fields and retry buttons.

Changelog

April 22, 2026

Auto-Open Tools SAFE-T

Automatically open Grass, OBLT, SPOT, or PeekNow when a case starts based on marketplace folder assignments.

April 21, 2026

Marketplace Badge

Colored badge with MP code next to queue name. Custom colors in normal mode, fixed colors in lite mode.

April 21, 2026

Settings Reorganization

"Keyword Alerts" section renamed to "Additional Quality of Life" to house new QoL features.

April 2026

v3.7 Release

Multi-profile system (SAFE-T, SSR, PAT), Liquid Glass theme, keyword alerts, lite mode, floating widget, Paragon dark mode.

Architecture

STAR-Tracker/
  manifest.json          MV3 config, content script rules
  background.js          Service worker: timers, routing, storage
  content.js             Main frame: case detection, aux, dark mode
  attachments.js         All frames: attachments, submit, auto-open tools
  widget.js              Floating timer on all pages
  launcher.html/js/css   Profile selector
  profiles/
    registry.js          Profile definitions
    _template/           Template for new profiles
    safet/               SAFE-T (config, detector, popup, settings)
    ssr/                 SSR
    pat/                 PAT

STAR-Annotations/
  manifest.json          MV3 config
  background.js          Opens editor on icon click
  inject.js              All injection logic (~1069 lines)
  editor.html/js/css     Button editor popup

Storage Keys

Profile-Scoped

KeyTypeDescription
stats_[profile]ObjectLive AHT accumulator per queue
statsHistory_[profile]ObjectDaily stats archive
caseLog_[profile]ObjectCase-by-case log with timestamps
mpColors_[profile]ObjectCustom marketplace colors
autoOpenTools_safetObjectAuto-open tool to folder config

Global

KeyTypeDescription
activeProfileStringCurrent profile (safet/ssr/pat)
liteModeBooleanLite mode toggle
mpBadgeBooleanMarketplace badge toggle
starKeywordsArrayKeyword alert list
statusTimeObjectAux time accumulator
paragonDarkModeBooleanDark mode toggle