searchts 0.1.0__tar.gz

searchts-0.1.0/.env.example

@@ -0,0 +1,18 @@
+# searchts Configuration
+# Copy to .env and fill in your values
+# Or use: searchts configure
+
+# Exa Search (free 1000/month) — https://exa.ai
+# EXA_API_KEY=exa-your-key-here
+
+# GitHub Token (optional, for higher rate limits) — https://github.com/settings/tokens
+# GITHUB_TOKEN=ghp_your_token_here
+
+# Reddit ISP Proxy (optional, for full Reddit access)
+# REDDIT_PROXY=http://user:pass@ip:port
+
+# Groq Whisper (optional, for video transcription) — https://console.groq.com
+# GROQ_API_KEY=gsk_your_key_here
+
+# OpenAI Whisper (optional fallback when Groq is rate-limited) — https://platform.openai.com
+# OPENAI_API_KEY=sk-your_key_here

searchts-0.1.0/.github/workflows/pytest.yml

@@ -0,0 +1,70 @@
+name: ci
+
+on:
+  push:
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install package and test deps
+        run: |
+          python -m pip install --upgrade pip
+          pip install -c constraints.txt -e .[dev]
+
+      - name: Run tests
+        run: |
+          pytest -q
+
+  # Editable installs (-e) never exercise wheel packaging, so a broken wheel
+  # can pass tests and still fail every real `pip install` from source.
+  # This job builds the actual wheel and installs it into a clean venv.
+  wheel-gate:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Build wheel
+        run: |
+          python -m pip install --upgrade pip build
+          python -m build
+
+      - name: Verify wheel has no duplicate entries and ships data files
+        run: |
+          python - <<'PY'
+          import glob, zipfile, collections
+          whl = glob.glob("dist/*.whl")[0]
+          names = zipfile.ZipFile(whl).namelist()
+          dupes = [n for n, c in collections.Counter(names).items() if c > 1]
+          assert not dupes, f"duplicate entries in wheel: {dupes}"
+          assert "searchts/skill/SKILL.md" in names, "SKILL.md missing from wheel"
+          for prefix in ("searchts/guides/", "searchts/scripts/", "searchts/skill/references/"):
+              assert any(n.startswith(prefix) for n in names), f"{prefix} missing from wheel"
+          print(f"wheel OK: {len(names)} entries, no duplicates, data files present")
+          PY
+
+      - name: Smoke-install wheel into clean venv
+        run: |
+          python -m venv /tmp/smoke
+          /tmp/smoke/bin/pip install --quiet dist/*.whl
+          /tmp/smoke/bin/searchts version
+          cd /tmp && /tmp/smoke/bin/python -c "import searchts; from importlib.resources import files; assert (files('searchts')/'skill'/'SKILL.md').is_file(); print('SKILL.md ships in site-packages OK')"

searchts-0.1.0/.gitignore

@@ -0,0 +1,18 @@
+__pycache__/
+*.pyc
+*.pyo
+.pytest_cache/
+*.egg-info/
+dist/
+build/
+.env
+.searchts/
+*.log
+
+# Claude Code personal permission settings — local only, never commit
+.claude/settings.local.json
+uv.lock
+
+# Local dev (this fork)
+.venv/
+scratch/

searchts-0.1.0/CHANGELOG.md

@@ -0,0 +1,33 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+---
+
+## [1.1.0] - 2025-02-25
+
+### New Channels
+
+#### LinkedIn
+- Read person profiles, company pages, and job details via [linkedin-scraper-mcp](https://github.com/stickerdaniel/linkedin-mcp-server)
+- Search people and jobs via MCP, with Exa fallback
+- Fallback to Jina Reader when MCP is not configured
+
+### Improvements
+
+- `searchts doctor` now detects the LinkedIn channel
+- CLI: added `search-linkedin` subcommand
+- Updated install guide with setup instructions for the new channel
+
+---
+
+## [1.0.0] - 2025-02-24
+
+### Initial Release
+
+- 8 channels: Web (Jina Reader), Search (Exa), GitHub, YouTube, Reddit, Twitter/X, LinkedIn, RSS
+- CLI with `read`, `search`, `doctor`, `install` commands
+- Unified channel interface — each platform is a single pluggable Python file
+- Auto-detection of local vs server environments
+- Built-in diagnostics via `searchts doctor`
+- Skill registration for Claude Code / OpenClaw / Cursor

searchts-0.1.0/CLAUDE.md

@@ -0,0 +1,43 @@
+# CLAUDE.md
+
+## Project
+searchts — Python CLI + library that gives AI agents read/search access to 8 platforms.
+Positioning: installer + doctor + config tool. NOT a wrapper — after install, agents call upstream tools directly.
+Repo: github.com/capad-xyz/searchts | License: MIT | Version: 0.1.0
+
+## Commands
+- `pip install -e .` — Dev install
+- `pytest tests/ -v` — All tests
+- `pytest tests/test_cli.py -v` — CLI tests only
+- `bash test.sh` — Full integration test (creates venv, installs, runs doctor + channel tests)
+- `python -m searchts.cli doctor` — Run diagnostics
+- `python -m searchts.cli install --env=auto` — Auto-configure
+
+## Structure
+- `searchts/cli.py` — CLI entry point (argparse)
+- `searchts/core.py` — Core read/search routing logic
+- `searchts/config.py` — Config management (YAML, env vars)
+- `searchts/doctor.py` — Diagnostics engine
+- `searchts/channels/` — One file per platform (twitter.py, reddit.py, youtube.py, etc.)
+- `searchts/channels/base.py` — Base channel class (all channels inherit from this)
+- `searchts/integrations/mcp_server.py` — MCP server integration
+- `searchts/skill/` — OpenClaw skill files
+- `searchts/guides/` — Usage guides
+- `tests/` — pytest tests
+- `config/mcporter.json` — MCP tool config
+
+## Conventions
+- Python 3.10+ with type hints
+- Each channel is a single file in `channels/`, inherits from `BaseChannel`
+- Channel contract: must implement `can_handle(url)`, `read(url)`, `search(query)`, `check()` methods
+- Use `loguru` for logging, `rich` for CLI output
+- Commit format: `type(scope): message` (one commit = one thing)
+- All upstream tool calls go through public API/CLI, never hack internals
+
+## Rules
+- NEVER modify upstream open source projects' source code
+- searchts is a "glue layer" — only route and call, don't reimagine
+- Version in THREE places must match: `pyproject.toml`, `__init__.py`, `tests/test_cli.py`
+- Always new branch for changes, PR to main, never push to main directly
+- Run `pytest tests/ -v` before committing — all tests must pass
+- Cookie-based auth (Twitter): use Cookie-Editor export method only, no QR scan

searchts-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,80 @@
+# Contributing to searchts
+
+Thank you for your interest in contributing to searchts! This document provides guidelines and instructions for contributing.
+
+## Getting Started
+
+1. Fork the repository on GitHub
+2. Clone your fork locally
+3. Create a new branch for your contribution
+4. Make your changes
+5. Run tests and linting
+6. Submit a pull request
+
+## Development Setup
+
+```bash
+# Clone your fork
+git clone https://github.com/YOUR_USERNAME/searchts.git
+cd searchts
+
+# Install in development mode
+pip install -e ".[dev]"
+
+# Install pre-commit hooks (optional but recommended)
+pre-commit install
+```
+
+## Code Style
+
+We use the following tools to maintain code quality:
+
+- **ruff**: Linting and import sorting
+- **mypy**: Type checking
+- **pytest**: Testing
+
+Run all checks before submitting a PR:
+
+```bash
+# Linting
+ruff check searchts tests
+ruff format searchts tests
+
+# Type checking
+mypy searchts
+
+# Tests
+pytest
+```
+
+## Adding New Channels
+
+searchts uses a unified channel interface. To add a new platform:
+
+1. Create a new file in `searchts/channels/`
+2. Implement the channel contract (see existing channels for examples)
+3. Add tests in `tests/test_channels.py`
+4. Update `searchts/doctor.py` to include the new channel
+5. Update documentation
+
+## Pull Request Guidelines
+
+- **Small, focused changes** are preferred over large refactors
+- Include tests for new functionality
+- Update documentation if needed
+- Follow existing code style
+- Reference any related issues
+
+## Reporting Issues
+
+When reporting bugs, please include:
+
+- Python version
+- Operating system
+- Steps to reproduce
+- Expected vs actual behavior
+- Any error messages
+
+## Questions?
+
+Feel free to open an issue for questions or join discussions.

searchts-0.1.0/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025 Agent Eyes (original Agent-Reach project)
+Copyright (c) 2026 capad-xyz (searchts modifications and additions)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

searchts-0.1.0/PKG-INFO

@@ -0,0 +1,140 @@
+Metadata-Version: 2.4
+Name: searchts
+Version: 0.1.0
+Summary: Give your AI agent eyes on the open web: an escalating open-source unlocker (browser-fingerprinted fetch -> JS-render relay -> stealth browser) plus read/search across web, search, GitHub, YouTube, Reddit, Twitter, LinkedIn, and RSS.
+Project-URL: Homepage, https://github.com/capad-xyz/searchts
+Project-URL: Repository, https://github.com/capad-xyz/searchts
+Project-URL: Issues, https://github.com/capad-xyz/searchts/issues
+Author: capad-xyz
+License: MIT
+License-File: LICENSE
+Keywords: agent-infrastructure,ai-agent,ai-search,automation,claude-code,cli,cursor,free-api,llm-tools,mcp,no-api-key,openai,reddit-scraper,search,twitter-scraper,unlocker,web-reader,web-scraper,youtube-transcript
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.10
+Requires-Dist: curl-cffi>=0.7
+Requires-Dist: feedparser>=6.0
+Requires-Dist: loguru>=0.7
+Requires-Dist: python-dotenv>=1.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: requests>=2.28
+Requires-Dist: rich>=13.0
+Requires-Dist: trafilatura>=1.8
+Requires-Dist: yt-dlp>=2024.0
+Provides-Extra: all
+Requires-Dist: browser-cookie3>=0.19; extra == 'all'
+Requires-Dist: mcp[cli]>=1.0; extra == 'all'
+Requires-Dist: patchright>=1.50; extra == 'all'
+Provides-Extra: browser
+Requires-Dist: patchright>=1.50; extra == 'browser'
+Provides-Extra: cookies
+Requires-Dist: browser-cookie3>=0.19; extra == 'cookies'
+Provides-Extra: dev
+Requires-Dist: mypy>=1.12; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.8; extra == 'dev'
+Requires-Dist: types-pyyaml>=6.0; extra == 'dev'
+Requires-Dist: types-requests>=2.32; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# searchts
+
+**Give your AI agent eyes on the open web.** `searchts` is a Python CLI and library that lets an AI agent read and search the internet, fronted by a fully open-source "unlocker" that gets through common bot-walls without any paid proxy or unlocker service.
+
+License: MIT. Python 3.10+.
+
+## Why
+
+AI agents constantly need to read web pages, but the naive way they fetch is trivially blocked by modern anti-bot systems (Cloudflare, PerimeterX, DataDome). Paid unlocker services solve this, but the thing they really charge for is a large pool of clean residential IP addresses. `searchts` runs on your own machine, from your own connection, at personal volume, so it sidesteps that cost and gets through most of those walls for free.
+
+## The unlocker
+
+`searchts` reads any URL through an escalating ladder and stops at the first tier that returns real content:
+
+1. **curl_cffi** : a fetch that impersonates a real Chrome's TLS/JA3 and HTTP2 fingerprint. Beats user-agent and fingerprint filters. Fast, local, private.
+2. **Jina Reader** : a JavaScript-rendering relay, for pages that only fill in content after running JS.
+3. **stealth browser** : an undetected headless Chromium (patchright), launched lazily only when the cheaper tiers fail, for live JS / Cloudflare managed challenges.
+
+If every tier is defeated by an interactive CAPTCHA, an optional human-in-the-loop step opens a real browser so you can solve it once and continue.
+
+Block detection is phrase-based, not vendor-name based, so legitimate pages that merely embed a bot-sensor script are not falsely rejected. Content is extracted to clean Markdown with `trafilatura`.
+
+## Install
+
+```bash
+pip install searchts
+# optional: the stealth-browser tier
+pip install "searchts[browser]" && patchright install chromium
+```
+
+For development:
+
+```bash
+pip install -e . --no-build-isolation
+```
+
+## Quickstart
+
+```bash
+searchts read https://example.com                       # clean Markdown to stdout
+searchts read https://news.ycombinator.com --json       # structured: backend, status, chars, text
+searchts read https://example.com --backend curl_cffi   # force a single tier
+searchts read https://example.com --human               # human-in-the-loop CAPTCHA fallback
+```
+
+Content goes to stdout (pipeable); status goes to stderr.
+
+## Features
+
+- **Escalating open-source unlocker**: curl_cffi, then Jina Reader, then a stealth browser.
+- **`searchts read <url>`**: run the unlocker from the command line and print clean Markdown.
+- **MCP tool `read_url(url)`**: expose the unlocker to agents (Claude, Cursor, and others) so they can read any page directly.
+- **Per-domain backend memory**: remembers which tier worked for each domain and tries it first; disable with `SEARCHTS_NO_MEMORY=1`.
+- **Human-in-the-loop CAPTCHA**: on an interactive challenge, hand off to your real browser to solve once.
+- **Read and search across sources**: web (any URL), search (Exa), GitHub, YouTube, Reddit, Twitter/X, LinkedIn, and RSS.
+
+## Use as a library
+
+```python
+from searchts import unlocker
+
+r = unlocker.fetch("https://example.com")
+print(r.backend, r.status, len(r.text))
+print(r.text)
+```
+
+## MCP
+
+`searchts` ships an MCP server (`searchts/integrations/mcp_server.py`) that exposes `read_url(url)`. Point your MCP-capable client at it to give the agent a one-call web reader backed by the full unlocker ladder.
+
+## How it works, and its limits
+
+- It runs from your own residential IP at personal volume, which is why it needs no paid proxy pool. It is a personal-grade research tool, not a mass-scraping system.
+- Interactive CAPTCHAs (DataDome / Turnstile press-and-hold) are the honest ceiling. Use `--human` for those.
+- Anti-bot systems evolve; this is an arms race and the techniques may need occasional updates.
+- Respect each site's terms of service and use responsibly.
+
+## Configuration
+
+Optional API keys, via `searchts configure` or a `.env` file (see `.env.example`):
+
+- **Exa** for web search (free tier available)
+- **GitHub token** for higher rate limits
+- **Groq / OpenAI** for video transcription
+
+Run `searchts doctor` to check what is configured and working.
+
+## Credits
+
+`searchts` builds on and extends [Agent-Reach](https://github.com/Panniantong/Agent-Reach) (MIT), reusing its channel, installer, and diagnostics architecture. The escalating open-source unlocker, per-domain backend memory, human-in-the-loop CAPTCHA flow, the `read_url` MCP tool, and the `read` CLI command are additions in `searchts`. Thanks to the original authors.
+
+## License
+
+MIT. See [LICENSE](LICENSE). Original portions Copyright (c) 2025 Agent Eyes; modifications and additions Copyright (c) 2026 capad-xyz.

searchts-0.1.0/README.md

@@ -0,0 +1,94 @@
+# searchts
+
+**Give your AI agent eyes on the open web.** `searchts` is a Python CLI and library that lets an AI agent read and search the internet, fronted by a fully open-source "unlocker" that gets through common bot-walls without any paid proxy or unlocker service.
+
+License: MIT. Python 3.10+.
+
+## Why
+
+AI agents constantly need to read web pages, but the naive way they fetch is trivially blocked by modern anti-bot systems (Cloudflare, PerimeterX, DataDome). Paid unlocker services solve this, but the thing they really charge for is a large pool of clean residential IP addresses. `searchts` runs on your own machine, from your own connection, at personal volume, so it sidesteps that cost and gets through most of those walls for free.
+
+## The unlocker
+
+`searchts` reads any URL through an escalating ladder and stops at the first tier that returns real content:
+
+1. **curl_cffi** : a fetch that impersonates a real Chrome's TLS/JA3 and HTTP2 fingerprint. Beats user-agent and fingerprint filters. Fast, local, private.
+2. **Jina Reader** : a JavaScript-rendering relay, for pages that only fill in content after running JS.
+3. **stealth browser** : an undetected headless Chromium (patchright), launched lazily only when the cheaper tiers fail, for live JS / Cloudflare managed challenges.
+
+If every tier is defeated by an interactive CAPTCHA, an optional human-in-the-loop step opens a real browser so you can solve it once and continue.
+
+Block detection is phrase-based, not vendor-name based, so legitimate pages that merely embed a bot-sensor script are not falsely rejected. Content is extracted to clean Markdown with `trafilatura`.
+
+## Install
+
+```bash
+pip install searchts
+# optional: the stealth-browser tier
+pip install "searchts[browser]" && patchright install chromium
+```
+
+For development:
+
+```bash
+pip install -e . --no-build-isolation
+```
+
+## Quickstart
+
+```bash
+searchts read https://example.com                       # clean Markdown to stdout
+searchts read https://news.ycombinator.com --json       # structured: backend, status, chars, text
+searchts read https://example.com --backend curl_cffi   # force a single tier
+searchts read https://example.com --human               # human-in-the-loop CAPTCHA fallback
+```
+
+Content goes to stdout (pipeable); status goes to stderr.
+
+## Features
+
+- **Escalating open-source unlocker**: curl_cffi, then Jina Reader, then a stealth browser.
+- **`searchts read <url>`**: run the unlocker from the command line and print clean Markdown.
+- **MCP tool `read_url(url)`**: expose the unlocker to agents (Claude, Cursor, and others) so they can read any page directly.
+- **Per-domain backend memory**: remembers which tier worked for each domain and tries it first; disable with `SEARCHTS_NO_MEMORY=1`.
+- **Human-in-the-loop CAPTCHA**: on an interactive challenge, hand off to your real browser to solve once.
+- **Read and search across sources**: web (any URL), search (Exa), GitHub, YouTube, Reddit, Twitter/X, LinkedIn, and RSS.
+
+## Use as a library
+
+```python
+from searchts import unlocker
+
+r = unlocker.fetch("https://example.com")
+print(r.backend, r.status, len(r.text))
+print(r.text)
+```
+
+## MCP
+
+`searchts` ships an MCP server (`searchts/integrations/mcp_server.py`) that exposes `read_url(url)`. Point your MCP-capable client at it to give the agent a one-call web reader backed by the full unlocker ladder.
+
+## How it works, and its limits
+
+- It runs from your own residential IP at personal volume, which is why it needs no paid proxy pool. It is a personal-grade research tool, not a mass-scraping system.
+- Interactive CAPTCHAs (DataDome / Turnstile press-and-hold) are the honest ceiling. Use `--human` for those.
+- Anti-bot systems evolve; this is an arms race and the techniques may need occasional updates.
+- Respect each site's terms of service and use responsibly.
+
+## Configuration
+
+Optional API keys, via `searchts configure` or a `.env` file (see `.env.example`):
+
+- **Exa** for web search (free tier available)
+- **GitHub token** for higher rate limits
+- **Groq / OpenAI** for video transcription
+
+Run `searchts doctor` to check what is configured and working.
+
+## Credits
+
+`searchts` builds on and extends [Agent-Reach](https://github.com/Panniantong/Agent-Reach) (MIT), reusing its channel, installer, and diagnostics architecture. The escalating open-source unlocker, per-domain backend memory, human-in-the-loop CAPTCHA flow, the `read_url` MCP tool, and the `read` CLI command are additions in `searchts`. Thanks to the original authors.
+
+## License
+
+MIT. See [LICENSE](LICENSE). Original portions Copyright (c) 2025 Agent Eyes; modifications and additions Copyright (c) 2026 capad-xyz.

searchts-0.1.0/SECURITY.md

@@ -0,0 +1,51 @@
+# Security Policy
+
+## Supported Versions
+
+| Version | Supported |
+|---------|-----------|
+| Latest  | ✅ Yes    |
+
+## Reporting a Vulnerability
+
+If you discover a security vulnerability in searchts, please report 
+it responsibly by using GitHub's private security advisory feature:
+
+👉 **[Report a vulnerability](https://github.com/capad-xyz/searchts/security/advisories/new)**
+
+Please do NOT open a public GitHub issue for security vulnerabilities.
+
+## What to Include
+
+- Description of the vulnerability
+- Steps to reproduce
+- Affected versions
+- Potential impact
+- Suggested fix (if any)
+
+## Response Timeline
+
+- Acknowledgement within **48 hours**
+- Status update within **7 days**
+- Fix timeline communicated within **14 days**
+
+## Scope
+
+The following are considered in scope:
+- Authentication and authorization bypass
+- Remote code execution
+- Path traversal / arbitrary file read
+- Server-Side Request Forgery (SSRF)
+- Injection vulnerabilities (SQL, command, prompt)
+- Sensitive data exposure
+
+## Out of Scope
+
+- Vulnerabilities in dependencies (report to the dependency maintainer)
+- Social engineering attacks
+- Denial of service via resource exhaustion
+
+## Credits
+
+We appreciate responsible disclosure and will credit researchers 
+in our release notes unless anonymity is requested.

searchts-0.1.0/config/mcporter.json

@@ -0,0 +1,8 @@
+{
+  "mcpServers": {
+    "exa": {
+      "baseUrl": "https://mcp.exa.ai/mcp"
+    }
+  },
+  "imports": []
+}

searchts-0.1.0/constraints.txt

@@ -0,0 +1,17 @@
+# searchts tested dependency set
+# Usage:
+#   pip install -c constraints.txt -e .[dev]
+
+requests==2.32.5
+feedparser==6.0.12
+python-dotenv==1.2.1
+loguru==0.7.3
+PyYAML==6.0.3
+rich==14.3.2
+yt-dlp==2025.5.22
+
+pytest==8.0.0
+ruff==0.15.1
+mypy==1.19.1
+types-requests==2.32.4.20260107
+types-PyYAML==6.0.12.20250915

searchts-0.1.0/docs/assets/logo-1.svg

@@ -0,0 +1,34 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" width="512" height="512">
+  <defs>
+    <linearGradient id="grad1" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" style="stop-color:#0066FF"/>
+      <stop offset="100%" style="stop-color:#00AAFF"/>
+    </linearGradient>
+    <clipPath id="clip-circle">
+      <circle cx="256" cy="256" r="140"/>
+    </clipPath>
+  </defs>
+
+  <rect width="512" height="512" fill="#0A0A1A"/>
+
+  <!-- Outer ring - the "boundary" -->
+  <circle cx="256" cy="256" r="160" fill="none" stroke="url(#grad1)" stroke-width="8" opacity="0.3"/>
+  <circle cx="256" cy="256" r="140" fill="none" stroke="url(#grad1)" stroke-width="3" opacity="0.6"/>
+
+  <!-- Inner: agent core point -->
+  <circle cx="220" cy="256" r="24" fill="url(#grad1)"/>
+
+  <!-- "Reach" arcs - starting from the core, crossing the ring boundary, extending outward -->
+  <path d="M 230 256 Q 320 180, 420 200"
+        fill="none" stroke="url(#grad1)" stroke-width="6" stroke-linecap="round" opacity="0.9"/>
+  <path d="M 230 256 Q 320 256, 420 256"
+        fill="none" stroke="url(#grad1)" stroke-width="6" stroke-linecap="round" opacity="0.7"/>
+  <path d="M 230 256 Q 320 330, 420 312"
+        fill="none" stroke="url(#grad1)" stroke-width="6" stroke-linecap="round" opacity="0.5"/>
+
+  <!-- Target points: where the reach lands -->
+  <circle cx="420" cy="200" r="8" fill="#00AAFF" opacity="0.9"/>
+  <circle cx="420" cy="256" r="8" fill="#00AAFF" opacity="0.7"/>
+  <circle cx="420" cy="312" r="8" fill="#00AAFF" opacity="0.5"/>
+</svg>