diff --git a/.github/workflows/build-release.yml b/.github/workflows/build-release.yml index 8de42570..9e5292b5 100644 --- a/.github/workflows/build-release.yml +++ b/.github/workflows/build-release.yml @@ -17,14 +17,19 @@ jobs: include: - os: macos-latest target: macos-arm64 + wheel-platform: macosx_11_0_arm64 - os: macos-15-intel target: macos-x86_64 + wheel-platform: macosx_11_0_x86_64 - os: ubuntu-22.04 target: linux-x86_64 + wheel-platform: manylinux_2_17_x86_64 - os: ubuntu-22.04-arm target: linux-arm64 + wheel-platform: manylinux_2_17_aarch64 - os: windows-latest target: windows-x86_64 + wheel-platform: win_amd64 runs-on: ${{ matrix.os }} @@ -39,17 +44,33 @@ jobs: - uses: astral-sh/setup-uv@d4b2f3b6ecc6e67c4457f6d3e41ec42d3d0fcb86 # v5.4.2 + - uses: actions/setup-go@44694675825211faa026b3c33043df3e48a5fa00 # v6.0.0 + with: + go-version: '1.24.x' + check-latest: true + cache-dependency-path: strix/interface/tui/go.sum + - name: Build shell: bash + env: + STRIX_WHEEL_PLATFORM_TAG: ${{ matrix.wheel-platform }} run: | uv sync --frozen + uv build --wheel + uv run python -c 'import glob, os, sys, zipfile; wheels = glob.glob("dist/*.whl"); assert len(wheels) == 1, wheels; archive = zipfile.ZipFile(wheels[0]); tui = "strix/bin/strix-tui.exe" if sys.platform == "win32" else "strix/bin/strix-tui"; assert tui in archive.namelist(); metadata = archive.read(next(name for name in archive.namelist() if name.endswith(".dist-info/WHEEL"))).decode(); assert "Root-Is-Purelib: false" in metadata; assert "Tag: py3-none-" + os.environ["STRIX_WHEEL_PLATFORM_TAG"] in metadata' + uv run pyinstaller strix.spec --noconfirm if [[ "${{ runner.os }}" == "Windows" ]]; then + PYI_BINARY="dist/strix.exe" + TUI_NAME="strix-tui.exe" dist/strix.exe --version else + PYI_BINARY="dist/strix" + TUI_NAME="strix-tui" dist/strix --version fi + uv run pyi-archive_viewer -l "$PYI_BINARY" | grep -E "strix[/\\]+bin[/\\]+$TUI_NAME" >/dev/null if [[ "${{ matrix.target }}" == "linux-arm64" ]]; then file dist/strix @@ -77,6 +98,7 @@ jobs: path: | dist/release/*.tar.gz dist/release/*.zip + dist/*.whl if-no-files-found: error release: @@ -96,4 +118,4 @@ jobs: with: prerelease: ${{ !startsWith(github.ref, 'refs/tags/') }} generate_release_notes: true - files: release/* + files: release/** diff --git a/.gitignore b/.gitignore index cc938c29..89db2d7e 100644 --- a/.gitignore +++ b/.gitignore @@ -93,3 +93,8 @@ Thumbs.db schema.graphql .opencode/ + +# Root-only local data and reference checkouts +/.benchmarks/ +/references/ +/strix_runs_main/ diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml index b201051b..7ceb3cc4 100644 --- a/.pre-commit-config.yaml +++ b/.pre-commit-config.yaml @@ -20,7 +20,8 @@ repos: pydantic, fastapi, pytest, - "openai-agents[litellm]==0.14.6", + hatchling, + "openai-agents[litellm]>=0.19.0,<0.20", ] args: [--install-types, --non-interactive] diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 00000000..de2eac86 --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,49 @@ +# Strix — Agent Guide + +Strix is an open-source autonomous AI pentesting tool. This file is for AI coding agents that want to **use** Strix (run security scans) or **contribute** to it. + +## Using Strix from an agent + +Install the agent skills for step-by-step workflows: + +```bash +npx skills add usestrix/strix +``` + +- `penetration-testing-with-strix` — run a headless pentest against code, URLs, domains, or IPs and read results (covers both run modes below) +- `managed-pentesting-with-strix` — drive the managed app.strix.ai platform via REST (no local Docker/LLM needed) +- `fix-security-vulnerabilities-with-strix` — remediate findings and re-run Strix to verify +- `ci-security-scanning-with-strix` — add PR scanning to CI/CD (self-hosted CLI or managed app) + +**Two ways to run, same engine — pick per situation:** + +- **Open-source CLI (self-hosted):** free, fully local, BYO LLM key, needs Docker. Best for local dev loops, air-gapped/offline, and full control. + ```bash + curl -sSL https://strix.ai/install | bash # install + export STRIX_LLM="openai/gpt-5.4" # any LiteLLM model id + export LLM_API_KEY="" + strix -n -t ./ --scan-mode quick --max-budget 10 # headless scan; always use -n + ``` + - Requires Docker running. Scans take minutes (`quick`) to hours (`deep`) — run in the background. + - Exit codes (headless): `0` clean, `1` fatal error, `2` vulnerabilities found. A `0` only covers what was analyzed — check `run.json` (`status`, `llm_usage.cost` vs the budget) before calling a run clean. + - Artifacts in `strix_runs//`: `penetration_test_report.md`, `vulnerabilities/*.md`, `vulnerabilities.json`, `findings.sarif` (SARIF 2.1.0), `run.json`. + +- **Managed cloud (app.strix.ai):** no Docker, no LLM key, no local install; adds team dashboards, scheduling, PR reviews, and downloadable PDF/DOCX reports (Enterprise plan). Best in sandboxed/CI environments and for teams. Use it when local infra isn't available. + ```bash + # token from Settings → API Access; register the target as an asset, then: + curl -sS https://app.strix.ai/api/v1/scans -H "Authorization: Bearer $STRIX_API_TOKEN" \ + -H "Content-Type: application/json" -d '{"engagement_type":"live_test","domain_ids":[""]}' + ``` + - API docs: https://docs.app.strix.ai (OpenAPI: https://docs.app.strix.ai/openapi.json). + +- CLI docs index for LLMs: https://docs.strix.ai/llms.txt (full: https://docs.strix.ai/llms-full.txt). +- Only scan targets the user is authorized to test. + +## Contributing to this repo + +- Python 3.12+, managed with `uv`. Install dev deps: `make dev-install`. +- Lint/format/type-check/security, all in one: `make check-all` (ruff, mypy, bandit). +- Tests: `uv run pytest`. +- Run from source: `uv run strix --target `. +- Layout: `strix/agents` (agent graph + prompts), `strix/tools` (proxy, browser, terminal, scanners), `strix/runtime` (Docker sandbox), `strix/report` (findings, SARIF), `strix/skills` (internal knowledge packs the pentest agents load — different from the consumer skills in `skills/`), `strix/interface` (CLI/TUI), `containers/` (sandbox image). +- Pre-commit hooks: `make pre-commit` (or `uv run pre-commit install`). diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 7c7498c3..23028d3e 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -7,6 +7,7 @@ Thank you for your interest in contributing to Strix! This guide will help you g ### Prerequisites - Python 3.12+ +- Latest Go 1.24.x patch (only for Bubble Tea TUI development and release artifacts) - Docker (running) - [uv](https://docs.astral.sh/uv/) (for dependency management) - Git @@ -113,6 +114,22 @@ make viewer # or: cd strix/interface/viewer/frontend && npm ci && npm run buil Commit both the source change and the regenerated `strix/interface/viewer/static/`. +## Package builds + +Editable installs do not need Go; they run the TUI from source (`go run`). + +Wheels always bundle the matching Go sidecar and are platform-specific: + +```bash +make wheel +``` + +The build hook (`scripts/tui_sidecar_hook.py`) compiles the sidecar, embeds it as +`strix/bin/strix-tui`, and assigns the current platform tag. It requires Go +1.24.x or newer and fails rather than producing a wheel without the sidecar. +`scripts/build.sh` and `strix.spec` are likewise strict for frozen PyInstaller +releases. + ## 🤝 Community - **Discord**: [Join our community](https://discord.gg/strix-ai) diff --git a/Makefile b/Makefile index da240367..05038f79 100644 --- a/Makefile +++ b/Makefile @@ -1,4 +1,6 @@ -.PHONY: help install dev-install format lint type-check security check-all clean pre-commit setup-dev dev viewer +.PHONY: help install dev-install format lint type-check security check-all clean pre-commit setup-dev dev viewer wheel tui-build tui-test tui-lint + +TUI_BINARY := build/sidecar/strix-tui$(if $(filter Windows_NT,$(OS)),.exe) help: @echo "Available commands:" @@ -16,7 +18,11 @@ help: @echo "Development:" @echo " pre-commit - Run pre-commit hooks on all files" @echo " viewer - Rebuild the local-viewer SPA (commit the output)" + @echo " wheel - Build a platform wheel with the bundled Go sidecar" @echo " clean - Clean up cache files and artifacts" + @echo " tui-build - Build the Bubble Tea TUI" + @echo " tui-test - Test the Bubble Tea TUI" + @echo " tui-lint - Vet and format-check the Bubble Tea TUI" install: uv sync --no-dev @@ -72,5 +78,18 @@ viewer: cd strix/interface/viewer/frontend && npm ci && npm run build @echo "✅ Viewer built to strix/interface/viewer/static/ (commit the changes)." +wheel: + uv build --wheel + dev: format lint type-check @echo "✅ Development cycle complete!" + +tui-build: + mkdir -p build/sidecar + cd strix/interface/tui && CGO_ENABLED=0 go build -trimpath -ldflags="-s -w" -o ../../../$(TUI_BINARY) ./cmd/strix-tui + +tui-test: + cd strix/interface/tui && go test -race ./... + +tui-lint: + cd strix/interface/tui && test -z "$$(gofmt -l .)" && go vet ./... diff --git a/README.md b/README.md index 982a635d..2e4dfa3e 100644 --- a/README.md +++ b/README.md @@ -108,6 +108,18 @@ Try the Strix full-stack penetration testing platform at **[app.strix.ai](https: --- +## 🤖 Use Strix from Your Coding Agent + +Strix is agent-ready. Give Claude Code, Cursor, Codex, or any [SKILL.md-compatible](https://agentskills.io) agent the ability to run pentests, fix findings, and set up CI scanning: + +```bash +npx skills add usestrix/strix +``` + +This installs four skills: **penetration-testing-with-strix** (run headless scans and read results), **managed-pentesting-with-strix** (drive the managed [app.strix.ai](https://app.strix.ai) platform via REST — no local Docker or LLM key), **fix-security-vulnerabilities-with-strix** (remediate + re-scan to verify), and **ci-security-scanning-with-strix** (PR scanning in CI). Agents can run Strix two ways with the same engine — the open-source CLI locally, or the managed cloud when there's no local infra — and read [`AGENTS.md`](AGENTS.md) for a quick reference, [docs.strix.ai/llms.txt](https://docs.strix.ai/llms.txt) for the CLI docs, and [docs.app.strix.ai](https://docs.app.strix.ai) for the API. + +--- + ## ✨ Features ### Agentic Pentesting Tools @@ -185,6 +197,28 @@ strix --target https://github.com/org/repo strix --target https://your-app.com ``` +### API Testing (OpenAPI / Swagger / Postman) + +Point Strix at an API contract and it tests every declared endpoint instead of +having to discover them by crawling. Pair the spec with the live base URL so the +agent knows where to send traffic: + +```bash +# OpenAPI / Swagger file (.json / .yaml) +strix --target ./openapi.yaml --target https://api.your-app.com + +# Postman collection export +strix --target ./collection.postman_collection.json --target https://api.your-app.com + +# Postman collection pulled live by id (no manual export) +export POSTMAN_API_KEY="PMAK-..." +strix --target postman:// + +# ...with a Postman environment to resolve {{baseUrl}} / token variables +strix --target "postman://?env=" +``` + + ### Advanced Testing Scenarios ```bash @@ -311,10 +345,11 @@ Have questions? Found a bug? Want to contribute? **[Join our Discord!](https://d ## Acknowledgements -Strix builds on the incredible work of open-source projects like [LiteLLM](https://github.com/BerriAI/litellm), [Caido](https://github.com/caido/caido), [Nuclei](https://github.com/projectdiscovery/nuclei), [Playwright](https://github.com/microsoft/playwright), and [Textual](https://github.com/Textualize/textual). Huge thanks to their maintainers! +Strix builds on the incredible work of open-source projects like [LiteLLM](https://github.com/BerriAI/litellm), [Caido](https://github.com/caido/caido), [Nuclei](https://github.com/projectdiscovery/nuclei), [Playwright](https://github.com/microsoft/playwright), and [Bubble Tea](https://github.com/charmbracelet/bubbletea). Huge thanks to their maintainers! > [!WARNING] -> Only test apps you own or have permission to test. You are responsible for using Strix ethically and legally. +> **Authorized use only.** Strix actively tests the targets you point it at, so only run it against systems you own or have **explicit, written permission** to test, and stay within the agreed scope. Unauthorized testing is illegal in most jurisdictions. +> You alone are responsible for obtaining authorization and complying with the law. Strix is provided "as is" with no warranty or liability for misuse. diff --git a/containers/Dockerfile b/containers/Dockerfile index 4b3c84d2..9943266a 100644 --- a/containers/Dockerfile +++ b/containers/Dockerfile @@ -16,7 +16,8 @@ RUN mkdir -p /out/bin && \ go install -v github.com/projectdiscovery/katana/cmd/katana@latest && \ go install -v github.com/projectdiscovery/cvemap/cmd/vulnx@latest && \ go install -v github.com/jaeles-project/gospider@latest && \ - go install -v github.com/projectdiscovery/interactsh/cmd/interactsh-client@latest + go install -v github.com/projectdiscovery/interactsh/cmd/interactsh-client@latest && \ + go install -v golang.org/x/vuln/cmd/govulncheck@latest # --------------------------------------------------------------------------- # Runtime stage @@ -53,6 +54,7 @@ RUN apt-get update && \ nmap ncat ndiff \ sqlmap nuclei subfinder naabu ffuf \ nodejs npm pipx \ + golang-go \ libcap2-bin \ gdb \ libnss3-tools \ diff --git a/containers/docker-entrypoint.sh b/containers/docker-entrypoint.sh index d22cefdf..e4f472d6 100644 --- a/containers/docker-entrypoint.sh +++ b/containers/docker-entrypoint.sh @@ -1,6 +1,22 @@ #!/bin/bash set -e +if [ -n "${STRIX_HOST_UID:-}" ] && [ "${STRIX_HOST_UID}" != "0" ] && [ "${STRIX_HOST_UID}" != "$(id -u)" ]; then + exec sudo -E -- bash -c ' + set -e + gid="${STRIX_HOST_GID:-$STRIX_HOST_UID}" + old_uid="$1" + old_gid="$2" + export PATH="$3" + shift 3 + sed -i "s|^pentester:x:${old_uid}:${old_gid}:|pentester:x:${STRIX_HOST_UID}:${gid}:|" /etc/passwd + sed -i "s|^pentester:x:${old_gid}:|pentester:x:${gid}:|" /etc/group + chown -R "${STRIX_HOST_UID}:${gid}" /home/pentester /app/certs + chown "${STRIX_HOST_UID}:${gid}" /workspace + exec setpriv --reuid "${STRIX_HOST_UID}" --regid "${gid}" --init-groups "$0" "$@" + ' "$0" "$(id -u)" "$(id -g)" "$PATH" "$@" +fi + CAIDO_PORT=48080 CAIDO_LOG="/tmp/caido_startup.log" diff --git a/docs/advanced/configuration.mdx b/docs/advanced/configuration.mdx index fe911907..f1542b75 100644 --- a/docs/advanced/configuration.mdx +++ b/docs/advanced/configuration.mdx @@ -19,6 +19,14 @@ Configure Strix using environment variables or a config file. Custom API base URL. Also accepts `OPENAI_API_BASE`, `LITELLM_BASE_URL`, or `OLLAMA_API_BASE`. + + Extra HTTP headers sent on every LLM request, as a JSON object (e.g. + `{"X-Feature-Key":"value","X-Tenant":"acme"}`). Useful for OpenAI-compatible + gateways that require attribution or routing headers in addition to the bearer + token. The bearer token itself still comes from `LLM_API_KEY`. Applies to both + the LiteLLM and native OpenAI routing paths. + + Request timeout in seconds for LLM calls. @@ -28,7 +36,7 @@ Configure Strix using environment variables or a config file. - Control thinking effort for reasoning models. Valid values: `none`, `minimal`, `low`, `medium`, `high`, `xhigh`. Defaults to `medium` for quick scan mode. + Control thinking effort for reasoning models. Valid values: `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, `max`. Defaults to `medium` for quick scan mode. @@ -55,6 +63,12 @@ affecting the agents that do the actual testing. model runs on a different endpoint than the main model. + + Optional JSON object of extra HTTP headers sent on every deduplication-model + request, e.g. `{"X-Feature-Key":"value"}`. A dedicated dedupe model never + inherits `LLM_EXTRA_HEADERS`; set this when its endpoint needs custom headers. + + Reasoning effort for the deduplication model. Defaults to the model's own baseline when unset. @@ -66,6 +80,10 @@ affecting the agents that do the actual testing. API key for Perplexity AI. Enables real-time web search during scans for OSINT and vulnerability research. + + Postman API key (`PMAK-…`). Enables fetching Postman collections by id as a target (`postman://`), and Postman environments (`postman://?env=`) to resolve collection variables. Not needed when passing a local collection export file. + + Telemetry toggle. Set to `0`, `false`, `no`, or `off` to disable telemetry (PostHog, Scarf, OTEL). @@ -92,7 +110,7 @@ When remote vars are set, Strix dual-writes telemetry to both local JSONL and th ## Docker Configuration - + Docker image to use for the sandbox container. @@ -104,10 +122,6 @@ When remote vars are set, Strix dual-writes telemetry to both local JSONL and th Runtime backend for the sandbox environment. - - Maximum size (in MB) of a local directory target that Strix will copy into the sandbox file-by-file. Larger targets exit early with a suggestion to use `--mount` instead. Set to `0` to disable the check. - - ## Sandbox Configuration diff --git a/docs/advanced/skills.mdx b/docs/advanced/skills.mdx index 8d9ced96..ce624424 100644 --- a/docs/advanced/skills.mdx +++ b/docs/advanced/skills.mdx @@ -68,10 +68,10 @@ Framework-specific testing patterns. Third-party service and platform security. -| Skill | Coverage | -| -------------------- | ---------------------------------- | -| `supabase` | Supabase RLS bypasses, auth issues | -| `firebase_firestore` | Firestore rules, Firebase auth | +| Skill | Coverage | +| ---------- | ------------------------------------------------------ | +| `supabase` | Supabase RLS bypasses, auth issues | +| `firebase` | Firebase Firestore, Storage rules, Auth, and Functions | ### Protocols diff --git a/docs/contributing.mdx b/docs/contributing.mdx index 2d91529d..4d7f8fb2 100644 --- a/docs/contributing.mdx +++ b/docs/contributing.mdx @@ -8,6 +8,7 @@ description: "Contribute to Strix development" ### Prerequisites - Python 3.12+ +- Latest Go 1.24.x patch (only for Bubble Tea TUI development and release artifacts) - Docker (running) - [uv](https://docs.astral.sh/uv/) - Git @@ -74,6 +75,22 @@ Skills are specialized knowledge packages that enhance agent capabilities. They - Small, focused functions - Meaningful variable names +## Package Builds + +Editable installs do not require Go; they run the TUI from source (`go run`). + +Wheels are intentionally strict: they always bundle the matching Go sidecar and +are platform-specific. + +```bash +make wheel +``` + +The build hook (`scripts/tui_sidecar_hook.py`) requires Go 1.24.x or newer, embeds +the sidecar as `strix/bin/strix-tui`, and assigns the current platform tag. +Frozen releases built by `scripts/build.sh` and `strix.spec` also require the +sidecar. + ## Reporting Issues Include: diff --git a/docs/docs.json b/docs/docs.json index 23cf2386..de23c158 100644 --- a/docs/docs.json +++ b/docs/docs.json @@ -46,7 +46,8 @@ "group": "Integrations", "pages": [ "integrations/github-actions", - "integrations/ci-cd" + "integrations/ci-cd", + "integrations/coding-agents" ] }, { diff --git a/docs/integrations/coding-agents.mdx b/docs/integrations/coding-agents.mdx new file mode 100644 index 00000000..fa2cea63 --- /dev/null +++ b/docs/integrations/coding-agents.mdx @@ -0,0 +1,61 @@ +--- +title: "Coding Agents" +description: "Use Strix from Claude Code, Cursor, Codex, and other AI agents" +--- + +Strix is built to be driven by AI coding agents. Install the official agent skills and your agent knows how to run pentests, remediate findings, and wire Strix into CI. + +## Install the Skills + +Works with any agent that supports the open [SKILL.md standard](https://agentskills.io) — Claude Code, Cursor, Codex, Gemini CLI, OpenCode, and dozens more: + +```bash +npx skills add usestrix/strix +``` + +| Skill | What your agent learns | +|-------|------------------------| +| `penetration-testing-with-strix` | Run headless scans against code, URLs, domains, or IPs — self-hosted CLI or managed cloud — with budget caps, and read the results | +| `managed-pentesting-with-strix` | Drive the managed [app.strix.ai](https://app.strix.ai) platform over REST — no local Docker or LLM key needed | +| `fix-security-vulnerabilities-with-strix` | Triage findings, fix root causes, and re-run Strix to verify each fix | +| `ci-security-scanning-with-strix` | Add PR security scanning to GitHub Actions or any CI (self-hosted CLI or managed app) | + +Install a single skill with `npx skills add usestrix/strix --skill penetration-testing-with-strix`, or use one without installing: + +```bash +npx skills use usestrix/strix@penetration-testing-with-strix | claude +``` + +## Two ways to run — self-hosted or managed + +Both use the same engine and produce the same validated findings and SARIF, so agents can pick per situation or combine them: + +- **Open-source CLI (self-hosted)** — runs locally in a Docker sandbox with your own LLM key. Free, fully local, air-gap capable. Best for local dev loops and full control. +- **Managed cloud** — runs on Strix's infrastructure via the [app.strix.ai REST API](https://docs.app.strix.ai). No Docker, no LLM key, no local install; adds team dashboards, scheduling, PR reviews, and downloadable PDF/DOCX reports (Enterprise plan). Best in sandboxed/CI environments and for teams. Create an API token under **Settings → API Access**; the `managed-pentesting-with-strix` skill has the full flow. + +## Agent-Friendly Interfaces + +Everything an agent needs is machine-readable: + +- **Headless CLI** — `strix -n` runs without the TUI and exits with `0` (clean), `1` (error), or `2` (vulnerabilities found). +- **REST API** — the managed platform exposes a documented [OpenAPI](https://docs.app.strix.ai/openapi.json) at `https://app.strix.ai/api/v1` (scans, vulnerabilities, assets, PR reviews, schedules, webhooks) with bearer tokens and scopes. +- **Structured results** — every run writes `vulnerabilities.json`, `vulnerabilities.csv`, `findings.sarif` (SARIF 2.1.0), and per-finding Markdown under `strix_runs//`; the cloud exposes the same as JSON plus SARIF export. +- **Budget controls** — `--max-budget` and `--max-turns` give agents hard cost/time caps. +- **`AGENTS.md`** — the [repository's agent guide](https://github.com/usestrix/strix/blob/main/AGENTS.md) with a quick reference. +- **`llms.txt`** — this documentation is indexed at [docs.strix.ai/llms.txt](https://docs.strix.ai/llms.txt) and fully exported at [docs.strix.ai/llms-full.txt](https://docs.strix.ai/llms-full.txt); every page is also available as Markdown by appending `.md` to its URL. + +## Example Prompts + +Once the skills are installed, prompts like these just work: + +```text +Pentest this repo with Strix (quick mode, $10 budget) and summarize the findings. +``` + +```text +Fix all critical and high findings from the last Strix run, then re-scan to verify. +``` + +```text +Add Strix security scanning to our GitHub Actions so every PR gets tested. +``` diff --git a/docs/llm-providers/local.mdx b/docs/llm-providers/local.mdx index 8a899a5d..58b37509 100644 --- a/docs/llm-providers/local.mdx +++ b/docs/llm-providers/local.mdx @@ -54,3 +54,55 @@ If you use LM Studio, vLLM, or other runners: export STRIX_LLM="openai/local-model" export LLM_API_BASE="http://localhost:1234/v1" # Adjust port as needed ``` + +### Gateways that require custom headers + +Some OpenAI-compatible gateways require extra HTTP headers (for attribution or +tenant routing) alongside the bearer token. Set them with `LLM_EXTRA_HEADERS` as +a JSON object — they are sent on every request: + +```bash +export STRIX_LLM="openai/your-model" +export LLM_API_BASE="https://your-gateway.example/v1" +export LLM_API_KEY="your-bearer-token" # sent as Authorization: Bearer ... +export LLM_EXTRA_HEADERS='{"X-Feature-Key":"value","X-Tenant":"acme"}' +``` + +For endpoints behind a private CA, point Strix at your certificate bundle with +the standard `SSL_CERT_FILE=/path/to/ca-bundle.pem` — never disable TLS +verification against a real endpoint. + +## Tool calling must return structured `tool_calls` + +Strix is entirely tool-driven: every working turn must be a **native** function/tool call. If your inference server returns the tool call as plain assistant text instead of a structured `tool_calls` field, Strix never sees a call it can execute, so the agent makes no real progress — it re-prompts the model for a tool call and gives up once its recovery attempts are exhausted. + +This is almost always an **inference-server configuration** problem, not a model or Strix problem. Common symptoms are the model printing a call as text such as: + +```text +{"name": "exec_command", "arguments": {"cmd": "nmap ..."}} +exec_command(cmd="nmap ...", timeout=180) +{"action": "exec_command", "params": {"cmd": "nmap ..."}} +``` + +The fix belongs on the inference server: it must be configured to parse the model's tool tokens into structured `tool_calls`. A correctly configured endpoint either returns a structured call or rejects the request outright — it never leaks the call as text. + +### Fixes by server + +**llama.cpp (`llama-server`)** +- Run with `--jinja` and a correct tool-use chat template (`--chat-template` / `--chat-template-file` matching the model). Recent builds enable `--jinja` by default — **upgrade** if yours doesn't. +- For thinking models, align or disable reasoning (`--reasoning-format`, `-rea off`) so it doesn't break tool-call parsing. +- A low temperature (e.g. `--temp 0.2`) improves tool-call reliability. + +**Ollama** +- Use a recent Ollama and a model whose template wires tools. Modern Ollama refuses tools (`tools param requires --jinja flag`) if the template lacks tool support. +- For reasoning models (e.g. qwen3), disable the model's **thinking** mode — thinking left on frequently pushes the tool call into the text `content` instead of the structured `tool_calls` field. Turn it off on the Ollama side (a non-thinking model variant, or `think: false` in the model's parameters / `Modelfile`). +- Raise **`num_ctx`** to at least 16k–32k. Strix sends a large system prompt plus many tool schemas; at Ollama's small default context the tool definitions are truncated out of the prompt and the model stops emitting valid calls. A short test prompt can look fine while a real scan fails, so set this explicitly rather than inferring it from a quick check. + +**vLLM** +- Start with `--enable-auto-tool-choice`, a matching `--tool-call-parser` (`hermes`, `qwen3_xml`, or `llama3_json`), and a matching `--reasoning-parser` for reasoning models. + +A low sampling temperature (roughly 0.2–0.6, depending on the family) also measurably reduces malformed tool calls on open-weight models. Set it on the server or in your model's parameters. + + +Even correctly configured, small models (< ~30B) emit malformed or text-form tool calls far more often than frontier models. Prefer a capable model for reliable agentic behavior. + diff --git a/docs/usage/cli.mdx b/docs/usage/cli.mdx index d5acb402..443c2edc 100644 --- a/docs/usage/cli.mdx +++ b/docs/usage/cli.mdx @@ -6,33 +6,29 @@ description: "Command-line options for Strix" ## Basic Usage ```bash -strix (--target | --target-list | --mount ) [options] +strix (--target | --target-list ) [options] ``` ## Options - Target to test. Accepts URLs, repositories, local directories, domains, or IP addresses. Can be specified multiple times. Fresh runs require at least one target source: `--target`, `--target-list`, or `--mount`. + Target to test. Accepts URLs, repositories, local directories, domains, IP addresses, API spec files (OpenAPI/Swagger `.json`/`.yaml`, a Postman collection export), or a live Postman collection by id (`postman://`). Can be specified multiple times. Fresh runs require at least one target source: `--target` or `--target-list`. + + When the target is an API spec, Strix copies it into the agent's workspace and authorizes the base URLs it declares (including those resolved from a Postman environment) as in-scope hosts - so the agent reads the contract and tests the full declared surface instead of discovering endpoints by crawling. Pair the spec with the deployed base URL (e.g. `--target ./openapi.yaml --target https://api.example.com`) so the agent has a reachable host to attack. + + + A local directory is mounted into the sandbox live and **writable**, so the agent edits your real files (`.git` excepted). Commit or stash first. + + + + Fetching a Postman collection by id requires `POSTMAN_API_KEY`. Add `?env=` to also pull a Postman environment, which resolves `{{baseUrl}}` / token variables the collection references (e.g. `postman://?env=`). + Path to a file containing targets, one per non-empty, non-comment line. Lines starting with `#` are ignored. Can be specified multiple times and combined with `--target`. - - Bind-mount a local directory into the sandbox (read-only) instead of copying it in file-by-file. Use this for large repositories that are too big to stream into the container. Can be specified multiple times. - - Strix copies local `--target` directories into the sandbox one file at a time, which stalls on very large trees. When a local target exceeds the copy limit (see `STRIX_MAX_LOCAL_COPY_MB`, default 1024 MB) Strix exits early and asks you to re-run with `--mount`. - - - The mount is read-only to protect your source from accidental modification. This is not a hard security boundary: a root process inside the container can remount it writable, so treat `--mount` as "scan my own code", not as isolation from untrusted code. - - - - The size pre-flight only covers local directory targets. Remote repositories (cloned at scan time) are not size-checked. - - - Custom instructions for the scan. Use for credentials, focus areas, or specific testing approaches. @@ -138,11 +134,14 @@ strix -n --target ./ --scan-mode quick --scope-mode diff --diff-base origin/main # Multi-target white-box testing strix -t https://github.com/org/app -t https://staging.example.com +# API spec + live target (OpenAPI/Swagger file or Postman collection) +strix -t ./openapi.yaml -t https://api.example.com + +# Postman collection pulled live by id (+ optional environment) +strix -t "postman://?env=" + # Targets from a file strix --target-list ./targets.txt - -# Large local repository — bind-mount instead of copying it in -strix --mount ./huge-monorepo ``` ## Exit Codes diff --git a/pyproject.toml b/pyproject.toml index 97b58a31..269a0710 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -1,6 +1,6 @@ [project] name = "strix-agent" -version = "1.4.1" +version = "1.5.1" description = "Open-source AI Hackers for your apps" readme = "README.md" license = "Apache-2.0" @@ -33,14 +33,13 @@ classifiers = [ "Programming Language :: Python :: 3.14", ] dependencies = [ - "openai-agents[litellm]==0.14.6", - "openai>=2.26.0,<2.45", + "openai-agents[litellm]>=0.19.0,<0.20", + "openai>=2.45.0,<3", "litellm", "pydantic>=2.11.3", "pydantic-settings>=2.13.0", "rich", "docker>=7.1.0", - "textual>=6.0.0", "requests>=2.32.0", "cvss>=3.2", "caido-sdk-client>=0.2.0", @@ -49,6 +48,7 @@ dependencies = [ # Cap <49: 49.x drops the universal2 macOS wheel (arm64-only), which breaks # the Intel macOS (macos-x86_64) release build's `uv sync --frozen`. "cryptography>=48.0.1,<49", + "pyyaml>=6.0", ] [project.optional-dependencies] @@ -68,6 +68,7 @@ dev = [ "pyinstaller>=6.17.0; python_version >= '3.12' and python_version < '3.15'", "pytest>=8.3", "pytest-asyncio>=0.24", + "types-requests>=2.32", ] [tool.pytest.ini_options] @@ -82,7 +83,19 @@ packages = ["strix"] # The prebuilt viewer bundle under strix/interface/viewer/static/ ships automatically # (hatchling includes non-.py files under the package). The Vite SOURCE lives # under the package dir too (strix/interface/viewer/frontend/) but must never ship in the wheel. -exclude = ["strix/interface/viewer/frontend", "strix/interface/viewer/frontend/**"] +exclude = [ + "strix/interface/viewer/frontend", + "strix/interface/viewer/frontend/**", + # Go TUI SOURCE lives under the package dir but must never ship in the wheel; + # the compiled sidecar is force-included as strix/bin/strix-tui instead. + "strix/interface/tui/cmd/**", + "strix/interface/tui/internal/**", + "strix/interface/tui/go.mod", + "strix/interface/tui/go.sum", +] + +[tool.hatch.build.targets.wheel.hooks.custom] +path = "scripts/tui_sidecar_hook.py" # ============================================================================ # Type Checking Configuration @@ -115,13 +128,13 @@ module = [ "litellm.*", "rich.*", "jinja2.*", - "textual.*", "cvss.*", "docker.*", "caido_sdk_client.*", "pydantic_settings.*", "reportlab.*", "pypdf.*", + "yaml.*", "pygments.*", ] ignore_missing_imports = true @@ -218,9 +231,16 @@ ignore = [ "tests/test_viewer_auth.py" = ["S105", "S106", "ARG001"] "tests/test_codex_auth.py" = ["S105", "S106", "SLF001"] "tests/test_grok_auth.py" = ["S105", "S106", "SLF001"] +# Hatchling loads the build hook by path, not as an importable package. +"scripts/tui_sidecar_hook.py" = ["INP001"] # Stdlib HTTP handler overrides (do_GET/do_POST). "strix/interface/auth_cli.py" = ["N802"] "tests/test_codex_streaming.py" = ["N802"] +"tests/test_disable_streaming.py" = ["N802"] +"tests/test_tool_call_ids.py" = ["N802"] +"tests/test_tool_call_limits.py" = ["N802", "SLF001"] +"tests/test_stream_idle_timeout.py" = ["N802", "SLF001"] +"tests/test_unknown_tool_recovery.py" = ["N802"] "tests/test_report_pdf.py" = ["S105", "S106"] # Stdlib HTTP handler overrides (do_GET/do_POST) and lazy imports that avoid a # circular dependency with strix.telemetry / strix.interface.viewer.report_pdf. @@ -281,9 +301,15 @@ ignore = [ # CLI / TUI / main keep extensive lazy imports + broad exception # swallows for resilience around terminal-rendering errors. "strix/interface/cli.py" = ["BLE001", "PLC0415"] -"strix/interface/tui/app.py" = ["BLE001", "PLC0415", "PLR0912", "PLR0915", "SIM105"] +"strix/interface/scan_setup.py" = ["PLC0415"] "strix/interface/main.py" = ["BLE001", "PLC0415", "PLR0912", "PLR0915"] -"strix/interface/tui/renderers/agent_message_renderer.py" = ["PLC0415"] +"strix/interface/cli_args.py" = ["BLE001", "PLC0415", "PLR0912", "PLR0915"] +"strix/interface/environment.py" = ["BLE001", "PLC0415", "PLR0912", "PLR0915"] +# The Go TUI runtime and backend controller import interface modules lazily so +# the sidecar entry point stays fast and avoids circular imports. +"strix/interface/interactive.py" = ["PLC0415"] +"strix/interface/tui/runtime.py" = ["PLC0415"] +"strix/interface/tui/backend/controller.py" = ["PLC0415"] [tool.ruff.lint.isort] force-single-line = false diff --git a/scripts/build.sh b/scripts/build.sh index 66fd066f..6a6c29e3 100755 --- a/scripts/build.sh +++ b/scripts/build.sh @@ -39,6 +39,12 @@ if ! command -v uv &> /dev/null; then exit 1 fi +if ! command -v go &> /dev/null; then + echo -e "${RED}Error: Go is not installed${NC}" + echo "Go 1.24 or newer is required to build the Bubble Tea TUI." + exit 1 +fi + echo -e "\n${BLUE}Installing dependencies...${NC}" uv sync --frozen @@ -48,6 +54,14 @@ echo -e "${YELLOW}Version:${NC} $VERSION" echo -e "\n${BLUE}Cleaning previous builds...${NC}" rm -rf build/ dist/ +echo -e "\n${BLUE}Building Bubble Tea sidecar...${NC}" +TUI_BINARY="build/sidecar/strix-tui" +if [ "$OS_NAME" = "windows" ]; then + TUI_BINARY="${TUI_BINARY}.exe" +fi +mkdir -p build/sidecar +(cd strix/interface/tui && CGO_ENABLED=0 go build -trimpath -ldflags="-s -w" -o "../../../$TUI_BINARY" ./cmd/strix-tui) + echo -e "\n${BLUE}Building binary with PyInstaller...${NC}" uv run pyinstaller strix.spec --noconfirm diff --git a/scripts/install.sh b/scripts/install.sh index cacbd9cb..5e2e8a71 100755 --- a/scripts/install.sh +++ b/scripts/install.sh @@ -4,7 +4,7 @@ set -euo pipefail APP=strix REPO="usestrix/strix" -STRIX_IMAGE="ghcr.io/usestrix/strix-sandbox:1.1.0" +STRIX_IMAGE="ghcr.io/usestrix/strix-sandbox:1.3.0" MUTED='\033[0;2m' RED='\033[0;31m' diff --git a/scripts/tui_sidecar_hook.py b/scripts/tui_sidecar_hook.py new file mode 100644 index 00000000..800aa778 --- /dev/null +++ b/scripts/tui_sidecar_hook.py @@ -0,0 +1,58 @@ +"""Hatchling build hook that compiles and bundles the Go TUI sidecar.""" + +from __future__ import annotations + +import os +import shutil +import subprocess +import sysconfig +from pathlib import Path +from typing import Any + +from hatchling.builders.hooks.plugin.interface import BuildHookInterface + + +class CustomBuildHook(BuildHookInterface[Any]): + """Compile the Bubble Tea sidecar and ship it inside the wheel. + + The sidecar is the only interactive interface, so every wheel is a + platform wheel and a missing Go toolchain is a build failure. + """ + + def initialize(self, version: str, build_data: dict[str, Any]) -> None: + # Editable installs run from the checkout, where the TUI is started + # with ``go run``; there is nothing to bundle. + if version == "editable": + return + + root = Path(self.root) + executable = "strix-tui.exe" if os.name == "nt" else "strix-tui" + output = root / "build" / "sidecar" / executable + output.parent.mkdir(parents=True, exist_ok=True) + + go = shutil.which("go") + if go is None: + raise RuntimeError("Go 1.24 or newer is required to build the Bubble Tea TUI") + env = os.environ.copy() + env["CGO_ENABLED"] = "0" + subprocess.run( # noqa: S603 - fixed build command using the resolved Go binary + [ + go, + "build", + "-trimpath", + "-ldflags=-s -w", + "-o", + str(output), + "./cmd/strix-tui", + ], + cwd=root / "strix" / "interface" / "tui", + env=env, + check=True, + ) + + build_data["force_include"][str(output)] = f"strix/bin/{executable}" + build_data["pure_python"] = False + platform_tag = os.environ.get("STRIX_WHEEL_PLATFORM_TAG") + if not platform_tag: + platform_tag = sysconfig.get_platform().replace("-", "_").replace(".", "_") + build_data["tag"] = f"py3-none-{platform_tag}" diff --git a/skills/ci-security-scanning-with-strix/SKILL.md b/skills/ci-security-scanning-with-strix/SKILL.md new file mode 100644 index 00000000..10ed88ba --- /dev/null +++ b/skills/ci-security-scanning-with-strix/SKILL.md @@ -0,0 +1,136 @@ +--- +name: ci-security-scanning-with-strix +description: Add security scanning to CI/CD with Strix — GitHub Actions, GitLab CI, or any pipeline — so every pull request gets a diff-scoped AI pentest that blocks vulnerable code before it merges, with results as PR comments and SARIF uploaded to code scanning. Covers both the self-hosted open-source CLI (runs in your runner) and the managed app.strix.ai platform (GitHub/GitLab app or API, no runner infra). Use when the user asks to add security scanning, SAST/DAST, pentesting, vulnerability checks, or automated security review to their CI pipeline, pre-merge gate, or PR workflow. +license: Apache-2.0 +metadata: + author: usestrix + homepage: https://docs.strix.ai +--- + +# Set up Strix in CI/CD + +You can gate PRs two ways — pick based on the environment, or combine them: + +- **Managed platform (recommended for most teams)** — connect the GitHub/GitLab/Bitbucket app once and Strix reviews every PR with **no workflow file, no runner, no Docker, and no LLM key**. Results post as PR comments and land in the team dashboard. Best when you want zero CI maintenance, central tracking, or your runners lack Docker. See "Managed platform" below and the **managed-pentesting-with-strix** skill. +- **Self-hosted OSS CLI in your runner** — run a diff-scoped scan as a pipeline step. Fully in your infra, free (BYO LLM key), no external account. Requires Docker on the runner. Best for air-gapped/self-hosted CI or when you don't want scans leaving your environment. + +Both fail the build on validated findings and both emit SARIF 2.1.0, so you can start with one and add the other later. + +--- + +# Option A — Self-hosted OSS CLI in the runner + +Run a diff-scoped Strix scan on every PR: only changed files are tested, `quick` mode keeps it fast, and exit code `2` fails the build when validated vulnerabilities are found. + +## GitHub Actions + +Create `.github/workflows/security.yml`: + +```yaml +name: Security Scan + +on: + pull_request: + +jobs: + strix-scan: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v4 + with: + fetch-depth: 0 # required for diff-scope resolution + + - name: Install Strix + run: curl -sSL https://strix.ai/install | bash + + - name: Run Security Scan + env: + STRIX_LLM: ${{ secrets.STRIX_LLM }} + LLM_API_KEY: ${{ secrets.LLM_API_KEY }} + run: strix -n -t ./ --scan-mode quick --max-budget 10 + + # Don't fail open: a run that hits the hard budget stop exits 0 but leaves + # run.json status "stopped", not "completed". Enforce completion explicitly. + # This does not catch an agent that wrapped up early on a budget *warning* + # (it still calls finish_scan and records "completed"), so size the budget. + - name: Fail unless the scan completed + run: | + run_json=$(ls -t strix_runs/*/run.json | head -1) + status=$(jq -r .status "$run_json") + if [ "$status" != "completed" ]; then + echo "Strix run status is '$status' — the scan did not complete (likely budget exhausted). Raise --max-budget." >&2 + exit 1 + fi +``` + +Then tell the user to add two repository secrets: `STRIX_LLM` (model id, e.g. `openai/gpt-5.4`) and `LLM_API_KEY` (the provider key). Do not create these values yourself. + +Notes: +- In CI/headless runs Strix automatically scopes to the PR's changed files (`--scope-mode auto`). If diff resolution fails, keep `fetch-depth: 0` or set `--diff-base` to the PR's actual base branch — use `origin/${{ github.base_ref }}` in GitHub Actions rather than a hard-coded `origin/main`, since repos use different default branches. +- Exit codes: `0` pass, `2` vulnerabilities found (fails the job), `1` setup error. +- The runner needs Docker (default GitHub-hosted Ubuntu runners have it). +- **Size the budget so the scan completes — don't let it fail open.** A `0` exit means "no validated vulnerabilities in what was analyzed"; if `--max-budget` is hit before the diff is fully covered, the scan wraps up early and can still exit `0`. The "Fail unless the scan completed" step above narrows the gap: `strix_runs//run.json` is `"stopped"` when the scan was cut off at the hard budget limit without a final report. It is not a complete guard — the agents get graduated wrap-up warnings before that limit, and a run that wraps up on a warning still calls `finish_scan` and records `"completed"` with partial coverage. So keep that step in any pipeline that gates merges **and** give the scan real headroom (compare `run.json`'s `llm_usage.cost` against `--max-budget`; if it ran right up to the cap, raise it). For a `quick` diff-scoped PR scan `--max-budget 10` is usually ample, raise it for large diffs. + +### Optional: upload findings to GitHub code scanning + +Strix writes SARIF 2.1.0 to `strix_runs//findings.sarif`: + +```yaml + - name: Upload SARIF + if: always() + uses: github/codeql-action/upload-sarif@v3 + with: + sarif_file: strix_runs +``` + +## Other CI systems + +Any pipeline works the same way — install, set the two env vars, run headless: + +```bash +curl -sSL https://strix.ai/install | bash +# Resolve the PR's base branch robustly (use your CI's base-branch variable if it +# has one, e.g. GitHub Actions: origin/${{ github.base_ref }}). Avoid piping the +# git lookup into another command — a failed lookup would otherwise be masked. +BASE_BRANCH="${CI_MERGE_REQUEST_TARGET_BRANCH_NAME:-}" # GitLab MR target +if [ -z "$BASE_BRANCH" ]; then + BASE_BRANCH=$(git symbolic-ref --quiet --short refs/remotes/origin/HEAD 2>/dev/null) + BASE_BRANCH="${BASE_BRANCH#origin/}" +fi +DIFF_BASE="origin/${BASE_BRANCH:-main}" +# Fail loudly rather than silently narrowing scope (e.g. to HEAD~1, which on a +# multi-commit branch would scan only the last commit and let earlier ones pass). +if ! git rev-parse --verify --quiet "$DIFF_BASE" >/dev/null; then + echo "Cannot resolve diff base '$DIFF_BASE'. Fetch the base branch (git fetch origin ) or set --diff-base explicitly." >&2 + exit 1 +fi +strix -n -t ./ --scan-mode quick --scope-mode diff --diff-base "$DIFF_BASE" --max-budget 10 +``` + +Gate the pipeline on the exit code (see the budget/fail-open caveat above — give the scan enough budget to finish). Schedule `standard` scans nightly and `deep` scans for release candidates. + +--- + +# Option B — Managed platform (no runner infra) + +No workflow file, no Docker, no LLM key. Two ways to use it: + +1. **PR-review app (zero code):** the user installs the Strix GitHub/GitLab/Bitbucket app and enables PR reviews for the repo in the app.strix.ai dashboard. Every PR is then reviewed automatically, with findings posted as PR comments. Nothing to add to the repo. This is the lowest-effort path — recommend it first when the user just wants PR gating. + +2. **API-triggered from any pipeline:** if you want to trigger from an existing pipeline (or a system without the SCM app), call the API with a token that has `pr_reviews:write` (or `scans:write`). Store the token as a CI secret; ask the user to create it at **Settings → API Access**. Example GitHub Actions step: + + ```yaml + - name: Strix PR review (managed) + if: github.event_name == 'pull_request' + env: + STRIX_API_TOKEN: ${{ secrets.STRIX_API_TOKEN }} + run: | + curl -sS --fail https://app.strix.ai/api/v1/pr-reviews/start \ + -H "Authorization: Bearer $STRIX_API_TOKEN" \ + -H "Content-Type: application/json" \ + -d "{\"repository_full_name\":\"${{ github.repository }}\",\"pr_number\":${{ github.event.pull_request.number }}}" + ``` + + To gate the build on results, poll the PR review / scan status and fail on unresolved criticals/highs. Full endpoints (PR reviews, scans, SARIF export, schedules for scheduled deep scans) are in the **managed-pentesting-with-strix** skill. + +Recommend Option B for most teams (no maintenance, central dashboard); use Option A when scans must stay entirely within your own infrastructure. diff --git a/skills/fix-security-vulnerabilities-with-strix/SKILL.md b/skills/fix-security-vulnerabilities-with-strix/SKILL.md new file mode 100644 index 00000000..5e3ad0c7 --- /dev/null +++ b/skills/fix-security-vulnerabilities-with-strix/SKILL.md @@ -0,0 +1,77 @@ +--- +name: fix-security-vulnerabilities-with-strix +description: Fix security vulnerabilities found by a Strix pentest (open-source CLI or app.strix.ai cloud) — triage by severity, patch the root cause rather than the symptom, and re-run Strix to prove each fix actually closes the exploit. Handles injection, XSS, SSRF, broken access control, IDOR, and other validated findings. Use after a Strix scan reports findings, or when the user asks to remediate, patch, or fix security issues from a strix_runs report, vulnerabilities.json, findings.sarif, or a cloud scan. +license: Apache-2.0 +metadata: + author: usestrix + homepage: https://docs.strix.ai +--- + +# Fix Strix findings and verify + +Turn validated Strix findings into minimal, correct fixes — and prove they work by re-scanning. + +## 1. Triage + +Get the findings from wherever the scan ran: + +- **OSS CLI** — artifacts in `strix_runs//`: + - `vulnerabilities/*.md` — one finding per file: description, severity, PoC steps or script, affected code locations, remediation guidance. + - `vulnerabilities.json` — the same findings as JSON (ids, severity, CWE/CVE, `code_locations` with `fix_before`/`fix_after` suggestions when available). +- **Cloud (app.strix.ai)** — fetch the scan's `vulnerabilities[]` via `GET /api/v1/scans/{scanId}` (or `GET /api/v1/vulnerabilities` org-wide). Each carries `severity, cwe, endpoint, method, impact, technical_analysis, poc_description, poc_script_code` and, for code findings, `code_file`/`code_diff`/`code_before`/`code_after`. See the **managed-pentesting-with-strix** skill for auth. + +Order work by severity: critical → high → medium → low. Every Strix finding was validated with a working proof-of-concept, so do not dismiss findings as false positives without re-testing the PoC yourself. + +## 2. Fix + +For each finding: + +1. Reproduce it with the PoC from the finding file when feasible. +2. Fix the root cause, not the specific payload (e.g. parameterize all queries, don't blocklist one string; enforce authorization in the handler, don't hide the endpoint). +3. Prefer the framework's built-in defense (ORM parameterization, template auto-escaping, CSRF middleware, centralized authz) over ad-hoc sanitization. +4. Keep the diff minimal and apply the repo's existing patterns. Finding files often include `fix_before`/`fix_after` snippets — use them as a starting point, not verbatim. + +Common finding classes and expected fixes: injection → parameterization/escaping at the sink; IDOR/broken access control → object-level authorization checks; SSRF → allowlist + block internal ranges; XSS → context-aware output encoding + CSP; secrets exposure → rotate the secret AND remove it from code/history; auth issues → fix the server-side check (never client-side). + +## 3. Verify by re-running Strix + +After fixing, re-scan scoped to the fixed area and confirm the finding is gone. Verify in whichever environment you scanned (or both): + +**OSS CLI:** +```bash +# Re-test just the changed files (fast). Resolve the repo's real default +# branch instead of assuming origin/main (many repos use master/develop). +# Avoid the current branch's own upstream as the base — its merge base with +# HEAD would be HEAD, giving an empty diff and a falsely clean result. +DIFF_BASE=$(git symbolic-ref --quiet --short refs/remotes/origin/HEAD 2>/dev/null) +# origin/HEAD can be a dangling symbolic ref — keep it only if its target exists. +git rev-parse --verify --quiet "$DIFF_BASE" >/dev/null 2>&1 || DIFF_BASE="" +if [ -z "$DIFF_BASE" ]; then + for b in origin/main origin/master origin/develop; do + git rev-parse --verify --quiet "$b" >/dev/null && DIFF_BASE="$b" && break + done +fi +# No silent fallback: a guess like HEAD~1 would cover only the last commit of a +# multi-commit fix branch. If no base resolves, ask the user for the base branch +# (or use the focused --instruction verification below, which needs no diff base). +[ -n "$DIFF_BASE" ] || { echo "Set DIFF_BASE to the branch your fix will merge into." >&2; exit 1; } +strix -n -t ./ --scan-mode quick --scope-mode diff --diff-base "$DIFF_BASE" --max-budget 5 + +# Or re-test with the original finding as focus (no diff base needed) +strix -n -t ./ --instruction "Verify the SQL injection in app/api/search.py is fixed. Original PoC: " --max-budget 5 +``` +Exit codes: `2` = findings remain (read the new `strix_runs//vulnerabilities/` and iterate); `0` = clean **for what was analyzed**. Before trusting a `0`, confirm the run wasn't cut short — check `run.json` for a completed status and compare its `llm_usage.cost` with `--max-budget`: a hard budget stop leaves `status: "stopped"`, but a run that wrapped up on a budget warning records `"completed"` with partial coverage. Give verification enough budget to finish, and prefer re-running the specific PoC as the ground-truth signal. + +**Cloud:** rerun with the same config and re-poll, then confirm the finding no longer appears: +```bash +new_id=$(curl -sS "$BASE/scans/$scan_id/rerun" "${auth[@]}" -X POST | jq -r .scan_id) +# poll GET /scans/$new_id until completed, then check its vulnerabilities[] +``` +Or, if the cloud scan came from a repo/PR, trigger a fresh PR review on the fix branch (`POST /pr-reviews/start`). The platform also retests a single finding directly: `POST /api/v1/vulnerabilities/{vulnerabilityId}/retest`. + +- Also re-run the PoC manually when it is a simple request/script — fastest signal. +- Run the project's own test suite to make sure the fix doesn't break behavior. + +## 4. Report + +Summarize per finding: severity, root cause, fix applied (file:line), verification result (re-scan clean / PoC no longer reproduces). Never include live secrets in the report; if a secret leaked, state that rotation is required. diff --git a/skills/managed-pentesting-with-strix/SKILL.md b/skills/managed-pentesting-with-strix/SKILL.md new file mode 100644 index 00000000..f2f01c19 --- /dev/null +++ b/skills/managed-pentesting-with-strix/SKILL.md @@ -0,0 +1,152 @@ +--- +name: managed-pentesting-with-strix +description: Run a managed pentest of a web app or API through the app.strix.ai REST API — no local Docker, LLM key, or install needed. Create an API token, register domain/repository assets, launch and poll scans, triage vulnerabilities, export SARIF, download PDF/DOCX pentest reports for SOC 2 and other compliance evidence (Enterprise plan), start PR reviews, and set up schedules and webhooks. Use when the user wants continuous or scheduled pentesting-as-a-service, an auditor-ready pentest report, scans tracked in a team dashboard, or security testing from a sandboxed agent/CI environment with no infrastructure. +license: Apache-2.0 +metadata: + author: usestrix + homepage: https://docs.app.strix.ai +--- + +# Strix Cloud API (managed, no local infra) + +Use this when you want Strix's autonomous pentesting **without running Docker or an LLM yourself** — the scan runs on Strix's infrastructure and results are tracked in a team dashboard. This is the right choice in sandboxed/hosted agent and CI environments, for teams, and for scheduled/continuous testing (downloadable PDF/DOCX reports are an Enterprise-plan feature). For fully local, free, air-gapped, or BYO-LLM runs, use the open-source CLI in the **penetration-testing-with-strix** skill instead — both share the same engine and SARIF output, so you can mix them. + +Full reference: **[docs.app.strix.ai](https://docs.app.strix.ai)** · OpenAPI: `https://docs.app.strix.ai/openapi.json` + +## Setup + +- **Base URL:** `https://app.strix.ai/api/v1` +- **Auth:** every request sends `Authorization: Bearer `. Tokens are **org-scoped**. +- **Get a token:** the user creates one in the dashboard at **Settings → API Access** (app.strix.ai). Ask them for it; never hardcode, log, or commit it. Store it in an env var or the CI secret store. +- **Scopes (least-privilege):** assign only what the integration needs and rotate regularly: + + | Scope | Grants | + |---|---| + | `scans:read` / `scans:write` | list/read/report scans · create/rerun/cancel scans | + | `vulnerabilities:read` / `:write` | read findings · update status & notes | + | `assets:read` / `:write` | read domains/repos · register/update them | + | `schedules:read` / `:write` | read schedules · create/trigger recurring scans | + | `pr_reviews:write` | trigger PR security reviews | + | `webhooks:read` / `:write` | manage webhook subscriptions | + | `tokens:write` | create/revoke API tokens | + +```bash +export STRIX_API_TOKEN="" +BASE=https://app.strix.ai/api/v1 +auth=(-H "Authorization: Bearer $STRIX_API_TOKEN") +``` + +All examples use `jq` to parse JSON. Handle HTTP errors: `401` bad/expired token, `402` out of credits, `403` scope/plan-tier limit, `422` validation error. + +## 1. Register the target as an asset + +Scans run against **registered assets**, not raw URLs. Register once, then reuse the returned UUID. + +```bash +# Domain (black-box / live target). Requires domain verification before external scanning. +# asset_type must be one of: web_app | api | attack_surface. +curl -sS "$BASE/domains" "${auth[@]}" -H "Content-Type: application/json" \ + -d '{"domain":"staging.example.com","asset_type":"web_app"}' | jq '{id:.domain.id, status, reachable, verification}' + +# Repository (white-box / code review). `full_name` is "owner/name". +# Send one repository object, or a bare JSON array for several — not an object +# wrapping a "repositories" key (that is rejected with 400). +curl -sS "$BASE/repositories" "${auth[@]}" -H "Content-Type: application/json" \ + -d '[{"full_name":"org/app","provider":"github"}]' | jq '.repositories[] | {id, full_name}' +``` + +Look up existing assets instead of re-adding: `GET /domains`, `GET /repositories` (both `assets:read`, paginated with `?page=&limit=`). + +## 2. Launch a scan + +`POST /scans` (`scans:write`). Provide at least one target via `domain_ids`, `repository_ids`, or `internal_targets` (internal infra needs a network connector — see docs). + +```bash +scan_id=$(curl -sS "$BASE/scans" "${auth[@]}" -H "Content-Type: application/json" -d '{ + "engagement_type": "live_test", + "domain_ids": [""], + "focus": "IDOR, auth bypass, SSRF", + "context": "Staging. Test account creds are configured as a test user.", + "notify_on_completion": true +}' | jq -r .scan_id) +echo "$scan_id" +``` + +Useful `CreateScanRequest` fields: + +| Field | Purpose | +|---|---| +| `engagement_type` | `live_test` (default), `code_review`, `internal_infra`, `compliance_pentest` | +| `domain_ids` / `repository_ids` / `internal_targets` | targets (at least one) | +| `domain_paths` / `repository_branches` | narrow to specific paths / branches | +| `credentials` | authenticated scanning, incl. `mfa_method` (`totp`/`email_otp`/…) + `totp_secret` | +| `headers` | extra HTTP headers (e.g. API keys) for the target | +| `focus` / `concerns` / `context` | steer the agents | +| `upload_ids` | attach uploaded source/docs archives for white-box context | +| `notify_on_completion` / `notification_emails` | email when done | + +Response is `{ scan_id, title, status }` with `status` = `pending`. + +## 3. Poll to completion + +`GET /scans/{scanId}` (`scans:read`). Status flow: `pending → running → completed` (or `failed` / `cancelled`). Poll on an interval — scans take minutes to hours; don't block. + +```bash +while :; do + s=$(curl -sS "$BASE/scans/$scan_id" "${auth[@]}" | jq -r .status) + echo "status=$s"; [[ "$s" =~ ^(completed|failed|cancelled)$ ]] && break + sleep 60 +done +``` + +## 4. Read findings + +The scan-detail response includes `executive_summary`, `methodology`, `recommendations`, a `findings` severity roll-up, and a `vulnerabilities[]` array. Each vulnerability carries `title, severity, status, cvss, cwe, endpoint, method, impact, technical_analysis, poc_description, poc_script_code`, and (for code findings) `code_file`/`code_diff`/`code_before`/`code_after`. + +```bash +curl -sS "$BASE/scans/$scan_id" "${auth[@]}" \ + | jq '["critical","high","medium","low","info"] as $order + | .vulnerabilities + | sort_by(.severity as $s | $order | index($s)) + | .[] | {title, severity, endpoint, cwe}' +``` + +Cloud severities are `critical | high | medium | low` and statuses are `open | in_progress | fixed | ignored`. Sort by an explicit severity order rather than `sort_by(.severity)`, which sorts alphabetically (critical, high, low, medium). + +Org-wide triage across scans: `GET /vulnerabilities` (`vulnerabilities:read`; filter by severity/status). Update triage state with the vulnerabilities `:write` endpoints. To remediate, hand off to the **fix-security-vulnerabilities-with-strix** skill. + +## 5. Export & report + +```bash +# SARIF 2.1.0 for GitHub code scanning / ASPM ingestion +curl -sS "$BASE/scans/$scan_id/sarif" "${auth[@]}" -o findings.sarif + +# Report. The format and file type are query params (`Accept` is ignored): +# format=technical (default) | retest | attestation | executive_summary +# type=pdf (default) | docx +# Any report download requires the Enterprise plan; formats beyond `technical`, +# DOCX, and white-label branding are Enterprise-only too. Scan must be completed. +curl -sS "$BASE/scans/$scan_id/report?format=technical&type=pdf" "${auth[@]}" -o strix-report.pdf +``` + +## 6. PR reviews + +Trigger an automated security review of a pull request (`pr_reviews:write`); results appear as PR comments and in the dashboard: + +```bash +curl -sS "$BASE/pr-reviews/start" "${auth[@]}" -H "Content-Type: application/json" \ + -d '{"repository_full_name":"org/app","pr_number":123}' +``` + +List/inspect via `GET /pr-reviews` and `GET /pr-reviews/{id}`. Repo-level PR-review behavior is configured with the repository-settings endpoint. + +## 7. Continuous testing (schedules & webhooks) + +- **Schedules** (`schedules:write`, Pro plan): create recurring scans and trigger them on demand — the managed equivalent of a cron-driven CLI loop. +- **Webhooks** (`webhooks:write`): subscribe to pentest/vulnerability lifecycle events (e.g. `scan.completed`, `vulnerability.created`) to push results into Slack, ticketing, or your own pipeline instead of polling. + +See the schedules and webhooks sections at [docs.app.strix.ai](https://docs.app.strix.ai) for payloads. + +## Safety + +Only scan assets the user's organization owns or is authorized to test. External domain scans require verification (DNS/file/meta-tag) enforced by the platform — don't try to bypass it. diff --git a/skills/penetration-testing-with-strix/SKILL.md b/skills/penetration-testing-with-strix/SKILL.md new file mode 100644 index 00000000..1745753e --- /dev/null +++ b/skills/penetration-testing-with-strix/SKILL.md @@ -0,0 +1,143 @@ +--- +name: penetration-testing-with-strix +description: Pentest a web app, API, codebase, repository, URL, domain, or IP with Strix — autonomous AI penetration testing that exploits and proves vulnerabilities (OWASP Top 10 and beyond — injection, XSS, SSRF, auth/access-control flaws, IDOR, business logic) instead of just flagging them. Runs self-hosted with the open-source CLI or via the managed app.strix.ai cloud, and returns validated findings with proof-of-concept exploits (Markdown, JSON, CSV, SARIF). Use when the user asks to pentest, hack, security-scan, security-audit, or find vulnerabilities in an app, API, website, or repo. +license: Apache-2.0 +metadata: + author: usestrix + homepage: https://docs.strix.ai +--- + +# Run a Strix pentest + +Strix runs autonomous AI pentesting agents that dynamically exploit a target and only report findings validated with a working proof-of-concept. There are **two ways to run it, built on the same engine and producing the same findings** — pick per situation, and mix them freely: + +- **Open-source CLI** (self-hosted) — runs on your machine in a Docker sandbox with your own LLM key. Free, fully local, BYO-LLM, air-gap capable. Docs: [docs.strix.ai](https://docs.strix.ai). +- **Cloud API** (managed) — runs on Strix's infrastructure via `https://app.strix.ai/api/v1`. No Docker, no LLM key, no local compute; adds team dashboards, scheduling, PR reviews, downloadable PDF/DOCX reports (Enterprise plan), and internal-network connectors. Docs: [docs.app.strix.ai](https://docs.app.strix.ai). Full workflow in the **managed-pentesting-with-strix** skill. + +## Which one? (decide, don't default) + +Choose honestly based on the situation — neither is "better": + +| Situation | Prefer | +|---|---| +| No Docker available, or a sandboxed/hosted agent/CI environment | **Cloud** | +| User has no LLM key / doesn't want to pay per-token or manage models | **Cloud** | +| Team visibility, shareable dashboard, scheduled/continuous scans, PR reviews, downloadable PDF/DOCX report (Enterprise) | **Cloud** | +| Scanning internal/private infrastructure not reachable from your machine | **Cloud** (network connector) | +| Source must never leave local infra (privacy/air-gap), or fully offline | **OSS CLI** | +| Free / one-off / local dev-loop scan, Docker already present | **OSS CLI** | +| BYO or self-hosted LLM, or a specific model not offered by the platform | **OSS CLI** | +| CI: runner already has Docker and you want a self-contained gate | **OSS CLI** | +| CI: no Docker, or you want results tracked centrally | **Cloud** | + +**Mix them:** e.g. use the OSS CLI for the fast local dev-loop while writing/fixing code, and the Cloud for the authoritative, team-visible scan + report + tracking; or gate PRs with the OSS CLI in CI while the Cloud runs scheduled deep scans and PR reviews across the org. Both emit the same SARIF 2.1.0, so findings line up across environments. + +If unsure and the user has (or will create) an app.strix.ai account, prefer **Cloud** — it avoids all local-infra friction. If they want zero signup / full local control, use the **OSS CLI**. + +--- + +# Option A — Open-source CLI (self-hosted) + +## Prerequisites + +1. **Docker running** — check with `docker info`. The first scan pulls the sandbox image automatically. +2. **Strix installed** — check with `strix --version`. Install if missing: + ```bash + curl -sSL https://strix.ai/install | bash # or: pipx install strix-agent + ``` +3. **LLM configured** — two environment variables: + ```bash + export STRIX_LLM="openai/gpt-5.4" # any LiteLLM model id (openai/..., anthropic/..., openrouter/...) + export LLM_API_KEY="" + ``` + Ask the user for these if unset. Never hardcode or commit keys. + +## Running a scan + +Always use `-n` (non-interactive/headless) — the default TUI blocks agents. Always set `--max-budget` unless the user says otherwise. + +```bash +# Local code (white-box) +strix -n -t ./ --scan-mode standard --max-budget 10 + +# Deployed app / API (black-box) +strix -n -t https://staging.example.com --max-budget 20 + +# Repo + deployed app together (best coverage) +strix -n -t https://github.com/org/app -t https://staging.example.com + +# Focused testing with credentials or scope hints +strix -n -t https://app.example.com \ + --instruction "Use credentials user@example.com:pass123. Focus on IDOR and auth bypass." + +# Large monorepo: bind-mount instead of copying +strix -n --mount ./huge-monorepo +``` + +Key flags: + +| Flag | Meaning | +|---|---| +| `-t, --target` | URL, repo URL, local path, domain, or IP. Repeatable. | +| `-n, --non-interactive` | Headless, exits on completion. Required for agents. | +| `-m, --scan-mode` | `quick` (minutes) / `standard` (~30 min) / `deep` (hours, default). | +| `--instruction` / `--instruction-file` | Credentials, focus areas, scope rules. | +| `--max-budget USD` | Hard LLM spend cap; scan wraps up cleanly at the limit. | +| `--max-turns N` | Per-agent turn cap (default 500). | +| `--resume RUN_NAME` | Resume a prior run from `strix_runs/`. | + +Scans take minutes (`quick`) to hours (`deep`). Run them in the background and poll for completion rather than blocking. + +### Exit codes (headless) + +- `0` — finished with no validated vulnerabilities **in what was analyzed** +- `1` — fatal error (missing env vars, Docker down, bad config) +- `2` — vulnerabilities found + +A `0` is not proof of full coverage: if `--max-budget`/`--max-turns` is reached before the scan completes, it wraps up early and still exits `0`. When you need assurance the scan finished, give it enough budget and check `strix_runs//run.json`: a hard budget stop leaves `status: "stopped"`, but an agent that wrapped up early on a budget *warning* still calls `finish_scan` and records `"completed"` — so also sanity-check the run's cost against `--max-budget` and the report's stated coverage before treating a clean result as full coverage. + +### Reading results + +Artifacts land in `strix_runs//`: + +| File | Contents | +|---|---| +| `penetration_test_report.md` | Executive report — read this first. | +| `vulnerabilities/*.md` | One file per validated finding, with PoC and remediation. | +| `vulnerabilities.json` / `vulnerabilities.csv` | All findings as structured JSON / CSV index. | +| `findings.sarif` | SARIF 2.1.0 for GitHub code scanning / ASPM ingestion. | +| `run.json` | Run metadata, status, targets, usage/cost. | + +--- + +# Option B — Cloud API (managed, no local infra) + +Full details, asset registration, polling, reports, PR reviews, schedules, and webhooks are in the **managed-pentesting-with-strix** skill. Minimal launch-and-poll: + +```bash +export STRIX_API_TOKEN="" # org-scoped bearer, from Settings → API Access at app.strix.ai +BASE=https://app.strix.ai/api/v1 + +# 1. Launch a scan against an already-registered domain/repo asset +scan_id=$(curl -sS "$BASE/scans" \ + -H "Authorization: Bearer $STRIX_API_TOKEN" -H "Content-Type: application/json" \ + -d '{"engagement_type":"live_test","domain_ids":[""]}' | jq -r .scan_id) + +# 2. Poll until terminal (pending → running → completed/failed/cancelled) +curl -sS "$BASE/scans/$scan_id" -H "Authorization: Bearer $STRIX_API_TOKEN" | jq '.status' + +# 3. Read validated findings from the scan detail's `vulnerabilities[]`, or export SARIF +curl -sS "$BASE/scans/$scan_id/sarif" -H "Authorization: Bearer $STRIX_API_TOKEN" -o findings.sarif +``` + +Ask the user to create the token (and register the target as a domain/repository asset) if they haven't. If Docker/local prerequisites aren't already satisfied, use this path instead of trying to install infra. + +--- + +## Reporting & next steps + +Summarize findings by severity (critical/high/medium/low/info) and include the PoC evidence. To remediate and verify fixes (via either path), use the **fix-security-vulnerabilities-with-strix** skill. To wire scanning into CI/CD, use the **ci-security-scanning-with-strix** skill. + +## Safety + +Only scan targets the user owns or is authorized to test. The Cloud platform enforces domain verification before external scans; for the OSS CLI, confirm authorization yourself if the target looks like third-party infrastructure. diff --git a/strix.spec b/strix.spec index 19e39b37..827e5e2c 100644 --- a/strix.spec +++ b/strix.spec @@ -7,6 +7,14 @@ from PyInstaller.utils.hooks import collect_data_files, collect_submodules project_root = Path(SPECPATH) strix_root = project_root / 'strix' +tui_name = 'strix-tui.exe' if sys.platform == 'win32' else 'strix-tui' +tui_binary = project_root / 'build' / 'sidecar' / tui_name +if not tui_binary.is_file(): + raise FileNotFoundError( + f'Missing Go TUI sidecar at {tui_binary}; run `make tui-build` first' + ) +binaries = [(str(tui_binary), 'strix/bin')] + datas = [] for md_file in strix_root.rglob('skills/**/*.md'): @@ -21,10 +29,6 @@ for xml_file in strix_root.rglob('*.xml'): rel_path = xml_file.relative_to(project_root) datas.append((str(xml_file), str(rel_path.parent))) -for tcss_file in strix_root.rglob('*.tcss'): - rel_path = tcss_file.relative_to(project_root) - datas.append((str(tcss_file), str(rel_path.parent))) - # Prebuilt local-viewer SPA (served by `strix view`). viewer_static = strix_root / 'interface' / 'viewer' / 'static' for asset in viewer_static.rglob('*'): @@ -32,8 +36,6 @@ for asset in viewer_static.rglob('*'): rel_path = asset.relative_to(project_root) datas.append((str(asset), str(rel_path.parent))) -datas += collect_data_files('textual') - datas += collect_data_files('tiktoken') datas += collect_data_files('tiktoken_ext') @@ -52,17 +54,6 @@ hiddenimports = [ 'litellm.utils', 'litellm.caching', - # Textual TUI - 'textual', - 'textual.app', - 'textual.widgets', - 'textual.containers', - 'textual.screen', - 'textual.binding', - 'textual.reactive', - 'textual.css', - 'textual._text_area_theme', - # Rich console 'rich', 'rich.console', @@ -125,28 +116,21 @@ hiddenimports = [ 'strix.interface.main', 'strix.interface.cli', 'strix.interface.tui', - 'strix.interface.tui.app', + 'strix.interface.tui.runtime', 'strix.interface.tui.history', 'strix.interface.tui.live_view', - 'strix.interface.tui.messages', - 'strix.interface.tui.renderers', - 'strix.interface.tui.renderers.agent_message_renderer', - 'strix.interface.tui.renderers.agents_graph_renderer', - 'strix.interface.tui.renderers.base_renderer', - 'strix.interface.tui.renderers.finish_renderer', - 'strix.interface.tui.renderers.notes_renderer', - 'strix.interface.tui.renderers.proxy_renderer', - 'strix.interface.tui.renderers.registry', - 'strix.interface.tui.renderers.reporting_renderer', - 'strix.interface.tui.renderers.thinking_renderer', - 'strix.interface.tui.renderers.todo_renderer', - 'strix.interface.tui.renderers.user_message_renderer', - 'strix.interface.tui.renderers.web_search_renderer', + 'strix.interface.tui.backend', + 'strix.interface.tui.backend.controller', + 'strix.interface.tui.backend.messages', + 'strix.interface.tui.backend.protocol', + 'strix.interface.tui.backend.server', 'strix.interface.utils', 'strix.agents', 'strix.agents.factory', 'strix.agents.prompt', - 'strix.config.models', + 'strix.config.loader', + 'strix.config.settings', + 'strix.config.codex', 'strix.core', 'strix.core.agents', 'strix.core.execution', @@ -196,7 +180,6 @@ hiddenimports = [ ] hiddenimports += collect_submodules('litellm') -hiddenimports += collect_submodules('textual') hiddenimports += collect_submodules('rich') hiddenimports += collect_submodules('pydantic') hiddenimports += collect_submodules('pygments') @@ -263,7 +246,7 @@ excludes = [ a = Analysis( ['strix/interface/main.py'], pathex=[str(project_root)], - binaries=[], + binaries=binaries, datas=datas, hiddenimports=hiddenimports, hookspath=[], diff --git a/strix/agents/factory.py b/strix/agents/factory.py index 5d922b19..e40e60e8 100644 --- a/strix/agents/factory.py +++ b/strix/agents/factory.py @@ -23,7 +23,7 @@ from strix.tools.agents_graph.tools import ( send_message_to_agent, stop_agent, view_agent_graph, - wait_for_message, + wait_for_agents, ) from strix.tools.finish.tool import finish_scan from strix.tools.load_skill.tool import load_skill @@ -49,6 +49,7 @@ from strix.tools.reporting.tool import ( get_report, list_reports, ) +from strix.tools.respond.tool import respond_to_user from strix.tools.thinking.tool import think from strix.tools.todo.tools import ( create_todo, @@ -142,6 +143,83 @@ def _with_bounded_result(tool: FunctionTool) -> FunctionTool: return tool +def _schema_types(spec: dict[str, Any]) -> set[str]: + types: set[str] = set() + raw = spec.get("type") + if isinstance(raw, str): + types.add(raw) + elif isinstance(raw, list): + types.update(t for t in raw if isinstance(t, str)) + for variant in spec.get("anyOf") or (): + if isinstance(variant, dict): + types |= _schema_types(variant) + types.discard("null") + return types + + +def _decode_structured(value: str, types: set[str]) -> Any: + stripped = value.strip() + if not stripped: + return value + try: + decoded = json.loads(stripped) + except json.JSONDecodeError: + return value + wanted = list if "array" in types else dict + return decoded if isinstance(decoded, wanted) else value + + +def _coerce_argument(value: Any, spec: dict[str, Any]) -> Any: + types = _schema_types(spec) + if not types or value is None: + return value + if isinstance(value, list | dict) and "string" in types and not types & {"array", "object"}: + return json.dumps(value, ensure_ascii=False) + if isinstance(value, str) and types & {"array", "object"} and "string" not in types: + return _decode_structured(value, types) + return value + + +def _coerce_arguments(raw_input: str, schema: dict[str, Any]) -> str: + properties = schema.get("properties") + if not isinstance(properties, dict) or not properties: + return raw_input + try: + payload = json.loads(raw_input) if raw_input else None + except json.JSONDecodeError: + return raw_input + if not isinstance(payload, dict): + return raw_input + + changed = False + for key, value in payload.items(): + spec = properties.get(key) + if not isinstance(spec, dict): + continue + coerced = _coerce_argument(value, spec) + if coerced is not value: + payload[key] = coerced + changed = True + + if not changed: + return raw_input + return json.dumps(payload, ensure_ascii=False) + + +def _with_coerced_arguments(tool: FunctionTool) -> FunctionTool: + if getattr(tool, "_strix_coerced", False): + return tool + invoke_tool = tool.on_invoke_tool + schema = tool.params_json_schema + + async def invoke(ctx: Any, raw_input: str) -> Any: + return await invoke_tool(ctx, _coerce_arguments(raw_input, schema)) + + tool.on_invoke_tool = invoke + tool._strix_coerced = True # type: ignore[attr-defined] + return tool + + def _function_tool_with_error_result(tool: FunctionTool) -> FunctionTool: invoke_tool = tool.on_invoke_tool @@ -211,11 +289,13 @@ def _configure_filesystem_tools(toolset: Any, *, chat_completions: bool) -> None if isinstance(tool, CustomTool): setattr(toolset, name, _custom_tool_as_function_tool(tool)) elif isinstance(tool, FunctionTool): - setattr(toolset, name, _function_tool_with_error_result(tool)) + setattr( + toolset, name, _function_tool_with_error_result(_with_coerced_arguments(tool)) + ) elif isinstance(tool, CustomTool): setattr(toolset, name, _bound_custom_tool(tool)) elif isinstance(tool, FunctionTool): - setattr(toolset, name, _with_bounded_result(tool)) + setattr(toolset, name, _with_bounded_result(_with_coerced_arguments(tool))) def _make_filesystem_configurator(*, chat_completions: bool) -> Any: @@ -328,7 +408,7 @@ def _configure_shell_tools(toolset: Any, *, chat_completions: bool) -> None: for name, tool in vars(toolset).items(): if not isinstance(tool, FunctionTool): continue - wrapped = tool + wrapped = _with_coerced_arguments(tool) if tool.name == "exec_command": wrapped = _wrap_exec_command(wrapped) elif tool.name == "write_stdin": @@ -345,6 +425,10 @@ def _make_shell_configurator(*, chat_completions: bool) -> Any: return configure +# Tools that hand control away by parking the agent rather than ending the scan. +_PARKING_TOOLS: frozenset[str] = frozenset({"respond_to_user", "wait_for_agents"}) + + def _lifecycle_tool_completed(tool_name: str, output: Any) -> bool: if tool_name == "agent_finish": completion_key = "agent_completed" @@ -363,7 +447,7 @@ def _lifecycle_tool_completed(tool_name: str, output: Any) -> bool: def _wait_tool_parked(tool_name: str, output: Any) -> bool: - if tool_name != "wait_for_message" or not isinstance(output, str): + if tool_name not in _PARKING_TOOLS or not isinstance(output, str): return False try: parsed = json.loads(output) @@ -425,7 +509,7 @@ _BASE_TOOLS: tuple[Tool, ...] = ( scope_rules, view_agent_graph, send_message_to_agent, - wait_for_message, + wait_for_agents, create_agent, stop_agent, ) @@ -475,7 +559,7 @@ def registered_agent_tools() -> tuple[Tool, ...]: def build_strix_agent( *, - name: str = "strix", + name: str = "agent", skills: list[str] | None = None, is_root: bool, scan_mode: str = "deep", @@ -509,13 +593,19 @@ def build_strix_agent( ) agent_tools = [*_EXTRA_TOOLS, *(extra_tools or [])] + if interactive: + # Yielding to the user is only meaningful when one is attached. + agent_tools.append(respond_to_user) if is_root: tools: list[Tool] = [*_BASE_TOOLS, *agent_tools, finish_scan] else: tools = [*_BASE_TOOLS, *agent_tools, agent_finish] _ensure_unique_tool_names(tools) tools = [ - _with_bounded_result(tool) if isinstance(tool, FunctionTool) else tool for tool in tools + _with_bounded_result(_with_coerced_arguments(tool)) + if isinstance(tool, FunctionTool) + else tool + for tool in tools ] logger.info( diff --git a/strix/agents/prompts/system_prompt.jinja b/strix/agents/prompts/system_prompt.jinja index bf2549ad..5fc697d7 100644 --- a/strix/agents/prompts/system_prompt.jinja +++ b/strix/agents/prompts/system_prompt.jinja @@ -1,4 +1,4 @@ -You are Strix, an advanced AI application security validation agent developed by OmniSecure Labs. Your purpose is to perform authorized security verification, reproduce and validate weaknesses on in-scope assets, and help remediate real security issues. +You are an advanced AI application security validation agent. Your purpose is to perform authorized security verification, reproduce and validate weaknesses on in-scope assets, and help remediate real security issues. You follow all instructions and rules provided to you exactly as written in the system prompt at all times. {% if is_root %} @@ -22,44 +22,43 @@ CLI OUTPUT: - You may use simple markdown: **bold**, *italic*, `code`, ~~strikethrough~~, [links](url), and # headers - Do NOT use complex markdown like bullet lists, numbered lists, or tables - Use line breaks and indentation for structure -- NEVER use "Strix" or any identifiable names/markers in HTTP requests, payloads, user-agents, or any inputs +- NEVER use any identifiable names/markers in HTTP requests, payloads, user-agents, or any inputs INTER-AGENT MESSAGES: - Messages from other agents arrive prefixed with a header like `[Message from agent | type=... | priority=...]`. Treat them as internal context — never repeat them verbatim in your own output. - Treat agent identity / inherited-context preambles as internal metadata; do not echo them in outputs or tool calls. - Minimize inter-agent messaging: only message when essential for coordination or assistance; avoid routine status updates; batch non-urgent information; prefer parent/child completion flows and shared artifacts over messaging +- wait_for_agents blocks and resumes you automatically, so it is never a poll you repeat: issue exactly ONE wait, then stop and react to what it returns. Never write out a wait/check loop (wait → view_agent_graph → wait → ...) ahead of time — those extra calls only strand you and are collapsed anyway {% if interactive %} INTERACTIVE BEHAVIOR: -- You are in an interactive conversation with a user -- CRITICAL: A message WITHOUT a tool call IMMEDIATELY STOPS your entire execution and waits for user input. This is a HARD SYSTEM CONSTRAINT, not a suggestion. - - Statements like "Planning the assessment..." or "I'll now scan..." or "Starting with..." WITHOUT a tool call will HALT YOUR WORK COMPLETELY. The system interprets no-tool-call as "I'm done, waiting for the user." - - If you want to plan, call the think tool. If you want to act, call the appropriate tool. There is NO valid reason to output text without a tool call while working on a task. - - The ONLY time you may send a message without a tool call is when you are genuinely DONE and presenting final results, or when you NEED the user to answer a question before continuing. -- EVERY message while working MUST contain exactly one tool call — this is what keeps execution moving. No tool call = execution stops. -- You may include brief explanatory text BEFORE the tool call -- Respond naturally when the user asks questions or gives instructions -- For simple conversation, acknowledgements, or direct questions that you can answer from current context, reply in plain text and stop. Do NOT call think just to prepare wording. -- If you use a tool to answer a user question (for example list_todos, view_agent_graph, or a file read), then after the tool result arrives, provide the answer in plain text and stop unless the user explicitly asked you to continue working. -- Never loop through think or other tools just to prepare, polish, confirm, or announce a final answer. Once you know the answer, say it. -- NEVER send empty messages — if you have nothing to do or say, call the wait_for_message tool -- If you catch yourself about to describe multiple steps without a tool call, STOP and call the think tool instead +- You are in an interactive conversation with a user. +- HOW EXECUTION ENDS: your turn ends ONLY when you make an explicit lifecycle tool call. Plain text NEVER ends your turn and NEVER hands control to the user — text is shown to the user, and then execution continues. + - To answer the user and hand control back, call respond_to_user. It delivers your message AND parks you for their reply in one call, so there is no way to answer and then forget to stop. This is the ONLY way to yield to the user. + - To wait on another AGENT (a child's report, a peer's reply), call wait_for_agents. That is not a way to reach the user. + - To end the whole engagement, call the lifecycle tool: finish_scan (root) or agent_finish (subagent). + - A turn that ends with plain text and no tool call does NOT stop you: the system nudges you to continue and will re-run you. Do not rely on going silent to pause — it will not pause you. +- Answering a user question: put the answer in respond_to_user's message. Do not write the answer as plain text and then fall silent — that does not reach a stopping point, it just triggers a continuation nudge. +- You may include brief explanatory text before a tool call, and you can narrate while you work — plain text is shown to the user as you go. Narrating is free; respond_to_user is specifically the act of WAITING for the user, so do not call it just to give a status update. +- Respond naturally when the user asks questions or gives instructions. +- While actively working on a task, every turn should carry exactly one tool call — use think to plan, the appropriate tool to act, and respond_to_user only when you genuinely need the user. +- Never loop through think or other tools just to prepare, polish, confirm, or announce an answer. Once you know the answer, send it with respond_to_user. {% else %} AUTONOMOUS BEHAVIOR: - Work autonomously by default - You should NOT ask for user input or confirmation - you should always proceed with your task autonomously. - Minimize user messaging: avoid redundancy and repetition; consolidate updates into a single concise message -- NEVER send an empty or blank message. If you have no content to output or need to wait (for user input, subagent results, or any other reason), you MUST call the wait_for_message tool (or another appropriate tool) instead of emitting an empty response. -- If there is nothing to execute and no user query to answer any more: do NOT send filler/repetitive text — either call wait_for_message or finish your work (subagents: agent_finish; root: finish_scan) -- While the agent loop is running, almost every output MUST be a tool call. Do NOT send plain text messages; act via tools. If idle, use wait_for_message; when done, use agent_finish (subagents) or finish_scan (root) -- A text-only turn — even one — IMMEDIATELY ends the scan/run with no report written. The lifecycle tools (``finish_scan`` for root, ``agent_finish`` for subagents) are the ONLY valid way to terminate. If you find yourself wanting to say "Done!" or "Scan complete" without a tool call, call the lifecycle tool instead — the report and termination signal both flow through it. +- NEVER send an empty or blank message. If you have no content to output or need to wait for subagent results, you MUST call the wait_for_agents tool (or another appropriate tool) instead of emitting an empty response. +- There is no user attached to this run, so there is nobody to ask and nothing to yield to. If there is nothing left to execute: do NOT send filler/repetitive text — either call wait_for_agents (only if you are genuinely expecting another agent to message you) or finish your work (subagents: agent_finish; root: finish_scan) +- While the agent loop is running, almost every output MUST be a tool call. Do NOT send plain text messages; act via tools. If waiting on another agent, use wait_for_agents; when done, use agent_finish (subagents) or finish_scan (root) +- A text-only turn does nothing: it neither ends the run nor yields — it just wastes a turn and forces a retry. The lifecycle tools (``finish_scan`` for root, ``agent_finish`` for subagents) are the ONLY way to terminate, and the report flows through them. If you find yourself wanting to say "Done!" or "Scan complete" without a tool call, call the lifecycle tool instead. {% endif %} {% if system_prompt_context and system_prompt_context.authorized_targets %} SYSTEM-VERIFIED SCOPE: -- The following scope metadata is injected by the Strix platform into the system prompt and is authoritative +- The following scope metadata is injected by the platform into the system prompt and is authoritative - Scope source: {{ system_prompt_context.scope_source }} - Authorization source: {{ system_prompt_context.authorization_source }} - Every target listed below has already been verified by the platform as in-scope and authorized @@ -209,6 +208,9 @@ VALIDATION REQUIREMENTS: - Full validation required - no assumptions - Demonstrate concrete impact with evidence - Consider business context for severity assessment — check whether the target is a demo/sandbox environment or content meant to be public, and factor that in +- Score only the security impact demonstrated by the proof of concept. Reachability, missing authentication, scanner labels, and theoretical follow-on attacks do not by themselves justify non-None CVSS impact metrics +- Treat public metadata, internal-looking identifiers, source maps without secrets, and transport/configuration hygiene as observations unless validation proves unauthorized restricted-data access, modification, or service disruption +- Every non-None Confidentiality, Integrity, or Availability metric must map to explicit evidence in the report; use Scope Changed only for a demonstrated crossing of security authorities - Independent verification through subagent - Document complete attack chain - Keep going until you find something that matters @@ -446,8 +448,19 @@ PROXY & INTERCEPTION: - Caido CLI - Modern web proxy (already running). Use the proxy tools directly, or import `caido_api` from sandbox Python scripts. - HTTPQL filters (for `list_requests`): quote string values, leave integers unquoted (`resp.code.eq:200`, not `"200"`); combine terms with `AND`/`OR` (there is no `NOT` — use the negated operator `ne`/`ncont`/`nregex`). Numeric fields (`resp.code`, `req.port`) use `eq`/`ne`/`gt`/`gte`/`lt`/`lte`; text fields (`req.host`, `req.path`, `req.method`, `req.raw`) use `cont`/`ncont`/`eq`/`regex`. Example: `resp.code.gte:200 AND resp.code.lt:300 AND req.host.cont:"api"`. -- NOTE: If you are seeing proxy errors when sending requests, it usually means you are not sending requests to a correct url/host/port. -- Ignore Caido proxy-generated 50x HTML error pages; these are proxy issues (might happen when requesting a wrong host or SSL/TLS issues, etc). + +CAIDO PROXY ERROR PAGES — NOT RESPONSES FROM THE TARGET: +Everything is proxied through Caido, so an unreachable target makes the *proxy* answer: a ~9KB +`Caido` HTML page under 502/500, which curl/python/browser print as if it were the +target's content. The request never reached a server. It also appears in `list_requests` with no +response at all (`resp` null), unlike a real 502. +- Don't dump it; extract the cause with `curl -s ... | grep -A8 'c-title"'`. +- The `c-details` cause says what to fix: "Failed to query DNS" — host doesn't resolve, check + `dig +short `, then correct or drop it; "Connection refused" — nothing on that port, check + `nc -z -v `; "TLS handshake"/"wrong version number" — scheme/port mismatch, flip + http/https; timeout — filtered or unreachable from the sandbox. +- NEVER treat these as target behavior: not a finding, not evidence, not a WAF, not a server + error. Fix the url/host/port/scheme and retry, or move on — do not keep re-requesting a dead host. PROGRAMMING: - Python 3, uv, Node.js/npm @@ -477,8 +490,10 @@ Default user: pentester (sudo available) On-demand specialist skills. Spawn a specialist via `create_agent(skills=[...])`, or pull guidance inline for yourself via `load_skill(skills=[...])`. Anything wrapped in `` above is already loaded for you. -{% for category, names in available_skills | dictsort -%} -- {{ category }}: {{ names | join(', ') }} +{% for category, skills in available_skills | dictsort -%} +{% for skill in skills -%} +- {{ category }}/{{ skill.name }}{% if skill.description %}: {{ skill.description }}{% endif %} +{% endfor -%} {% endfor -%} {% endif %} diff --git a/strix/config/codex.py b/strix/config/codex.py index d6741205..edd268a3 100644 --- a/strix/config/codex.py +++ b/strix/config/codex.py @@ -187,19 +187,23 @@ def _first(query: dict[str, list[str]], key: str) -> str | None: def _post_form(payload: dict[str, str]) -> dict[str, Any]: + detail = "" try: - response = requests.post( + with requests.post( TOKEN_URL, data=payload, headers={"Accept": "application/json"}, timeout=_TOKEN_TIMEOUT, - ) + ) as response: + status_code = response.status_code + body = response.content + if status_code >= 400: + detail = response.text[:300] except requests.RequestException as exc: raise CodexAuthError("unavailable", str(exc)) from exc - if response.status_code >= 400: - detail = response.text[:300] - raise CodexAuthError("token_http_error", f"HTTP {response.status_code}: {detail}") - data = json.loads(response.content or b"{}") + if status_code >= 400: + raise CodexAuthError("token_http_error", f"HTTP {status_code}: {detail}") + data = json.loads(body or b"{}") if not isinstance(data, dict): raise CodexAuthError("bad_response", "token endpoint returned non-object") return data diff --git a/strix/config/loader.py b/strix/config/loader.py index 5b940760..fbcde898 100644 --- a/strix/config/loader.py +++ b/strix/config/loader.py @@ -2,7 +2,6 @@ from __future__ import annotations -import contextlib import json import logging import os @@ -12,6 +11,7 @@ from typing import TYPE_CHECKING, Any from pydantic import AliasChoices, BaseModel from strix.config.settings import Settings +from strix.utils.secret_files import write_secret_text if TYPE_CHECKING: @@ -71,9 +71,7 @@ def persist_current() -> None: env_block[alias.upper()] = value break - target.write_text(json.dumps({"env": env_block}, indent=2), encoding="utf-8") - with contextlib.suppress(OSError): - target.chmod(0o600) + write_secret_text(target, json.dumps({"env": env_block}, indent=2)) def _aliases_for(finfo: FieldInfo) -> list[str]: diff --git a/strix/config/models.py b/strix/config/models.py index ee8d0d68..19c78eb4 100644 --- a/strix/config/models.py +++ b/strix/config/models.py @@ -2,10 +2,14 @@ from __future__ import annotations +import asyncio import contextlib import inspect +import logging import os -from typing import TYPE_CHECKING, Any +import time +from collections.abc import AsyncGenerator +from typing import TYPE_CHECKING, Any, cast from agents import ( set_default_openai_api, @@ -13,6 +17,8 @@ from agents import ( set_tracing_disabled, ) from agents.model_settings import ModelSettings +from agents.models.fake_id import FAKE_RESPONSES_ID +from agents.models.interface import Model from agents.models.multi_provider import MultiProvider from agents.models.openai_chatcompletions import OpenAIChatCompletionsModel from agents.models.openai_responses import OpenAIResponsesModel @@ -22,19 +28,38 @@ from agents.retry import ( RetryPolicyContext, retry_policies, ) +from openai.types.responses import ( + Response, + ResponseCompletedEvent, + ResponseOutputItemAddedEvent, + ResponseOutputItemDoneEvent, +) +from openai.types.responses.response_usage import ResponseUsage from openai.types.shared import Reasoning from strix.config import codex, grok from strix.config.loader import load_settings +from strix.config.tool_call_ids import TurnCallIdRewriter, dedupe_input +from strix.config.tool_call_limits import TurnToolCallLimiter if TYPE_CHECKING: from collections.abc import AsyncIterator - from agents.models.interface import Model, ModelProvider + from agents.agent_output import AgentOutputSchemaBase + from agents.handoffs import Handoff + from agents.items import ModelResponse, TResponseInputItem, TResponseStreamEvent + from agents.models.interface import ModelProvider, ModelTracing + from agents.retry import ModelRetryAdvice, ModelRetryAdviceRequest + from agents.tool import Tool + from agents.usage import Usage from openai import AsyncOpenAI + from openai.types.responses.response_prompt_param import ResponsePromptParam - from strix.config.settings import ReasoningEffort, Settings + from strix.config.settings import LlmSettings, ReasoningEffort, Settings + + +logger = logging.getLogger(__name__) def request_timeout_extra_args(timeout_s: float | None) -> dict[str, float] | None: @@ -72,10 +97,13 @@ class _CodexResponsesModel(OpenAIResponsesModel): effort = self._reasoning_effort if effort and effort != "none": # Clamp to efforts the backend accepts. - if effort == "minimal": - effort = "low" - elif effort == "xhigh": - effort = "high" + match effort: + case "minimal": + effort = "low" + case "xhigh" | "max": + effort = "high" + case _: + pass overrides = overrides.resolve(ModelSettings(reasoning=Reasoning(effort=effort))) return model_settings.resolve(overrides) @@ -136,6 +164,288 @@ class _CodexResponsesModel(OpenAIResponsesModel): await result +class _NonStreamingModel(Model): + """Serve the SDK's streamed run loop from a single non-streaming request. + + Some OpenAI-compatible gateways do not support Server-Sent Events, or + deliver them unreliably (dropping structured tool-call deltas, or stalling + mid-stream so the whole turn waits out the read timeout). The SDK run loop + Strix uses only issues streamed requests, so such a gateway fails every + turn. Opt in with ``LLM_DISABLE_STREAMING=true`` to wrap the resolved model + so each turn makes one non-streaming ``get_response`` (``stream:false`` on + the wire) and the completed result is replayed as a single terminal stream + event. The run loop then executes tools and emits run items from that final + response exactly as it would for a real stream, so nothing else changes. + """ + + def __init__(self, inner: Model) -> None: + self._inner = inner + + async def close(self) -> None: + await self._inner.close() + + def get_retry_advice(self, request: ModelRetryAdviceRequest) -> ModelRetryAdvice | None: + return self._inner.get_retry_advice(request) + + async def get_response( + self, + system_instructions: str | None, + input: str | list[TResponseInputItem], # noqa: A002 + model_settings: ModelSettings, + tools: list[Tool], + output_schema: AgentOutputSchemaBase | None, + handoffs: list[Handoff], + tracing: ModelTracing, + *, + previous_response_id: str | None, + conversation_id: str | None, + prompt: ResponsePromptParam | None, + ) -> ModelResponse: + return await self._inner.get_response( + system_instructions, + input, + model_settings, + tools, + output_schema, + handoffs, + tracing, + previous_response_id=previous_response_id, + conversation_id=conversation_id, + prompt=prompt, + ) + + async def stream_response( + self, + system_instructions: str | None, + input: str | list[TResponseInputItem], # noqa: A002 + model_settings: ModelSettings, + tools: list[Tool], + output_schema: AgentOutputSchemaBase | None, + handoffs: list[Handoff], + tracing: ModelTracing, + *, + previous_response_id: str | None, + conversation_id: str | None, + prompt: ResponsePromptParam | None, + ) -> AsyncIterator[TResponseStreamEvent]: + response = await self._inner.get_response( + system_instructions, + input, + model_settings, + tools, + output_schema, + handoffs, + tracing, + previous_response_id=previous_response_id, + conversation_id=conversation_id, + prompt=prompt, + ) + yield _completed_stream_event(response, getattr(self._inner, "model", None)) + + +class _TurnGuardModel(Model): + """Keep one turn from corrupting the conversation or running away. + + Tool-call ids: providers that number calls per turn (``exec_command:0``, + ...) restart the counter each turn, so the same id eventually appears twice + in one conversation and strict providers reject every subsequent request. + Ids that collide with the history are rewritten before the turn is + recorded, and already-corrupted histories are repaired on the way out. + + Tool-call volume: a degenerate response can queue hundreds of calls that + the run loop then honours one by one. Only the first + ``LLM_MAX_TOOL_CALLS_PER_TURN`` calls of a response are kept. + + Stalled streams: a turn that emits a few tokens and then goes silent is + not covered by the request timeout, which resets on any byte (keepalives + included). ``LLM_STREAM_IDLE_TIMEOUT`` bounds the gap between events so the + turn fails instead of hanging, and the existing retry path replays it. + """ + + def __init__( + self, + inner: Model, + *, + max_tool_calls_per_turn: int = 0, + stream_idle_timeout: float = 0.0, + ) -> None: + self._inner = inner + self._max_tool_calls_per_turn = max_tool_calls_per_turn + self._stream_idle_timeout = stream_idle_timeout + + def _limiter(self) -> TurnToolCallLimiter: + return TurnToolCallLimiter(self._max_tool_calls_per_turn) + + def _log_dropped(self, limiter: TurnToolCallLimiter) -> None: + if limiter.dropped: + logger.warning( + "dropped %d tool call(s) past the per-response limit of %d", + limiter.dropped, + self._max_tool_calls_per_turn, + ) + + async def close(self) -> None: + await self._inner.close() + + def get_retry_advice(self, request: ModelRetryAdviceRequest) -> ModelRetryAdvice | None: + return self._inner.get_retry_advice(request) + + async def get_response( + self, + system_instructions: str | None, + input: str | list[TResponseInputItem], # noqa: A002 + model_settings: ModelSettings, + tools: list[Tool], + output_schema: AgentOutputSchemaBase | None, + handoffs: list[Handoff], + tracing: ModelTracing, + *, + previous_response_id: str | None, + conversation_id: str | None, + prompt: ResponsePromptParam | None, + ) -> ModelResponse: + sanitized = dedupe_input(input) + rewriter = TurnCallIdRewriter(sanitized) + response = await self._inner.get_response( + system_instructions, + cast("str | list[TResponseInputItem]", sanitized), + model_settings, + tools, + output_schema, + handoffs, + tracing, + previous_response_id=previous_response_id, + conversation_id=conversation_id, + prompt=prompt, + ) + limiter = self._limiter() + response.output = limiter.filter_items(rewriter.rewrite_items(list(response.output))) + self._log_dropped(limiter) + return response + + async def stream_response( + self, + system_instructions: str | None, + input: str | list[TResponseInputItem], # noqa: A002 + model_settings: ModelSettings, + tools: list[Tool], + output_schema: AgentOutputSchemaBase | None, + handoffs: list[Handoff], + tracing: ModelTracing, + *, + previous_response_id: str | None, + conversation_id: str | None, + prompt: ResponsePromptParam | None, + ) -> AsyncIterator[TResponseStreamEvent]: + sanitized = dedupe_input(input) + rewriter = TurnCallIdRewriter(sanitized) + limiter = self._limiter() + stream = self._inner.stream_response( + system_instructions, + cast("str | list[TResponseInputItem]", sanitized), + model_settings, + tools, + output_schema, + handoffs, + tracing, + previous_response_id=previous_response_id, + conversation_id=conversation_id, + prompt=prompt, + ) + async for event in _with_idle_timeout(stream, self._stream_idle_timeout): + guarded = _guard_event(event, rewriter, limiter) + if guarded is not None: + yield guarded + self._log_dropped(limiter) + + +async def _aclose(stream: AsyncIterator[TResponseStreamEvent]) -> None: + if isinstance(stream, AsyncGenerator): + with contextlib.suppress(Exception): + await stream.aclose() + + +async def _with_idle_timeout( + stream: AsyncIterator[TResponseStreamEvent], timeout: float +) -> AsyncIterator[TResponseStreamEvent]: + if timeout <= 0: + async for event in stream: + yield event + return + + iterator = stream.__aiter__() + while True: + try: + event = await asyncio.wait_for(iterator.__anext__(), timeout) + except StopAsyncIteration: + return + except TimeoutError: + await _aclose(stream) + message = f"model stream produced no event for {timeout:.0f}s" + logger.warning("%s; abandoning the turn", message) + raise TimeoutError(message) from None + yield event + + +def _guard_event( + event: TResponseStreamEvent, rewriter: TurnCallIdRewriter, limiter: TurnToolCallLimiter +) -> TResponseStreamEvent | None: + if isinstance(event, ResponseOutputItemAddedEvent | ResponseOutputItemDoneEvent): + rewritten = rewriter.rewrite_item(event.item) + if not limiter.allow(rewritten): + return None + if rewritten is not event.item: + return event.model_copy(update={"item": rewritten}) + return event + if isinstance(event, ResponseCompletedEvent): + original = list(event.response.output) + output = limiter.filter_items(rewriter.rewrite_items(original)) + if output != original: + return event.model_copy( + update={"response": event.response.model_copy(update={"output": output})} + ) + return event + + +def _completed_stream_event( + model_response: ModelResponse, model_name: object | None +) -> TResponseStreamEvent: + """Wrap a non-streamed ``ModelResponse`` as the terminal event of a stream. + + The run loop builds its authoritative per-turn response solely from the + ``response.completed`` event, so a single event carrying the full output + and usage is all it needs. + """ + response = Response( + id=model_response.response_id or FAKE_RESPONSES_ID, + created_at=time.time(), + model=str(model_name) if model_name else "", + object="response", + output=list(model_response.output), + tool_choice="auto", + tools=[], + parallel_tool_calls=False, + usage=_response_usage(model_response.usage), + ) + return ResponseCompletedEvent( + response=response, + sequence_number=0, + type="response.completed", + ) + + +def _response_usage(usage: Usage | None) -> ResponseUsage | None: + if usage is None: + return None + return ResponseUsage( + input_tokens=usage.input_tokens, + output_tokens=usage.output_tokens, + total_tokens=usage.total_tokens, + input_tokens_details=usage.input_tokens_details, + output_tokens_details=usage.output_tokens_details, + ) + + class StrixProvider(MultiProvider): """Route any non-OpenAI prefix through LiteLLM with the prefix preserved, so users type ``deepseek/deepseek-chat`` rather than @@ -160,19 +470,35 @@ class StrixProvider(MultiProvider): return self._get_fallback_provider("litellm"), original_model_name def get_model(self, model_name: str | None) -> Model: + llm = load_settings().llm slug = codex.subscription_model(model_name) + idle_timeout = float(llm.stream_idle_timeout) if slug: - return _CodexResponsesModel( + # The ChatGPT subscription backend is always streamed; it has no + # non-streaming mode to fall back to, so LLM_DISABLE_STREAMING + # does not apply here. + model: Model = _CodexResponsesModel( slug, codex.get_subscription_client(), - reasoning_effort=load_settings().llm.reasoning_effort, + reasoning_effort=llm.reasoning_effort, ) - grok_slug = grok.subscription_model(model_name) - if grok_slug: + elif grok_slug := grok.subscription_model(model_name): # xAI's API is OpenAI chat-completions compatible; the subscription # bearer is stamped per-request by the client's auth hook. - return OpenAIChatCompletionsModel(grok_slug, grok.get_subscription_client()) - return super().get_model(model_name) + model = OpenAIChatCompletionsModel(grok_slug, grok.get_subscription_client()) + else: + model = super().get_model(model_name) + if llm.disable_streaming: + model = _NonStreamingModel(model) + # The wrapper emits its single event only once the whole request + # is done, so an idle gap is meaningless here; the request + # timeout bounds it instead. + idle_timeout = 0.0 + return _TurnGuardModel( + model, + max_tool_calls_per_turn=llm.max_tool_calls_per_turn, + stream_idle_timeout=idle_timeout, + ) DEFAULT_MODEL_RETRY = ModelRetrySettings( @@ -249,6 +575,7 @@ def configure_sdk_model_defaults(settings: Settings) -> None: set_default_openai_api("chat_completions") else: set_default_openai_api("responses") + _configure_extra_headers(llm) def _mirror_api_key_to_provider_env(model_name: str | None, api_key: str) -> None: @@ -283,6 +610,51 @@ def _configure_litellm_compatibility() -> None: litellm.suppress_debug_info = True _register_litellm_cost_callback() + _install_openrouter_stream_cost_capture() + + +def _install_openrouter_stream_cost_capture() -> None: + """Preserve OpenRouter's per-stream cost, which LiteLLM drops when streaming. + + OpenRouter reports the real charge in ``usage.cost`` of the final stream + chunk, but LiteLLM rebuilds streamed responses from token-only fields and + discards it (its non-streamed path stashes the cost in hidden params; the + streaming path does not). Every scan streams, so without this the cost is + lost and Strix falls back to a cost-map estimate that is missing entirely + for new models (e.g. kimi-k3), reporting $0. Subclass the OpenRouter + streaming handler to record the cost keyed by response id so the cost + callback can recover the exact charge for the matching rebuilt response. + """ + import litellm + from litellm.llms.openrouter.chat.transformation import ( + OpenRouterChatCompletionStreamingHandler, + OpenrouterConfig, + ) + + from strix.report.state import streamed_openrouter_costs + + class _StrixOpenRouterStreamingHandler(OpenRouterChatCompletionStreamingHandler): + def chunk_parser(self, chunk: dict[str, Any]) -> Any: + stream = super().chunk_parser(chunk) + streamed_openrouter_costs.remember( + chunk.get("id") or getattr(stream, "id", None), chunk.get("usage") + ) + return stream + + class _StrixOpenrouterConfig(OpenrouterConfig): + def get_model_response_iterator( + self, streaming_response: Any, sync_stream: bool, json_mode: bool | None = False + ) -> Any: + return _StrixOpenRouterStreamingHandler( + streaming_response=streaming_response, + sync_stream=sync_stream, + json_mode=json_mode, + ) + + # LiteLLM's provider-config factory reads litellm.OpenrouterConfig at call + # time, so overriding the attribute is enough for the subclass to take + # effect. (type: ignore — mypy rejects reassigning a class attribute.) + litellm.OpenrouterConfig = _StrixOpenrouterConfig # type: ignore[misc] _OPENROUTER_ATTRIBUTION_HEADERS = { @@ -308,6 +680,43 @@ def _configure_openrouter_attribution(model_name: str | None) -> None: litellm.headers = {**existing, **_OPENROUTER_ATTRIBUTION_HEADERS} # type: ignore[assignment] +def _configure_extra_headers(llm: LlmSettings) -> None: + """Send user-provided default headers on every LLM request. + + Some OpenAI-compatible endpoints require extra HTTP headers (e.g. request + attribution or tenant routing) alongside the bearer token. Users supply + them via ``LLM_EXTRA_HEADERS``; they are applied to both routing paths: + the LiteLLM route (``litellm.headers``) and the SDK-native OpenAI route + (a default client carrying ``default_headers``), so they take effect + regardless of the ``STRIX_LLM`` prefix. + """ + headers = llm.extra_headers + if not headers: + return + _merge_litellm_headers(headers) + _register_openai_client_with_headers(llm, headers) + + +def _merge_litellm_headers(headers: dict[str, str]) -> None: + import litellm + + current: object = litellm.headers + existing: dict[str, str] = current if isinstance(current, dict) else {} + litellm.headers = {**existing, **headers} # type: ignore[assignment] + + +def _register_openai_client_with_headers(llm: LlmSettings, headers: dict[str, str]) -> None: + from agents import set_default_openai_client + from openai import AsyncOpenAI + + client = AsyncOpenAI( + api_key=llm.api_key or "not-needed", + base_url=llm.api_base, + default_headers=dict(headers), + ) + set_default_openai_client(client, use_for_tracing=False) + + def _register_litellm_cost_callback() -> None: import litellm diff --git a/strix/config/settings.py b/strix/config/settings.py index 78d52273..42a2c97e 100644 --- a/strix/config/settings.py +++ b/strix/config/settings.py @@ -8,7 +8,9 @@ from pydantic import AliasChoices, Field from pydantic_settings import BaseSettings, SettingsConfigDict -ReasoningEffort = Literal["none", "minimal", "low", "medium", "high", "xhigh"] +ReasoningEffort = Literal["none", "minimal", "low", "medium", "high", "xhigh", "max"] + +DEFAULT_MAX_TURNS = 500 _BASE_CONFIG = SettingsConfigDict( case_sensitive=False, @@ -24,6 +26,7 @@ class LlmSettings(BaseSettings): api_key: str | None = Field( default=None, validation_alias=AliasChoices("LLM_API_KEY", "OPENAI_API_KEY"), + repr=False, ) api_base: str | None = Field( default=None, @@ -35,6 +38,11 @@ class LlmSettings(BaseSettings): "OLLAMA_API_BASE", ), ) + extra_headers: dict[str, str] | None = Field( + default=None, + alias="LLM_EXTRA_HEADERS", + repr=False, + ) reasoning_effort: ReasoningEffort = Field(default="high", alias="STRIX_REASONING_EFFORT") force_required_tool_choice: bool = Field( default=False, @@ -44,7 +52,17 @@ class LlmSettings(BaseSettings): default=True, alias="STRIX_PROMPT_CACHE", ) + disable_streaming: bool = Field( + default=False, + alias="LLM_DISABLE_STREAMING", + ) timeout: int = Field(default=300, alias="LLM_TIMEOUT") + stream_idle_timeout: int = Field(default=300, ge=0, alias="LLM_STREAM_IDLE_TIMEOUT") + max_tool_calls_per_turn: int = Field( + default=32, + ge=0, + alias="LLM_MAX_TOOL_CALLS_PER_TURN", + ) class DedupeSettings(BaseSettings): @@ -55,8 +73,13 @@ class DedupeSettings(BaseSettings): default=None, alias="STRIX_DEDUPE_REASONING_EFFORT", ) - api_key: str | None = Field(default=None, alias="DEDUPE_LLM_API_KEY") + api_key: str | None = Field(default=None, alias="DEDUPE_LLM_API_KEY", repr=False) api_base: str | None = Field(default=None, alias="DEDUPE_LLM_API_BASE") + extra_headers: dict[str, str] | None = Field( + default=None, + alias="DEDUPE_LLM_EXTRA_HEADERS", + repr=False, + ) class ContextSettings(BaseSettings): @@ -83,15 +106,10 @@ class RuntimeSettings(BaseSettings): model_config = _BASE_CONFIG image: str = Field( - default="ghcr.io/usestrix/strix-sandbox:1.1.0", + default="ghcr.io/usestrix/strix-sandbox:1.3.0", alias="STRIX_IMAGE", ) backend: str = Field(default="docker", alias="STRIX_RUNTIME_BACKEND") - # Hard cap on a local target's size before we refuse to stream it into the - # sandbox file-by-file (the SDK copies every file individually, which stalls - # on large repos). Above this, the user must bind-mount via ``--mount``. - # Set to 0 (or less) to disable the pre-flight check entirely. - max_local_copy_mb: int = Field(default=1024, alias="STRIX_MAX_LOCAL_COPY_MB") # Max screenshot/image tool outputs kept live per agent context (0 = none). max_context_images: int = Field(default=3, ge=0, alias="STRIX_MAX_CONTEXT_IMAGES") @@ -105,7 +123,16 @@ class TelemetrySettings(BaseSettings): class IntegrationSettings(BaseSettings): model_config = _BASE_CONFIG - perplexity_api_key: str | None = Field(default=None, alias="PERPLEXITY_API_KEY") + perplexity_api_key: str | None = Field( + default=None, + alias="PERPLEXITY_API_KEY", + repr=False, + ) + postman_api_key: str | None = Field( + default=None, + alias="POSTMAN_API_KEY", + repr=False, + ) class ViewerSettings(BaseSettings): diff --git a/strix/config/tool_call_ids.py b/strix/config/tool_call_ids.py new file mode 100644 index 00000000..31f78850 --- /dev/null +++ b/strix/config/tool_call_ids.py @@ -0,0 +1,117 @@ +"""Keep tool-call ids unique within a conversation. + +Some providers return per-turn tool-call ids (``exec_command:0``, +``exec_command:1``, ...) whose counter restarts on every turn. Once the same +id appears twice in one conversation, the request payload has two assistant +tool calls sharing an id and strict providers reject the whole turn, which +permanently kills the agent because the malformed history is replayed on +every retry. Rewriting duplicates to fresh unique ids keeps the history +valid for any provider. +""" + +from __future__ import annotations + +from collections import defaultdict, deque +from typing import Any +from uuid import uuid4 + +from openai.types.responses import ResponseFunctionToolCall + + +def new_call_id() -> str: + return f"call_{uuid4().hex}" + + +def collect_call_ids(items: list[Any]) -> set[str]: + used: set[str] = set() + for item in items: + if isinstance(item, dict): + call_id = item.get("call_id") + if isinstance(call_id, str): + used.add(call_id) + elif isinstance(item, ResponseFunctionToolCall): + used.add(item.call_id) + return used + + +def dedupe_history_call_ids(items: list[Any]) -> tuple[list[Any], bool]: + """Rewrite duplicate call ids in a conversation history. + + Outputs are paired with their call by order, so parallel calls that share + an id keep answering the right call after the rewrite. + """ + used: set[str] = set() + pending: dict[str, deque[str]] = defaultdict(deque) + rebuilt: list[Any] = [] + changed = False + + for item in items: + if not isinstance(item, dict): + rebuilt.append(item) + continue + call_id = item.get("call_id") + if not isinstance(call_id, str): + rebuilt.append(item) + continue + + kind = item.get("type") + if kind == "function_call": + effective = call_id + if call_id in used: + effective = new_call_id() + item = {**item, "call_id": effective} # noqa: PLW2901 + changed = True + used.add(effective) + pending[call_id].append(effective) + elif kind == "function_call_output": + queue = pending.get(call_id) + if queue: + effective = queue.popleft() + if effective != call_id: + item = {**item, "call_id": effective} # noqa: PLW2901 + changed = True + rebuilt.append(item) + + return rebuilt, changed + + +def dedupe_input(model_input: str | list[Any]) -> str | list[Any]: + if isinstance(model_input, str): + return model_input + rebuilt, changed = dedupe_history_call_ids(model_input) + return rebuilt if changed else model_input + + +class TurnCallIdRewriter: + """Rewrite a single turn's tool-call ids that collide with the history. + + A turn's items surface several times (streamed item events, then the + completed response), so the same original id must always map to the same + replacement within the turn. + """ + + def __init__(self, model_input: str | list[Any]) -> None: + self._used = set() if isinstance(model_input, str) else collect_call_ids(model_input) + self._remap: dict[str, str] = {} + self._settled: set[str] = set() + + def rewrite_item(self, item: Any) -> Any: + if not isinstance(item, ResponseFunctionToolCall): + return item + original = item.call_id + if original in self._settled: + return item + replacement = self._remap.get(original) + if replacement is None: + if original not in self._used: + self._used.add(original) + self._settled.add(original) + return item + replacement = new_call_id() + self._remap[original] = replacement + self._used.add(replacement) + self._settled.add(replacement) + return item.model_copy(update={"call_id": replacement}) + + def rewrite_items(self, items: list[Any]) -> list[Any]: + return [self.rewrite_item(item) for item in items] diff --git a/strix/config/tool_call_limits.py b/strix/config/tool_call_limits.py new file mode 100644 index 00000000..a014e8db --- /dev/null +++ b/strix/config/tool_call_limits.py @@ -0,0 +1,46 @@ +"""Bound how many tool calls one assistant response may queue. + +A degenerate generation can emit hundreds or thousands of tool calls in a +single response — typically a poll/wait loop the model writes out ahead of +time instead of issuing one call and yielding. The run loop honours all of +them, so the agent stops reacting to anything for hours. Keeping only the +first ``limit`` calls of a response bounds that blast radius; the model sees +their results on the next turn and can reconsider. +""" + +from __future__ import annotations + +from typing import Any + +from openai.types.responses import ResponseFunctionToolCall + + +class TurnToolCallLimiter: + """Decide, once per call, whether a turn's tool call is within the limit.""" + + def __init__(self, limit: int) -> None: + self._limit = limit + self._decisions: dict[str, bool] = {} + self._kept = 0 + self.dropped = 0 + + @property + def enabled(self) -> bool: + return self._limit > 0 + + def allow(self, item: Any) -> bool: + if not self.enabled or not isinstance(item, ResponseFunctionToolCall): + return True + decided = self._decisions.get(item.call_id) + if decided is not None: + return decided + allowed = self._kept < self._limit + if allowed: + self._kept += 1 + else: + self.dropped += 1 + self._decisions[item.call_id] = allowed + return allowed + + def filter_items(self, items: list[Any]) -> list[Any]: + return [item for item in items if self.allow(item)] diff --git a/strix/core/agents.py b/strix/core/agents.py index 97d94548..c96204df 100644 --- a/strix/core/agents.py +++ b/strix/core/agents.py @@ -24,6 +24,11 @@ logger = logging.getLogger(__name__) Status = Literal["running", "waiting", "completed", "stopped", "crashed", "failed", "budget_paused"] +# Why an agent parked. The user can message any agent, so this - not the agent's +# position in the tree - decides whether waiting is bounded: only an agent waiting +# on other agents is re-checked on a timer. +WaitKind = Literal["user", "agents", "stalled"] + @dataclass(slots=True) class AgentRuntime: @@ -32,6 +37,8 @@ class AgentRuntime: stream: Any | None = None interrupt_on_message: bool = False wake: asyncio.Event = field(default_factory=asyncio.Event) + mailbox: list[dict[str, Any]] = field(default_factory=list) + user_wake_required: bool = False class AgentCoordinator: @@ -44,7 +51,11 @@ class AgentCoordinator: self.metadata: dict[str, dict[str, Any]] = {} self.pending_counts: dict[str, int] = {} self.errors: dict[str, str] = {} + self.recovery_counts: dict[str, int] = {} + self.idle_resume_counts: dict[str, int] = {} + self.wait_kinds: dict[str, WaitKind] = {} self.runtimes: dict[str, AgentRuntime] = {} + self._parent_notified: set[str] = set() self._lock = asyncio.Lock() self._snapshot_path: Path | None = None self.is_shutting_down = False @@ -179,11 +190,59 @@ class AgentCoordinator: if agent_id in self.statuses: self.statuses[agent_id] = "running" self.errors.pop(agent_id, None) + self.wait_kinds.pop(agent_id, None) + self.runtimes.setdefault(agent_id, AgentRuntime()).user_wake_required = False + self._parent_notified.discard(agent_id) await self._maybe_snapshot() - async def park_waiting(self, agent_id: str) -> None: + async def park_waiting(self, agent_id: str, *, wait_kind: WaitKind) -> None: + """Park an agent, recording what it is waiting on so the driver can time it.""" + async with self._lock: + if agent_id in self.statuses: + self.wait_kinds[agent_id] = wait_kind await self.set_status(agent_id, "waiting") + async def wait_kind_of(self, agent_id: str) -> WaitKind | None: + async with self._lock: + return self.wait_kinds.get(agent_id) + + async def record_recovery(self, agent_id: str) -> int: + """Count a turn that ended without a lifecycle tool call; return the new total. + + Persisted so a resumed agent cannot earn a fresh nudge budget on every + auto-resume and loop forever. + """ + async with self._lock: + count = self.recovery_counts.get(agent_id, 0) + 1 + self.recovery_counts[agent_id] = count + await self._maybe_snapshot() + return count + + async def reset_recovery(self, agent_id: str) -> None: + """Clear the nudge budget after real progress (new message or a lifecycle tool).""" + async with self._lock: + if self.recovery_counts.pop(agent_id, None) is None: + return + await self._maybe_snapshot() + + async def record_idle_resume(self, agent_id: str) -> int: + """Count an auto-resume that no message triggered; return the new total. + + An agent that parks again after every auto-resume would otherwise burn a + model turn per timeout for the rest of the scan. + """ + async with self._lock: + count = self.idle_resume_counts.get(agent_id, 0) + 1 + self.idle_resume_counts[agent_id] = count + await self._maybe_snapshot() + return count + + async def reset_idle_resumes(self, agent_id: str) -> None: + async with self._lock: + if self.idle_resume_counts.pop(agent_id, None) is None: + return + await self._maybe_snapshot() + async def set_status( self, agent_id: str, status: Status | str, *, error: str | None = None ) -> None: @@ -195,57 +254,71 @@ class AgentCoordinator: self.errors[agent_id] = error elif status == "running": self.errors.pop(agent_id, None) + if status == "running": + # Running again means a fresh stint that owes its parent its own notice. + self._parent_notified.discard(agent_id) runtime = self.runtimes.setdefault(agent_id, AgentRuntime()) + runtime.user_wake_required = status in {"failed", "crashed"} runtime.wake.set() logger.info("agent.status %s=%s", agent_id, status) await self._maybe_snapshot() + async def claim_parent_notice(self, agent_id: str) -> bool: + """Reserve the one notice a child owes its parent when it stops running. + + A completion report and a terminal notice carry the same information, so + whichever comes first claims the slot and the other is skipped. + """ + async with self._lock: + if agent_id in self._parent_notified: + return False + self._parent_notified.add(agent_id) + return True + async def send( self, target_agent_id: str, message: dict[str, Any], *, interrupt: bool = True ) -> bool: - """Deliver a user/peer message by appending it to the target SDK session.""" - if message.get("from") == "user" and self._budget_paused: + """Queue a user/peer message in the target's mailbox and wake it.""" + from_user = message.get("from") == "user" + if from_user and self._budget_paused: await self.resume_from_budget_pause(exclude=target_agent_id) async with self._lock: if target_agent_id not in self.statuses: logger.debug("agent.send dropped unknown target=%s", target_agent_id) return False runtime = self.runtimes.setdefault(target_agent_id, AgentRuntime()) - session = runtime.session + runtime.mailbox.append(dict(message)) + self.pending_counts[target_agent_id] = self.pending_counts.get(target_agent_id, 0) + 1 + if from_user: + runtime.user_wake_required = False + runtime.wake.set() stream = runtime.stream interrupt_on_message = runtime.interrupt_on_message - if session is None: - logger.warning( - "agent.send dropped target=%s because its SDK session is not attached", - target_agent_id, - ) - return False - try: - async with session_write_lock(session): - await session.add_items([self._message_to_session_item(message)]) - except Exception: - logger.exception( - "agent.send failed to append to SDK session target=%s", - target_agent_id, - ) - return False - async with self._lock: - self.pending_counts[target_agent_id] = self.pending_counts.get(target_agent_id, 0) + 1 - self.runtimes.setdefault(target_agent_id, AgentRuntime()).wake.set() if stream is not None and interrupt and interrupt_on_message: stream.cancel(mode="immediate") await self._maybe_snapshot() return True - async def wait_for_message(self, agent_id: str) -> None: + async def wait_for_message(self, agent_id: str, *, timeout: float | None = None) -> bool: + """Wait until a message is ready for ``agent_id``; False on ``timeout``.""" while True: async with self._lock: + runtime = self.runtimes.setdefault(agent_id, AgentRuntime()) reserve_exit = self._reserve_stopped and self.parent_of.get(agent_id) is not None - if self._budget_stopped or reserve_exit or self.pending_counts.get(agent_id, 0) > 0: - return - wake = self.runtimes.setdefault(agent_id, AgentRuntime()).wake + pending_ready = ( + self.pending_counts.get(agent_id, 0) > 0 and not runtime.user_wake_required + ) + if self._budget_stopped or reserve_exit or pending_ready: + return True + wake = runtime.wake wake.clear() - await wake.wait() + if timeout is None: + await wake.wait() + else: + try: + await asyncio.wait_for(wake.wait(), timeout) + except TimeoutError: + return False async def consume_pending( self, @@ -253,17 +326,38 @@ class AgentCoordinator: *, include_items: bool = False, ) -> tuple[int, list[Any]]: + """Drain the agent's mailbox into its own SDK session.""" async with self._lock: - count = self.pending_counts.get(agent_id, 0) + runtime = self.runtimes.setdefault(agent_id, AgentRuntime()) + queued = list(runtime.mailbox) + runtime.mailbox.clear() + count = max(self.pending_counts.get(agent_id, 0), len(queued)) self.pending_counts[agent_id] = 0 - session = self.runtimes.get(agent_id, AgentRuntime()).session + session = runtime.session if count <= 0: return 0, [] + items = [self._message_to_session_item(m) for m in queued] + if items: + if session is None: + logger.warning( + "agent %s has no SDK session attached; %d queued messages were not persisted", + agent_id, + len(items), + ) + else: + try: + async with session_write_lock(session): + await session.add_items(items) + except Exception: + logger.exception( + "failed to append %d queued messages to the session of %s", + len(items), + agent_id, + ) await self._maybe_snapshot() - if not include_items or session is None: + if not include_items: return count, [] - items = await session.get_items() - return count, list(items[-count:]) + return count, items async def request_stop(self, agent_id: str) -> None: async with self._lock: @@ -289,12 +383,15 @@ class AgentCoordinator: if tasks: await asyncio.gather(*tasks, return_exceptions=True) - async def cancel_descendants_graceful(self, agent_id: str) -> None: + async def cancel_descendants_graceful(self, agent_id: str) -> list[str]: + """Stop a subtree leaves-first and report which agents were stopped.""" async with self._lock: order = self._subtree_order_locked(agent_id) - for aid in reversed(order): + stopped = list(reversed(order)) + for aid in stopped: await self.request_stop(aid) await self._maybe_snapshot() + return stopped async def attach_stream( self, @@ -374,6 +471,14 @@ class AgentCoordinator: "names": dict(self.names), "metadata": {aid: dict(md) for aid, md in self.metadata.items()}, "pending_counts": dict(self.pending_counts), + "recovery_counts": dict(self.recovery_counts), + "idle_resume_counts": dict(self.idle_resume_counts), + "wait_kinds": dict(self.wait_kinds), + "mailboxes": { + aid: [dict(m) for m in runtime.mailbox] + for aid, runtime in self.runtimes.items() + if runtime.mailbox + }, "errors": dict(self.errors), "budget_stopped": self._budget_stopped, "reserve_stopped": self._reserve_stopped, @@ -388,6 +493,15 @@ class AgentCoordinator: self.metadata = {aid: dict(md) for aid, md in snap.get("metadata", {}).items()} self.pending_counts = dict(snap.get("pending_counts", {})) self.errors = dict(snap.get("errors", {})) + self.recovery_counts = dict(snap.get("recovery_counts", {})) + self.idle_resume_counts = dict(snap.get("idle_resume_counts", {})) + self.wait_kinds = dict(snap.get("wait_kinds", {})) + mailboxes = snap.get("mailboxes", {}) + if isinstance(mailboxes, dict): + for aid, msgs in mailboxes.items(): + if isinstance(msgs, list): + runtime = self.runtimes.setdefault(aid, AgentRuntime()) + runtime.mailbox = [dict(m) for m in msgs if isinstance(m, dict)] self._budget_stopped = bool(snap.get("budget_stopped", False)) self._reserve_stopped = bool(snap.get("reserve_stopped", False)) self._budget_paused = bool(snap.get("budget_paused", False)) diff --git a/strix/core/execution.py b/strix/core/execution.py index ae726ed3..91ceb8af 100644 --- a/strix/core/execution.py +++ b/strix/core/execution.py @@ -9,6 +9,7 @@ import uuid from collections.abc import Callable from typing import TYPE_CHECKING, Any, cast +import litellm from agents import RunConfig, Runner from agents.exceptions import AgentsException, MaxTurnsExceeded, UserError from agents.sandbox.errors import ExecTransportError @@ -16,9 +17,7 @@ from docker import errors as docker_errors # type: ignore[import-untyped, unuse from openai import ( APIConnectionError, APIError, - APIStatusError, APITimeoutError, - RateLimitError, ) from strix.config import codex @@ -31,6 +30,8 @@ from strix.core.inputs import child_initial_input from strix.core.sessions import ( enforce_image_budget, open_agent_session, + replace_session_items, + seed_initial_input, strip_all_images_from_session, ) from strix.llm.compaction import is_context_overflow, maybe_compact @@ -55,6 +56,23 @@ _INPUT_REJECTION_CODES = frozenset({400, 404, 422}) _MAX_COMPACTIONS_PER_CYCLE = 2 +class ProviderRefusalError(AgentsException): + """Raised when a provider returns a structured refusal instead of an exception.""" + + +def _structured_provider_refusal(result: Any) -> str | None: + for item in getattr(result, "new_items", ()) or (): + raw_item = getattr(item, "raw_item", None) + for content in getattr(raw_item, "content", ()) or (): + if getattr(content, "type", None) != "refusal": + continue + refusal = getattr(content, "refusal", None) + if isinstance(refusal, str) and refusal.strip(): + return refusal.strip() + return "The model provider refused this request." + return None + + def _run_config_model(run_config: RunConfig) -> str | None: return run_config.model if isinstance(run_config.model, str) else None @@ -89,15 +107,9 @@ async def _compact_session( ) -_GUARDRAIL_PARK_ERROR = ( - "Blocked by the model's content guardrail (flagged as a possible cybersecurity risk). " - "Set STRIX_LLM to a model that isn't blocked and resume the scan to continue." -) - -_TRANSIENT_MODEL_STATUS_CODES = frozenset({408, 500, 502, 503, 504}) -_MAX_TRANSIENT_MODEL_RETRIES = 4 +_MAX_TRANSIENT_MODEL_RETRIES = 5 _TRANSIENT_MODEL_RETRY_BASE_DELAY_S = 2.0 -_TRANSIENT_MODEL_RETRY_MAX_DELAY_S = 30.0 +_TRANSIENT_MODEL_RETRY_MAX_DELAY_S = 90.0 def _model_error_status_code(exc: BaseException) -> int | None: @@ -106,15 +118,16 @@ def _model_error_status_code(exc: BaseException) -> int | None: def _is_transient_model_error(exc: BaseException) -> bool: - if isinstance(exc, RateLimitError): + if codex.is_content_guardrail_error(exc): return False - if isinstance(exc, APITimeoutError | APIConnectionError): + if isinstance( + exc, APITimeoutError | APIConnectionError | TimeoutError | ConnectionError | OSError + ): return True - if isinstance(exc, APIStatusError): - return exc.status_code in _TRANSIENT_MODEL_STATUS_CODES - if isinstance(exc, APIError): - return _model_error_status_code(exc) is None - return False + code = _model_error_status_code(exc) + if code is not None: + return bool(litellm._should_retry(code)) + return isinstance(exc, APIError) def _transient_model_retry_delay(attempt: int) -> float: @@ -122,6 +135,40 @@ def _transient_model_retry_delay(attempt: int) -> float: return min(delay, _TRANSIENT_MODEL_RETRY_MAX_DELAY_S) +async def _salvage_stream_to_session( + session: Session, + pre_run_items: list[Any], + stream: Any, + agent_id: str, +) -> None: + """Persist a crashed run's full history so a revived agent loses no context.""" + if stream is None: + return + try: + replay = list(stream.to_input_list()) + except Exception: + logger.exception("could not build salvage history for %s", agent_id) + return + desired = list(pre_run_items) + replay + if len(desired) <= len(pre_run_items): + return + try: + await replace_session_items(session, desired) + except Exception: + logger.exception("salvaging crashed run history failed for %s", agent_id) + + +async def _seed_and_prepare_first_input( + session: Session | None, initial_input: Any, *, start_parked: bool +) -> Any: + """Persist the opening input up front so it survives a first-turn crash.""" + if initial_input and session is not None and not start_parked: + with contextlib.suppress(Exception): + if await seed_initial_input(session, initial_input): + return [] + return initial_input + + async def run_agent_loop( *, agent: Any, @@ -144,6 +191,10 @@ async def run_agent_loop( ) result: RunResultBase | None = None + first_cycle_input = await _seed_and_prepare_first_input( + session, initial_input, start_parked=start_parked + ) + budget_stopped = coordinator.budget_stopped reserve_stopped = coordinator.reserve_stopped if budget_stopped: @@ -157,31 +208,17 @@ async def run_agent_loop( await coordinator.send(agent_id, _reserve_notice()) if not (start_parked and interactive): - if interactive: - with contextlib.suppress(BudgetPausedError): - result = await _run_cycle( - agent, - coordinator, - agent_id, - input_data=initial_input, - run_config=run_config, - context=context, - max_turns=max_turns, - session=session, - interactive=interactive, - event_sink=event_sink, - hooks=hooks, - ) - else: - result = await _run_noninteractive_until_lifecycle( + with contextlib.suppress(BudgetPausedError): + result = await _run_until_lifecycle( agent, coordinator, agent_id, - initial_input=initial_input, + initial_input=first_cycle_input, run_config=run_config, context=context, max_turns=max_turns, session=session, + interactive=interactive, event_sink=event_sink, hooks=hooks, ) @@ -190,8 +227,9 @@ async def run_agent_loop( return result while True: + timeout = await _plain_waiting_timeout(coordinator, agent_id) try: - await coordinator.wait_for_message(agent_id) + woke = await coordinator.wait_for_message(agent_id, timeout=timeout) except asyncio.CancelledError: return result @@ -203,18 +241,46 @@ async def run_agent_loop( await coordinator.set_status(agent_id, "stopped") raise SubagentBudgetReservedError("scan reached the sub-agent budget reserve") + if woke: + # Real input is real progress, so the nudge budget starts over. A bare + # auto-resume is not: it must not hand a wedged agent a fresh budget. + await coordinator.reset_recovery(agent_id) + await coordinator.reset_idle_resumes(agent_id) + else: + idle_resumes = await coordinator.record_idle_resume(agent_id) + if idle_resumes >= _MAX_IDLE_AUTO_RESUMES: + logger.warning( + "agent %s auto-resumed %d times without hearing from anyone; " + "leaving it parked until a real message arrives", + agent_id, + idle_resumes, + ) + await coordinator.park_waiting(agent_id, wait_kind="stalled") + await _notify_parent_on_stall(coordinator, agent_id) + continue + logger.info("agent %s reached its waiting timeout; auto-resuming", agent_id) + await coordinator.send( + agent_id, + { + "from": "system", + "type": "auto_resume", + "content": "Waiting timeout reached. Resuming execution.", + }, + interrupt=False, + ) + await coordinator.consume_pending(agent_id) with contextlib.suppress(BudgetPausedError): - result = await _run_cycle( + result = await _run_until_lifecycle( agent, coordinator, agent_id, - input_data=[], + initial_input=[], run_config=run_config, context=context, max_turns=max_turns, session=session, - interactive=interactive, + interactive=True, event_sink=event_sink, hooks=hooks, ) @@ -310,7 +376,6 @@ async def respawn_subagents( if coordinator.parent_of.get(aid) is None or aid == root_id: continue md["_restored_status"] = status - md["_restored_error"] = coordinator.errors.get(aid) candidates.append( ( aid, @@ -323,8 +388,7 @@ async def respawn_subagents( for child_id, name, parent_id, md in candidates: try: restored_status = str(md.get("_restored_status") or "running") - recoverable_park = restored_status == "waiting" and bool(md.get("_restored_error")) - start_parked = interactive and restored_status != "running" and not recoverable_park + start_parked = interactive and restored_status != "running" if start_parked: logger.warning( @@ -367,7 +431,10 @@ async def respawn_subagents( await coordinator.set_status(child_id, "crashed") -async def _run_noninteractive_until_lifecycle( +_INTERACTIVE_TOOL_RECOVERY_LIMIT = 3 + + +async def _run_until_lifecycle( agent: Any, coordinator: AgentCoordinator, agent_id: str, @@ -377,14 +444,20 @@ async def _run_noninteractive_until_lifecycle( context: dict[str, Any], max_turns: int, session: Session | None, + interactive: bool, event_sink: StreamEventSink | None, hooks: RunHooks[dict[str, Any]] | None, ) -> RunResultBase | None: - """Non-chat mode keeps running until finish_scan / agent_finish settles status.""" + """Drive an agent until an explicit lifecycle tool settles its status. + + A turn that ends without ``finish_scan``, ``agent_finish``, + ``respond_to_user``, or ``wait_for_agents`` leaves the agent ``running``: + plain text never terminates a run and never yields to the user. Such a turn + is nudged back into a tool call, bounded by a recovery limit. + """ result: RunResultBase | None = None input_data: Any = initial_input - invalid_final_outputs = 0 - invalid_final_output_limit = max(1, max_turns) + recovery_limit = _INTERACTIVE_TOOL_RECOVERY_LIMIT if interactive else max(1, max_turns) while True: if coordinator.budget_stopped: @@ -395,7 +468,143 @@ async def _run_noninteractive_until_lifecycle( await coordinator.set_status(agent_id, "stopped") raise SubagentBudgetReservedError("scan reached the sub-agent budget reserve") - result = await _run_cycle( + if interactive: + result = await _run_cycle_parked( + agent, + coordinator, + agent_id, + input_data=input_data, + run_config=run_config, + context=context, + max_turns=max_turns, + session=session, + event_sink=event_sink, + hooks=hooks, + ) + else: + result = await _run_cycle( + agent, + coordinator, + agent_id, + input_data=input_data, + run_config=run_config, + context=context, + max_turns=max_turns, + session=session, + interactive=False, + event_sink=event_sink, + hooks=hooks, + ) + + status = await _agent_status(coordinator, agent_id) + if status != "running": + await coordinator.reset_recovery(agent_id) + return result + + recoveries = await coordinator.record_recovery(agent_id) + logger.warning( + "agent %s ended a turn without a lifecycle tool call (interactive=%s); " + "forcing tool continuation (%d/%d): %s", + agent_id, + interactive, + recoveries, + recovery_limit, + _final_output_preview(result), + ) + + if recoveries >= recovery_limit: + return await _exhausted_recovery(coordinator, agent_id, result, interactive=interactive) + + input_data = await _append_tool_required_message( + session=session, + context=context, + attempt=recoveries, + limit=recovery_limit, + interactive=interactive, + ) + + +async def _exhausted_recovery( + coordinator: AgentCoordinator, + agent_id: str, + result: RunResultBase | None, + *, + interactive: bool, +) -> RunResultBase | None: + """Settle an agent that never recovered into a tool call. + + Interactive runs park instead of dying: a human is attached and can message + any agent, so the scan stays resumable. Autonomous runs have nobody to + resume them, so they fail loudly. + """ + if not interactive: + await coordinator.set_status(agent_id, "crashed") + await notify_parent_on_terminal(coordinator, agent_id, "crashed") + raise MaxTurnsExceeded( + "Agent exhausted recovery attempts without calling finish_scan or agent_finish." + ) + + logger.warning( + "agent %s exhausted tool-call recovery attempts; parking until a message arrives", + agent_id, + ) + await coordinator.park_waiting(agent_id, wait_kind="stalled") + # A parked child owes its parent a completion report it can no longer send. The + # parent is an agent, not a watching human, so nothing else tells it to stop + # waiting and it burns its full timeout on a message that is never coming. + await _notify_parent_on_stall(coordinator, agent_id) + return result + + +_WAITING_AUTO_RESUME_TIMEOUT_S = 300.0 + +# An agent that parks again after every auto-resume makes no progress, so stop +# spending a model turn per timeout and leave it parked for a real message. +_MAX_IDLE_AUTO_RESUMES = 3 + + +async def _plain_waiting_timeout( + coordinator: AgentCoordinator, + agent_id: str, +) -> float | None: + """Auto-resume timeout for a parked agent; None waits until a message arrives. + + Driven by what the agent is waiting on, not by where it sits in the graph: + the user can message any agent, so an agent awaiting a human parks + indefinitely whether or not it is the root. Only an agent awaiting other + agents is re-checked on a timer, and only until it has spent its idle + budget re-parking without hearing anything. + """ + async with coordinator._lock: + status = coordinator.statuses.get(agent_id) + has_error = agent_id in coordinator.errors + runtime = coordinator.runtimes.get(agent_id) + gated = runtime.user_wake_required if runtime is not None else False + wait_kind = coordinator.wait_kinds.get(agent_id) + idle_resumes = coordinator.idle_resume_counts.get(agent_id, 0) + if status != "waiting" or has_error or gated: + return None + if wait_kind != "agents" or idle_resumes >= _MAX_IDLE_AUTO_RESUMES: + return None + return _WAITING_AUTO_RESUME_TIMEOUT_S + + +async def _run_cycle_parked( + agent: Any, + coordinator: AgentCoordinator, + agent_id: str, + *, + input_data: Any, + run_config: RunConfig, + context: dict[str, Any], + max_turns: int, + session: Session | None, + event_sink: StreamEventSink | None, + hooks: RunHooks[dict[str, Any]] | None, +) -> RunResultBase | None: + """Interactive run cycle that parks on any error instead of killing the runner.""" + try: + return await _run_cycle( agent, coordinator, agent_id, @@ -404,39 +613,17 @@ async def _run_noninteractive_until_lifecycle( context=context, max_turns=max_turns, session=session, - interactive=False, + interactive=True, event_sink=event_sink, hooks=hooks, ) - - status = await _agent_status(coordinator, agent_id) - if status != "running": - return result - - invalid_final_outputs += 1 - logger.warning( - "agent %s produced non-lifecycle final output in non-interactive mode; " - "forcing tool continuation (%d/%d): %s", - agent_id, - invalid_final_outputs, - invalid_final_output_limit, - _final_output_preview(result), - ) - - if invalid_final_outputs >= invalid_final_output_limit: - await coordinator.set_status(agent_id, "crashed") - await _notify_parent_on_terminal(coordinator, agent_id, "crashed") - raise MaxTurnsExceeded( - "Agent exhausted non-interactive recovery attempts without calling " - "finish_scan or agent_finish." - ) - - input_data = await _append_noninteractive_tool_required_message( - session=session, - context=context, - attempt=invalid_final_outputs, - limit=invalid_final_output_limit, - ) + except (BudgetExceededError, BudgetPausedError, SubagentBudgetReservedError): + raise + except Exception as exc: + logger.exception("error escaped the run cycle for %s; parking as failed", agent_id) + await coordinator.set_status(agent_id, "failed", error=str(exc) or type(exc).__name__) + await notify_parent_on_terminal(coordinator, agent_id, "failed") + return None async def _run_cycle( # noqa: PLR0912, PLR0915 @@ -457,6 +644,8 @@ async def _run_cycle( # noqa: PLR0912, PLR0915 compactions = 0 model_retries = 0 while True: + stream: Any = None + pre_run_items: list[Any] = [] try: await coordinator.mark_running(agent_id) if session is not None: @@ -470,6 +659,8 @@ async def _run_cycle( # noqa: PLR0912, PLR0915 await _compact_session(agent, session, run_config, force=False) except Exception: logger.exception("proactive compaction failed for %s", agent_id) + with contextlib.suppress(Exception): + pre_run_items = list(await session.get_items()) stream = Runner.run_streamed( agent, input=input_data, @@ -490,6 +681,8 @@ async def _run_cycle( # noqa: PLR0912, PLR0915 logger.exception("stream event sink failed for %s", agent_id) if stream.run_loop_exception is not None: raise stream.run_loop_exception + if refusal := _structured_provider_refusal(stream): + raise ProviderRefusalError(refusal) except (BudgetExceededError, BudgetPausedError, SubagentBudgetReservedError): raise except RuntimeError as stream_exc: @@ -580,58 +773,31 @@ async def _run_cycle( # noqa: PLR0912, PLR0915 if session is not None: input_data = [] continue - if codex.is_content_guardrail_error(exc): - return await _handle_content_guardrail( - coordinator, agent_id, exc, interactive=interactive - ) - if not interactive: - raise + if session is not None: + await _salvage_stream_to_session(session, pre_run_items, stream, agent_id) + if isinstance(exc, ProviderRefusalError): + logger.warning("agent %s refused by the model provider: %s", agent_id, exc) + await coordinator.set_status(agent_id, "failed", error=str(exc)) + await notify_parent_on_terminal(coordinator, agent_id, "failed") + return None if isinstance(exc, MaxTurnsExceeded): status: Status = "stopped" elif isinstance(exc, UserError | AgentsException | APIError): status = "failed" else: status = "crashed" - logger.exception("agent run failed for %s; parking as %s", agent_id, status) + logger.exception("agent run failed for %s; marking %s", agent_id, status) + # Settle the status and wake the parent before the exception unwinds a + # non-interactive agent's task: a child that dies still owes its parent a + # report, and the parent would otherwise wait out its timeout on a message + # the dead child can no longer send. await coordinator.set_status(agent_id, status, error=str(exc) or type(exc).__name__) - await _notify_parent_on_terminal(coordinator, agent_id, status) + await notify_parent_on_terminal(coordinator, agent_id, status) + if not interactive: + raise return None else: - await _settle_run_result(coordinator, agent_id, interactive) - return stream - - -async def _handle_content_guardrail( - coordinator: AgentCoordinator, - agent_id: str, - exc: BaseException, - *, - interactive: bool, -) -> RunResultBase | None: - logger.warning("agent %s blocked by the model's content guardrail: %s", agent_id, exc) - if interactive: - await coordinator.set_status(agent_id, "waiting", error=_GUARDRAIL_PARK_ERROR) - return None - await coordinator.set_status(agent_id, "failed", error=_GUARDRAIL_PARK_ERROR) - await _notify_parent_on_terminal(coordinator, agent_id, "failed") - return None - - -async def _settle_run_result( - coordinator: AgentCoordinator, - agent_id: str, - interactive: bool, -) -> None: - async with coordinator._lock: - current_status = coordinator.statuses.get(agent_id) - - if current_status != "running": - return - - if not interactive: - return - - await coordinator.set_status(agent_id, "waiting") + return cast("RunResultBase | None", stream) async def _agent_status(coordinator: AgentCoordinator, agent_id: str) -> Status | None: @@ -649,23 +815,37 @@ def _final_output_preview(result: RunResultBase | None) -> str: return text[:300] -async def _append_noninteractive_tool_required_message( +async def _append_tool_required_message( *, session: Session | None, context: dict[str, Any], attempt: int, limit: int, + interactive: bool, ) -> list[dict[str, str]]: finish_tool = "finish_scan" if context.get("parent_id") is None else "agent_finish" - message = ( - "Your previous response ended the autonomous Strix run without a lifecycle tool call. " - "That is invalid in non-interactive mode; plain text final answers are ignored. " - "Continue immediately and call exactly one tool. " - f"If your work is complete, call {finish_tool}. " - "If you are blocked waiting for another agent, call wait_for_message. " - "Otherwise use the appropriate execution or planning tool. " - f"This is recovery attempt {attempt}/{limit}." - ) + if interactive: + message = ( + "Your previous message ended a turn without a tool call. Plain text never ends " + "execution and never hands control to the user: it is shown to the user, and the " + "run continues. Continue immediately and call exactly one tool. " + "If you have something to tell the user and nothing to do until they reply, " + "call respond_to_user. " + "If you are blocked waiting for another agent, call wait_for_agents. " + f"If the whole engagement is complete, call {finish_tool}. " + "Otherwise use the appropriate execution or planning tool. " + f"This is recovery attempt {attempt}/{limit}." + ) + else: + message = ( + "Your previous response ended the autonomous run without a lifecycle tool " + "call. That is invalid in non-interactive mode; plain text final answers are " + "ignored. Continue immediately and call exactly one tool. " + f"If your work is complete, call {finish_tool}. " + "If you are blocked waiting for another agent, call wait_for_agents. " + "Otherwise use the appropriate execution or planning tool. " + f"This is recovery attempt {attempt}/{limit}." + ) item = {"role": "user", "content": message} if session is None: return [item] @@ -675,6 +855,11 @@ async def _append_noninteractive_tool_required_message( _TERMINAL_NOTICE = { + "completed": ( + "[Agent completed] {name} ({agent_id}) finished and is no longer running, but it " + "sent no completion report. Stop waiting on this child; ask it directly if you " + "need its results." + ), "crashed": ( "[Agent crash] {name} ({agent_id}) terminated unexpectedly. " "Stop waiting on this child unless you want to message it again." @@ -685,14 +870,44 @@ _TERMINAL_NOTICE = { "message it again." ), "stopped": ( - "[Agent capped] {name} ({agent_id}) hit its turn limit and was stopped " - "before finishing. It will not send a completion report, so stop waiting " - "on this child; account for its capped subtask and continue." + "[Agent stopped] {name} ({agent_id}) was stopped before finishing (turn limit " + "or an explicit stop). It will not send a completion report, so stop waiting " + "on this child; account for its unfinished subtask and continue." ), } -async def _notify_parent_on_terminal( +_STALL_NOTICE = ( + "[Agent stalled] {name} ({agent_id}) kept ending turns without a tool call and is " + "parked until it receives a message. It will not send a completion report on its " + "own: either message it with a concrete next step to unblock it, or stop waiting on " + "it and account for its unfinished subtask." +) + + +async def _notify_parent_on_stall( + coordinator: AgentCoordinator, + agent_id: str, +) -> None: + """Tell the parent that a child parked mid-task, so it stops waiting blindly.""" + async with coordinator._lock: + parent = coordinator.parent_of.get(agent_id) + name = coordinator.names.get(agent_id, agent_id) + if parent is None: + return + await coordinator.send( + parent, + { + "from": agent_id, + "type": "stalled", + "priority": "high", + "content": _STALL_NOTICE.format(name=name, agent_id=agent_id), + }, + interrupt=False, + ) + + +async def notify_parent_on_terminal( coordinator: AgentCoordinator, agent_id: str, status: str, @@ -705,6 +920,8 @@ async def _notify_parent_on_terminal( name = coordinator.names.get(agent_id, agent_id) if parent is None: return + if not await coordinator.claim_parent_notice(agent_id): + return await coordinator.send( parent, { @@ -739,6 +956,21 @@ async def _notify_root_on_budget_reserve(coordinator: AgentCoordinator) -> None: await coordinator.send(root, _reserve_notice()) +async def _notify_parent_on_exit( + coordinator: AgentCoordinator, + agent_id: str, +) -> None: + """Backstop for a child whose loop ended without telling its parent. + + Every terminal state counts, including ``completed``: a child that skips its + completion report leaves the parent waiting on a message nobody will send. + """ + status = await _agent_status(coordinator, agent_id) + if status is None: + return + await notify_parent_on_terminal(coordinator, agent_id, status) + + async def _start_child_runner( *, parent_ctx: dict[str, Any], @@ -792,6 +1024,9 @@ async def _start_child_runner( logger.info("child %s stopped after reaching the scan budget limit", child_id) except SubagentBudgetReservedError: logger.info("child %s stopped at the sub-agent budget reserve", child_id) + finally: + if not coordinator.is_shutting_down: + await _notify_parent_on_exit(coordinator, child_id) task_handle = asyncio.create_task(_child_loop(), name=f"agent-{name}-{child_id}") await coordinator.attach_runtime(child_id, task=task_handle) diff --git a/strix/core/hooks.py b/strix/core/hooks.py index bfeafd45..21400c0b 100644 --- a/strix/core/hooks.py +++ b/strix/core/hooks.py @@ -20,6 +20,8 @@ if TYPE_CHECKING: logger = logging.getLogger(__name__) +LLM_TURN_KEY = "llm_turn" + _STAGE_LABELS: tuple[str, ...] = ("NOTICE", "URGENT", "CRITICAL") _TURN_WARN_BANDS: tuple[float, ...] = (0.70, 0.85, 0.95) _ROOT_BUDGET_WARN_BANDS: tuple[float, ...] = (0.70, 0.85, 0.95) @@ -144,6 +146,7 @@ class ReportUsageHooks(RunHooks[dict[str, Any]]): system_prompt: str | None, # noqa: ARG002 input_items: list[TResponseInputItem], ) -> None: + context.context[LLM_TURN_KEY] = int(context.context.get(LLM_TURN_KEY, 0)) + 1 try: self._maybe_warn_turns(context, input_items) self._maybe_warn_budget(context, input_items) diff --git a/strix/core/inputs.py b/strix/core/inputs.py index aef1fe13..a89248b2 100644 --- a/strix/core/inputs.py +++ b/strix/core/inputs.py @@ -24,9 +24,6 @@ if TYPE_CHECKING: from strix.config.settings import ReasoningEffort -DEFAULT_MAX_TURNS = 500 - - def _accepts_required_tool_choice(model_name: str | None) -> bool: name = (model_name or "").strip().lower() for prefix in ("litellm/", "any-llm/"): @@ -36,6 +33,50 @@ def _accepts_required_tool_choice(model_name: str | None) -> bool: return name.startswith("openai/") or is_known_openai_bare_model(name) +def _render_diff_scope(diff_scope: dict[str, Any]) -> list[str]: + """Render pull-request diff-scope constraints as root-task lines.""" + if not diff_scope.get("active"): + return [] + parts: list[str] = [ + "\n\nScope Constraints:", + "- Pull request diff-scope mode is active. Prioritize changed files " + "and use other files only for context.", + ] + for repo_scope in diff_scope.get("repos", []) or []: + label = repo_scope.get("workspace_subdir") or repo_scope.get("source_path") or "repository" + changed = repo_scope.get("analyzable_files_count", 0) + deleted = repo_scope.get("deleted_files_count", 0) + parts.append(f"- {label}: {changed} changed file(s) in primary scope") + if deleted: + parts.append(f"- {label}: {deleted} deleted file(s) are context-only") + return parts + + +def _render_api_spec(details: dict[str, Any]) -> list[str]: + """Render an API spec target as root-task lines. + + The spec itself is in the workspace, so the task points at the file and lets + the agent read the contract rather than restating a parsed summary of it. + """ + title = details.get("spec_title") or details.get("target_spec", "API") + workspace_path = details.get("workspace_path", "") + lines = [ + f"- {title} ({details.get('spec_format', 'api')} specification" + + (f", available at: {workspace_path}" if workspace_path else "") + + ")" + ] + if base_urls := details.get("base_urls") or []: + lines.append(" - Base URL(s): " + ", ".join(base_urls)) + lines.append( + " - Read the specification and test every operation it declares, using " + "its declared parameters, request bodies, and auth. Endpoints in the " + "specification are in scope even when nothing links to them. Load the " + "`api_spec_testing` skill for the methodology, or spawn a specialist " + "with it." + ) + return lines + + def build_root_task(scan_config: dict[str, Any]) -> str: targets = scan_config.get("targets", []) or [] diff_scope = scan_config.get("diff_scope") or {} @@ -46,6 +87,7 @@ def build_root_task(scan_config: dict[str, Any]) -> str: "Local Codebases": [], "URLs": [], "IP Addresses": [], + "API Specifications": [], } for target in targets: @@ -62,12 +104,17 @@ def build_root_task(scan_config: dict[str, Any]) -> str: ) elif ttype == "local_code": path = details.get("target_path", "unknown") - suffix = ", read-only mount" if details.get("mount") else "" - sections["Local Codebases"].append(f"- {path} (available at: {workspace_path}{suffix})") + sections["Local Codebases"].append( + f"- {path} (available at: {workspace_path}; " + "this is the user's real directory, mounted live and writable — " + ".git/.agents/.codex are read-only)" + ) elif ttype == "web_application": sections["URLs"].append(f"- {details.get('target_url', '')}") elif ttype == "ip_address": sections["IP Addresses"].append(f"- {details.get('target_ip', '')}") + elif ttype == "api_spec": + sections["API Specifications"].extend(_render_api_spec(details)) parts: list[str] = [] for label, items in sections.items(): @@ -75,21 +122,24 @@ def build_root_task(scan_config: dict[str, Any]) -> str: parts.append(f"\n\n{label}:") parts.extend(items) - if diff_scope.get("active"): - parts.append("\n\nScope Constraints:") + # A workspace mount is a directory to work in, not an asset to test. It is + # listed apart from the targets so it never reads as scope. + if workspace_mount := scan_config.get("workspace_mount") or "": + subdir = scan_config.get("workspace_subdir") or "" + workspace_path = f"/workspace/{subdir}" if subdir else "/workspace" + parts.append("\n\nWorking Directory:") parts.append( - "- Pull request diff-scope mode is active. Prioritize changed files " - "and use other files only for context.", + f"- {workspace_mount} (available at: {workspace_path}; " + "this is the user's real directory, mounted live and writable — " + ".git/.agents/.codex are read-only)" ) - for repo_scope in diff_scope.get("repos", []) or []: - label = ( - repo_scope.get("workspace_subdir") or repo_scope.get("source_path") or "repository" - ) - changed = repo_scope.get("analyzable_files_count", 0) - deleted = repo_scope.get("deleted_files_count", 0) - parts.append(f"- {label}: {changed} changed file(s) in primary scope") - if deleted: - parts.append(f"- {label}: {deleted} deleted file(s) are context-only") + parts.append( + "- No scan target was set. This directory is where you work, not a " + "target to assess: the instructions below are the only source of " + "truth for what to do." + ) + + parts.extend(_render_diff_scope(diff_scope)) task = " ".join(parts) if user_instructions: @@ -104,6 +154,7 @@ def build_scope_context(scan_config: dict[str, Any]) -> dict[str, Any]: "local_code": "target_path", "web_application": "target_url", "ip_address": "target_ip", + "api_spec": "target_spec", } for target in scan_config.get("targets", []) or []: ttype = target.get("type", "unknown") @@ -117,6 +168,14 @@ def build_scope_context(scan_config: dict[str, Any]) -> dict[str, Any]: {"type": ttype, "value": value, "workspace_path": workspace_path}, ) + # An API spec authorizes the hosts it declares as in-scope web targets + # so the agent can exercise every endpoint without expanding scope. + if ttype == "api_spec": + authorized.extend( + {"type": "web_application", "value": base_url, "workspace_path": ""} + for base_url in details.get("base_urls") or [] + ) + return { "scope_source": "system_scan_config", "authorization_source": "strix_platform_verified_targets", @@ -132,12 +191,14 @@ def make_model_settings( force_required_tool_choice: bool = False, request_timeout: float | None = None, prompt_cache: bool = True, + extra_headers: dict[str, str] | None = None, ) -> ModelSettings: model_settings = ModelSettings( parallel_tool_calls=False, retry=DEFAULT_MODEL_RETRY, include_usage=True, extra_args=request_timeout_extra_args(request_timeout), + extra_headers=dict(extra_headers) if extra_headers else None, ) if ( reasoning_effort is not None @@ -145,7 +206,7 @@ def make_model_settings( and model_supports_reasoning(model_name) ): model_settings = model_settings.resolve( - ModelSettings(reasoning=Reasoning(effort=reasoning_effort)), + _reasoning_settings(reasoning_effort, model_settings.extra_args), ) if force_required_tool_choice and _accepts_required_tool_choice(model_name): model_settings = model_settings.resolve(ModelSettings(tool_choice="required")) @@ -160,6 +221,22 @@ def make_model_settings( return model_settings +def _reasoning_settings( + effort: ReasoningEffort, + extra_args: dict[str, Any] | None, +) -> ModelSettings: + """``max`` is not in the OpenAI SDK's ``Reasoning.effort`` enum, so send it as + a raw body field instead — also keeping it clear of LiteLLM's DeepSeek mapping, + which collapses every ``reasoning_effort`` level to plain thinking-enabled. + Providers that don't support ``max`` reject the request. + """ + if effort != "max": + return ModelSettings(reasoning=Reasoning(effort=effort)) + return ModelSettings( + extra_args={**(extra_args or {}), "extra_body": {"reasoning_effort": "max"}}, + ) + + def _prompt_cache_extra_args(model_name: str) -> dict[str, Any] | None: """LiteLLM ``cache_control_injection_points`` for Claude prompt caching. diff --git a/strix/core/runner.py b/strix/core/runner.py index c5f51b15..6c197b54 100644 --- a/strix/core/runner.py +++ b/strix/core/runner.py @@ -23,6 +23,7 @@ from strix.config.models import ( configure_sdk_model_defaults, uses_chat_completions_tool_schema, ) +from strix.config.settings import DEFAULT_MAX_TURNS from strix.core.agents import AgentCoordinator from strix.core.execution import ( respawn_subagents, @@ -33,7 +34,6 @@ from strix.core.execution import ( ) from strix.core.hooks import BudgetExceededError, ReportUsageHooks, recomputed_budget_flags from strix.core.inputs import ( - DEFAULT_MAX_TURNS, build_root_task, build_scope_context, make_model_settings, @@ -53,6 +53,8 @@ if TYPE_CHECKING: from agents.memory import SQLiteSession from agents.result import RunResultBase + from strix.runtime.status import StatusSink + logger = logging.getLogger(__name__) @@ -120,6 +122,7 @@ async def run_strix_scan( event_sink: StreamEventSink | None = None, root_instructions_override: str | None = None, extra_system_prompt_context: dict[str, Any] | None = None, + status_sink: StatusSink | None = None, ) -> RunResultBase | None: """Run or resume one Strix scan against a sandbox. @@ -129,6 +132,11 @@ async def run_strix_scan( context before prompt rendering. Child agents keep the standard scan prompt and context. """ + + def report(phase: str) -> None: + if status_sink is not None: + status_sink(phase) + if scan_id is None: scan_id = f"scan-{uuid.uuid4().hex[:8]}" @@ -219,7 +227,9 @@ async def run_strix_scan( scan_id, image=image, local_sources=local_sources or [], + status_sink=status_sink, ) + report("Waiting for the first model response") logger.info("Sandbox ready for scan %s", scan_id) sandbox_session = bundle["session"] @@ -250,6 +260,7 @@ async def run_strix_scan( force_required_tool_choice=settings.llm.force_required_tool_choice, request_timeout=settings.llm.timeout, prompt_cache=settings.llm.prompt_cache, + extra_headers=settings.llm.extra_headers, ) run_config = RunConfig( model=resolved_model, @@ -257,6 +268,9 @@ async def run_strix_scan( model_settings=model_settings, sandbox=SandboxRunConfig(client=bundle["client"], session=bundle["session"]), trace_include_sensitive_data=False, + # A hallucinated tool name is a recoverable model mistake, not a scan-ending + # error: hand it back as a tool result so the agent can correct itself. + tool_not_found_behavior="return_error_to_model", ) hooks = ReportUsageHooks( model=resolved_model, @@ -279,7 +293,7 @@ async def run_strix_scan( ) root_agent = build_strix_agent( - name="Strix", + name="Root Agent", skills=skills, is_root=True, scan_mode=scan_mode, @@ -293,7 +307,7 @@ async def run_strix_scan( if not is_resume: await coordinator.register( root_id, - "Strix", + "Root Agent", parent_id=None, task=root_task, skills=skills, @@ -376,12 +390,6 @@ async def run_strix_scan( async with coordinator._lock: root_status = coordinator.statuses.get(root_id) - root_error = coordinator.errors.get(root_id) - - root_recoverable_park = root_status == "waiting" and bool(root_error) - root_start_parked = bool( - interactive and is_resume and root_status != "running" and not root_recoverable_park - ) result = await run_agent_loop( agent=root_agent, @@ -393,7 +401,7 @@ async def run_strix_scan( agent_id=root_id, interactive=interactive, session=root_session, - start_parked=root_start_parked, + start_parked=bool(interactive and is_resume and root_status != "running"), event_sink=event_sink, hooks=hooks, ) diff --git a/strix/core/sessions.py b/strix/core/sessions.py index 2bb83982..8879d359 100644 --- a/strix/core/sessions.py +++ b/strix/core/sessions.py @@ -7,6 +7,7 @@ import logging from typing import TYPE_CHECKING, Any, cast from weakref import WeakKeyDictionary +from agents.items import ItemHelpers from agents.memory import SQLiteSession @@ -26,6 +27,18 @@ def open_agent_session(agent_id: str, path: Path) -> SQLiteSession: return SQLiteSession(session_id=agent_id, db_path=path) +async def seed_initial_input(session: Session, initial_input: Any) -> bool: + """Commit an agent's opening identity/task input before its first run cycle.""" + items = ItemHelpers.input_to_new_input_list(initial_input) + if not items: + return False + async with session_write_lock(session): + if await session.get_items(): + return False + await session.add_items(items) + return True + + _IMAGE_REJECTED_TEXT = "[image rejected by the model]" _IMAGE_ELIDED_TEXT = "[older screenshot elided to bound context memory]" _INHERITED_IMAGE_TEXT = "[screenshot omitted from inherited context]" diff --git a/strix/interface/assets/tui_styles.tcss b/strix/interface/assets/tui_styles.tcss deleted file mode 100644 index 7e964dfa..00000000 --- a/strix/interface/assets/tui_styles.tcss +++ /dev/null @@ -1,697 +0,0 @@ -Screen { - background: #000000; - color: #d4d4d4; -} - -.screen--selection { - background: #2d3d2f; - color: #e5e5e5; -} - -ToastRack { - dock: top; - align: right top; - margin-bottom: 0; - margin-top: 1; -} - -Toast { - width: 25; - background: #000000; - border-left: outer #22c55e; -} - -Toast.-information .toast--title { - color: #22c55e; -} - -#splash_screen { - height: 100%; - width: 100%; - background: #000000; - color: #22c55e; - align: center middle; - content-align: center middle; - text-align: center; -} - -#splash_content { - width: auto; - height: auto; - background: transparent; - text-align: center; - content-align: center middle; - padding: 2; -} - -#main_container { - height: 100%; - padding: 0; - margin: 0; - background: #000000; -} - -#content_container { - height: 1fr; - padding: 0; - background: transparent; -} - -#sidebar { - width: 20%; - background: transparent; - margin-left: 1; -} - -#sidebar.-hidden { - display: none; -} - -#viewer_cta { - height: auto; - background: transparent; - border: round #333333; - color: #60a5fa; - padding: 0 1; - margin-bottom: 1; - text-align: center; -} - -#agents_tree { - height: 1fr; - background: transparent; - border: round #333333; - border-title-color: #a8a29e; - border-title-style: bold; - padding: 1; - margin-bottom: 0; -} - -#stats_scroll { - height: auto; - max-height: 15; - background: transparent; - padding: 0; - margin: 0; - border: round #333333; - scrollbar-size: 0 0; -} - -#stats_display { - height: auto; - background: transparent; - padding: 0 1; - margin: 0; -} - -#vulnerabilities_panel { - height: auto; - max-height: 12; - background: transparent; - padding: 0; - margin: 0; - border: round #333333; - overflow-y: auto; - scrollbar-background: #000000; - scrollbar-color: #333333; - scrollbar-corner-color: #000000; - scrollbar-size-vertical: 1; -} - -#vulnerabilities_panel.hidden { - display: none; -} - -.vuln-item { - height: auto; - width: 100%; - padding: 0 1; - background: transparent; - color: #d4d4d4; -} - -.vuln-item:hover { - background: #1a1a1a; - color: #fafaf9; -} - -VulnerabilityDetailScreen { - align: center middle; - background: #000000 80%; -} - -#vuln_detail_dialog { - grid-size: 1; - grid-gutter: 1; - grid-rows: 1fr auto; - padding: 2 3; - width: 85%; - max-width: 110; - height: 85%; - max-height: 45; - border: solid #262626; - background: #0a0a0a; -} - -#vuln_detail_scroll { - height: 1fr; - background: transparent; - scrollbar-background: #0a0a0a; - scrollbar-color: #404040; - scrollbar-corner-color: #0a0a0a; - scrollbar-size: 1 1; - padding-right: 1; -} - -#vuln_detail_content { - width: 100%; - background: transparent; - padding: 0; -} - -#vuln_detail_buttons { - width: 100%; - height: auto; - align: right middle; - padding-top: 1; - margin: 0; - border-top: solid #1a1a1a; -} - -#copy_vuln_detail { - width: auto; - min-width: 12; - height: auto; - background: transparent; - color: #525252; - border: none; - text-style: none; - margin: 0 1; - padding: 0 2; -} - -#close_vuln_detail { - width: auto; - min-width: 10; - height: auto; - background: transparent; - color: #a3a3a3; - border: none; - text-style: none; - margin: 0; - padding: 0 2; -} - -#copy_vuln_detail:hover, #copy_vuln_detail:focus { - background: transparent; - color: #22c55e; - border: none; -} - -#close_vuln_detail:hover, #close_vuln_detail:focus { - background: transparent; - color: #ffffff; - border: none; -} - -#chat_area_container { - width: 80%; - background: transparent; -} - -#chat_area_container.-full-width { - width: 100%; -} - -#chat_history { - height: 1fr; - background: transparent; - border: round #0a0a0a; - padding: 0; - margin-bottom: 0; - margin-right: 0; - scrollbar-background: #000000; - scrollbar-color: #1a1a1a; - scrollbar-corner-color: #000000; - scrollbar-size: 1 1; -} - -#agent_status_display { - height: 1; - background: transparent; - margin: 0; - padding: 0 1; -} - -#agent_status_display.hidden { - display: none; -} - -#status_text { - width: 1fr; - height: 100%; - background: transparent; - color: #a3a3a3; - text-align: left; - content-align: left middle; - text-style: none; - margin: 0; - padding: 0; -} - -#keymap_indicator { - width: auto; - height: 100%; - background: transparent; - color: #737373; - text-align: right; - content-align: right middle; - text-style: none; - margin: 0; - padding: 0; -} - -#chat_input_container { - height: 3; - background: transparent; - border: round #333333; - margin-right: 0; - padding: 0; - layout: horizontal; - align-vertical: top; -} - -#chat_input_container:focus-within { - border: round #22c55e; -} - -#chat_input_container:focus-within #chat_prompt { - color: #22c55e; - text-style: bold; -} - -#chat_prompt { - width: auto; - height: 100%; - padding: 0 0 0 1; - color: #737373; - content-align-vertical: top; -} - -#chat_history:focus { - border: round #22c55e; -} - -#chat_input { - width: 1fr; - height: 100%; - background: transparent; - border: none; - color: #d4d4d4; - padding: 0; - margin: 0; -} - -#chat_input:focus { - border: none; -} - -#chat_input .text-area--cursor-line { - background: transparent; -} - -#chat_input:focus .text-area--cursor-line { - background: transparent; -} - -#chat_input > .text-area--placeholder { - color: #525252; - text-style: italic; -} - -#chat_input > .text-area--cursor { - color: #22c55e; - background: #22c55e; -} - -.chat-placeholder { - width: 100%; - height: 100%; - content-align: center middle; - text-align: center; - color: #737373; - text-style: italic; -} - -.chat-content { - margin: 0 !important; - margin-top: 0 !important; - margin-bottom: 0 !important; - padding: 0 1; - background: transparent; - width: 100%; -} - -.chat-message { - margin-bottom: 0; - padding: 0; - background: transparent; - width: 100%; -} - -.user-message { - color: #e5e5e5; - border-left: thick #3b82f6; - padding-left: 1; - margin-bottom: 1; -} - -.tool-call { - margin-top: 1; - margin-bottom: 0; - padding: 0 1; - background: transparent; - border: none; - width: 100%; -} - -.tool-call.status-completed { - background: transparent; - margin-top: 1; - margin-bottom: 0; -} - -.tool-call.status-running { - background: transparent; - margin-top: 1; - margin-bottom: 0; -} - -.tool-call.status-failed, -.tool-call.status-error { - background: transparent; - margin-top: 1; - margin-bottom: 0; -} - -.browser-tool, -.terminal-tool, -.agents-graph-tool, -.file-edit-tool, -.proxy-tool, -.notes-tool, -.thinking-tool, -.web-search-tool, -.scan-info-tool, -.subagent-info-tool { - margin-top: 1; - margin-bottom: 0; - background: transparent; -} - -.finish-tool, -.reporting-tool { - margin-top: 1; - margin-bottom: 0; - background: transparent; -} - -.browser-tool.status-completed, -.browser-tool.status-running, -.terminal-tool.status-completed, -.terminal-tool.status-running, -.agents-graph-tool.status-completed, -.agents-graph-tool.status-running, -.file-edit-tool.status-completed, -.file-edit-tool.status-running, -.proxy-tool.status-completed, -.proxy-tool.status-running, -.notes-tool.status-completed, -.notes-tool.status-running, -.thinking-tool.status-completed, -.thinking-tool.status-running, -.web-search-tool.status-completed, -.web-search-tool.status-running, -.scan-info-tool.status-completed, -.scan-info-tool.status-running, -.subagent-info-tool.status-completed, -.subagent-info-tool.status-running { - background: transparent; - margin-top: 1; - margin-bottom: 0; -} - -.finish-tool.status-completed, -.finish-tool.status-running, -.reporting-tool.status-completed, -.reporting-tool.status-running { - background: transparent; - margin-top: 1; - margin-bottom: 0; -} - -Tree { - background: transparent; - color: #e7e5e4; - scrollbar-background: transparent; - scrollbar-color: #404040; - scrollbar-corner-color: transparent; - scrollbar-size: 1 1; -} - -Tree > .tree--label { - text-style: bold; - color: #a8a29e; - background: transparent; - padding: 0 1; - margin-bottom: 1; - border-bottom: solid #1a1a1a; - text-align: center; -} - -.tree--node { - height: 1; - padding: 0; - margin: 0; -} - -.tree--node-label { - color: #d6d3d1; - background: transparent; - text-style: none; - padding: 0 1; - margin: 0 1; -} - -.tree--node:hover .tree--node-label { - background: transparent; - color: #fafaf9; - text-style: bold; - border-left: solid #a8a29e; -} - -.tree--node.-selected .tree--node-label { - background: transparent; - color: #fafaf9; - text-style: bold; - border-left: heavy #d6d3d1; -} - -.tree--node.-expanded .tree--node-label { - text-style: bold; - color: #fafaf9; - background: transparent; - border-left: solid #78716c; -} - -Tree:focus { - border: round #1a1a1a; -} - -Tree:focus > .tree--label { - color: #fafaf9; - text-style: bold; - background: transparent; -} - -.tree--node .tree--node .tree--node-label { - color: #a8a29e; - padding-left: 2; - border: none; - background: transparent; - margin-left: 1; -} - -.tree--node .tree--node:hover .tree--node-label { - background: transparent; - color: #e7e5e4; -} - -.tree--node .tree--node .tree--node .tree--node-label { - color: #78716c; - padding-left: 3; - text-style: none; - border: none; - background: transparent; - margin-left: 2; -} - -StopAgentScreen { - align: center middle; - background: $background 0%; -} - -#stop_agent_dialog { - grid-size: 1; - grid-gutter: 1; - grid-rows: auto auto; - padding: 1; - width: 30; - height: auto; - border: round #a3a3a3; - background: #000000 98%; -} - -#stop_agent_title { - color: #a3a3a3; - text-style: bold; - text-align: center; - width: 100%; - margin-bottom: 0; -} - -#stop_agent_buttons { - grid-size: 2; - grid-gutter: 1; - grid-columns: 1fr 1fr; - width: 100%; - height: 1; -} - -#stop_agent_buttons Button { - height: 1; - min-height: 1; - border: none; - text-style: bold; -} - -#stop_agent { - background: transparent; - color: #ef4444; - border: none; -} - -#stop_agent:hover, #stop_agent:focus { - background: #ef4444; - color: #ffffff; - border: none; -} - -#cancel_stop { - background: transparent; - color: #737373; - border: none; -} - -#cancel_stop:hover, #cancel_stop:focus { - background:rgb(54, 54, 54); - color: #ffffff; - border: none; -} - -QuitScreen { - align: center middle; - background: $background 0%; -} - -#quit_dialog { - grid-size: 1; - grid-gutter: 1; - grid-rows: auto auto; - padding: 1; - width: 24; - height: auto; - border: round #333333; - background: #000000 98%; -} - -#quit_title { - color: #d4d4d4; - text-style: bold; - text-align: center; - width: 100%; - margin-bottom: 0; -} - -#quit_buttons { - grid-size: 2; - grid-gutter: 1; - grid-columns: 1fr 1fr; - width: 100%; - height: 1; -} - -#quit_buttons Button { - height: 1; - min-height: 1; - border: none; - text-style: bold; -} - -#quit { - background: transparent; - color: #ef4444; - border: none; -} - -#quit:hover, #quit:focus { - background: #ef4444; - color: #ffffff; - border: none; -} - -#cancel { - background: transparent; - color: #737373; - border: none; -} - -#cancel:hover, #cancel:focus { - background:rgb(54, 54, 54); - color: #ffffff; - border: none; -} - -HelpScreen { - align: center middle; - background: $background 0%; -} - -#dialog { - grid-size: 1; - grid-gutter: 0 1; - grid-rows: auto auto; - padding: 1 2; - width: 40; - height: auto; - border: round #22c55e; - background: #000000 98%; -} - -#help_title { - color: #22c55e; - text-style: bold; - text-align: center; - width: 100%; - margin-bottom: 1; -} - -#help_content { - color: #d4d4d4; - text-align: left; - width: 100%; - margin-bottom: 1; - padding: 0; - background: transparent; - text-style: none; -} diff --git a/strix/interface/cli.py b/strix/interface/cli.py index c03e8c86..cc1059b1 100644 --- a/strix/interface/cli.py +++ b/strix/interface/cli.py @@ -13,7 +13,7 @@ from rich.panel import Panel from rich.text import Text from strix.config import load_settings -from strix.core.inputs import DEFAULT_MAX_TURNS +from strix.config.settings import DEFAULT_MAX_TURNS from strix.core.runner import run_strix_scan from strix.report.state import ReportState, set_global_report_state from strix.runtime import session_manager @@ -21,6 +21,7 @@ from strix.runtime import session_manager from .utils import ( build_live_stats_text, format_vulnerability_report, + has_model_response, ) @@ -135,11 +136,17 @@ async def run_cli(args: Any) -> None: # noqa: PLR0915 set_global_report_state(report_state) + startup_phase: list[str] = ["Starting up"] + def create_live_status() -> Panel: status_text = Text() status_text.append("Penetration test in progress", style="bold #22c55e") status_text.append("\n\n") + if not has_model_response(report_state): + status_text.append(f"{startup_phase[0]}...", style="dim") + status_text.append("\n\n") + stats_text = build_live_stats_text(report_state) if stats_text: status_text.append(stats_text) @@ -152,6 +159,9 @@ async def run_cli(args: Any) -> None: # noqa: PLR0915 padding=(1, 2), ) + def _note_startup_phase(phase: str) -> None: + startup_phase[:] = [phase] + try: console.print() @@ -186,6 +196,7 @@ async def run_cli(args: Any) -> None: # noqa: PLR0915 interactive=bool(getattr(args, "interactive", False)), max_budget_usd=getattr(args, "max_budget_usd", None), max_turns=getattr(args, "max_turns", DEFAULT_MAX_TURNS), + status_sink=_note_startup_phase, ) finally: stop_updates.set() diff --git a/strix/interface/cli_args.py b/strix/interface/cli_args.py new file mode 100644 index 00000000..ec4082cc --- /dev/null +++ b/strix/interface/cli_args.py @@ -0,0 +1,379 @@ +"""Command-line argument parsing for the ``strix`` scan entrypoint.""" + +from __future__ import annotations + +import argparse +import sys +from pathlib import Path + +from strix.config import apply_config_override +from strix.config.settings import DEFAULT_MAX_TURNS +from strix.core.paths import run_dir_for, runtime_state_dir +from strix.interface.scan_setup import attach_workspace_mount, build_targets_info +from strix.interface.update_check import self_update +from strix.interface.utils import ( + check_mountable_dir, + collect_local_sources, + validate_config_file, +) + + +def get_version() -> str: + try: + from importlib.metadata import version + + return version("strix-agent") + except Exception: + return "unknown" + + +def _positive_budget(value: str) -> float: + try: + budget = float(value) + except ValueError as exc: + raise argparse.ArgumentTypeError(f"invalid float value: {value!r}") from exc + import math + + if not math.isfinite(budget) or budget <= 0: + raise argparse.ArgumentTypeError("must be a finite number greater than 0") + return budget + + +def _positive_int(value: str) -> int: + try: + parsed = int(value) + except ValueError as exc: + raise argparse.ArgumentTypeError(f"invalid int value: {value!r}") from exc + if parsed <= 0: + raise argparse.ArgumentTypeError("must be an integer greater than 0") + return parsed + + +def parse_arguments() -> argparse.Namespace: + parser = argparse.ArgumentParser( + description="Strix Multi-Agent Cybersecurity Penetration Testing Tool", + formatter_class=argparse.RawDescriptionHelpFormatter, + epilog=""" +Examples: + # Web application penetration test + strix --target https://example.com + + # GitHub repository analysis + strix --target https://github.com/user/repo + strix --target git@github.com:user/repo.git + + # Local code analysis + strix --target ./my-project + + # API spec test (OpenAPI/Swagger file or Postman collection export) + strix --target ./openapi.yaml --target https://api.example.com + strix --target ./collection.postman_collection.json + + # Postman collection pulled live by id (needs POSTMAN_API_KEY); optional environment + strix --target postman:// --target https://api.example.com + strix --target "postman://?env=" + + # Domain penetration test + strix --target example.com + + # IP address penetration test + strix --target 192.168.1.42 + + # Multiple targets (e.g., white-box testing with source and deployed app) + strix --target https://github.com/user/repo --target https://example.com + strix --target ./my-project --target https://staging.example.com --target https://prod.example.com + + # Targets from a file, one target per non-empty, non-comment line + strix --target-list ./targets.txt + + # Custom instructions (inline) + strix --target example.com --instruction "Focus on authentication vulnerabilities" + + # Custom instructions (from file) + strix --target example.com --instruction-file ./instructions.txt + strix --target https://app.com --instruction-file /path/to/detailed_instructions.md + """, + ) + + parser.add_argument( + "-v", + "--version", + action="version", + version=f"strix {get_version()}", + ) + + parser.add_argument( + "--update", + action="store_true", + help="Update strix to the latest version and exit. Self-updates the " + "standalone binary install; for pip/pipx/uv installs, prints the " + "matching upgrade command instead.", + ) + + parser.add_argument( + "-t", + "--target", + type=str, + action="append", + help="Target to test: URL, repository, local directory path, domain name, IP address, " + "an API spec file (OpenAPI/Swagger .json/.yaml or a Postman collection export), or a " + "Postman collection by id (postman://[?env=], needs " + "POSTMAN_API_KEY). Local directories are mounted into the sandbox writable. " + "Can be specified multiple times for multi-target scans. " + "Fresh runs require --target or --target-list.", + ) + parser.add_argument( + "--target-list", + type=str, + action="append", + metavar="PATH", + help="Path to a file containing targets, one per non-empty, non-comment line. " + "Can be specified multiple times and combined with --target.", + ) + parser.add_argument( + "--instruction", + type=str, + help="Custom instructions for the penetration test. This can be " + "specific vulnerability types to focus on (e.g., 'Focus on IDOR and XSS'), " + "testing approaches (e.g., 'Perform thorough authentication testing'), " + "test credentials (e.g., 'Use the following credentials to access the app: " + "admin:password123'), " + "or areas of interest (e.g., 'Check login API endpoint for security issues').", + ) + + parser.add_argument( + "--instruction-file", + type=str, + help="Path to a file containing detailed custom instructions for the penetration test. " + "Use this option when you have lengthy or complex instructions saved in a file " + "(e.g., '--instruction-file ./detailed_instructions.txt').", + ) + + parser.add_argument( + "-n", + "--non-interactive", + action="store_true", + help=( + "Run in non-interactive mode (no TUI, exits on completion). " + "Default is interactive mode with TUI." + ), + ) + + parser.add_argument( + "-m", + "--scan-mode", + type=str, + choices=["quick", "standard", "deep"], + default="deep", + help=( + "Scan mode: " + "'quick' for fast CI/CD checks, " + "'standard' for routine testing, " + "'deep' for thorough security reviews (default). " + "Default: deep." + ), + ) + + parser.add_argument( + "--scope-mode", + type=str, + choices=["auto", "diff", "full"], + default="auto", + help=( + "Scope mode for code targets: " + "'auto' enables PR diff-scope in CI/headless runs, " + "'diff' forces changed-files scope, " + "'full' disables diff-scope." + ), + ) + + parser.add_argument( + "--diff-base", + type=str, + help=( + "Target branch or commit to compare against (e.g., origin/main). " + "Defaults to the repository's default branch." + ), + ) + + parser.add_argument( + "--config", + type=str, + help="Path to a custom config file (JSON) to use instead of ~/.strix/cli-config.json", + ) + + parser.add_argument( + "--max-budget", + "--max-budget-usd", + dest="max_budget_usd", + metavar="USD", + type=_positive_budget, + default=None, + help=( + "Maximum LLM cost in USD (> 0). The scan stops cleanly when this limit is reached. " + "Graduated wrap-up warnings are sent to all agents as it is approached." + ), + ) + + parser.add_argument( + "--max-turns", + dest="max_turns", + metavar="N", + type=_positive_int, + default=DEFAULT_MAX_TURNS, + help=( + "Maximum turns per agent (> 0, default %(default)s). Each agent is force-stopped " + "when it reaches this limit, with graduated wrap-up warnings as it is approached." + ), + ) + + parser.add_argument( + "--resume", + type=str, + metavar="RUN_NAME", + help=( + "Resume a prior scan by its run name (the dir under ./strix_runs/). " + "Picks up the root + every non-terminal subagent's full LLM history " + "and agent topology. Skips fresh run-name generation." + ), + ) + + args = parser.parse_args() + # Startup-resolved state lives alongside the parsed flags. The full schema + # is established here so downstream code reads attributes directly. + args.needs_setup = False + args.targets_info = [] + args.local_sources = [] + args.diff_scope = {"active": False} + args.run_name = None + + if args.config: + apply_config_override(validate_config_file(args.config)) + + if args.update: + sys.exit(0 if self_update() else 1) + + if args.instruction and args.instruction_file: + parser.error( + "Cannot specify both --instruction and --instruction-file. Use one or the other." + ) + + if args.instruction_file: + instruction_path = Path(args.instruction_file) + try: + with instruction_path.open(encoding="utf-8") as f: + args.instruction = f.read().strip() + if not args.instruction: + parser.error(f"Instruction file '{instruction_path}' is empty") + except Exception as e: + parser.error(f"Failed to read instruction file '{instruction_path}': {e}") + + args.user_explicit_instruction = args.instruction if args.resume else None + # What the user actually asked for, kept apart from args.instruction because + # prepare_run prepends the diff-scope preamble to that. This is the text the + # transcript shows as their opening message. + args.user_instruction = args.instruction or None + + if args.resume: + if args.target or args.target_list: + parser.error( + "Cannot combine --resume with --target/--target-list. " + "--resume picks up where the prior run left off, including the " + "original target list." + ) + _load_resume_state(args, parser) + agents_path = runtime_state_dir(run_dir_for(args.resume)) / "agents.json" + if not agents_path.exists(): + parser.error( + f"--resume {args.resume}: missing {agents_path}. The run was " + f"persisted but never reached its first agent snapshot — " + f"there's nothing to resume from. Pick a fresh --run-name " + f"or remove --resume to start over with the same targets." + ) + else: + if not args.target and not args.target_list: + if args.non_interactive: + parser.error( + "the following arguments are required: -t/--target or --target-list " + "(or use --resume to continue a prior scan)" + ) + # Interactive launch with no target: open the normal TUI on its + # start screen, where the user gives a target or a bare prompt + # before the scan starts. + args.needs_setup = True + return args + + try: + build_targets_info(args) + except ValueError as e: + parser.error(str(e)) + + return args + + +def _load_resume_state(args: argparse.Namespace, parser: argparse.ArgumentParser) -> None: + """Populate ``args.targets_info`` and friends from a prior run's run.json.""" + from strix.report.writer import read_run_record + + run_dir = run_dir_for(args.resume) + state_path = run_dir / "run.json" + if not state_path.exists(): + parser.error( + f"--resume {args.resume}: no such run " + f"(missing {state_path}; remove --resume for a fresh start)" + ) + try: + state = read_run_record(run_dir) + except RuntimeError as exc: + parser.error(f"--resume {args.resume}: run.json unreadable: {exc}") + + args.targets_info = state.get("targets_info") or [] + # A target-less run has no targets_info at all: it works in a mounted + # directory, driven by its instruction. + workspace_mount = state.get("workspace_mount") or None + if not args.targets_info and not workspace_mount: + parser.error(f"--resume {args.resume}: run.json has no targets_info") + + for target in args.targets_info: + if not isinstance(target, dict): + continue + details = target.get("details") or {} + if target.get("type") == "local_code" and details.get("target_path"): + try: + check_mountable_dir(Path(details["target_path"]).expanduser()) + except ValueError as exc: + parser.error(f"--resume {args.resume}: {exc}") + continue + if target.get("type") != "repository": + continue + cloned = details.get("cloned_repo_path") + if not cloned: + continue + if not Path(cloned).expanduser().exists(): + parser.error( + f"--resume {args.resume}: cloned repo at {cloned} is missing. " + f"It was deleted between runs. Pick a fresh --run-name to " + f"re-clone, or restore the directory before resuming." + ) + + if args.instruction is None: + args.instruction = state.get("instruction") + if not getattr(args, "user_instruction", None): + args.user_instruction = state.get("user_instruction") or None + args.local_sources = collect_local_sources(args.targets_info) + # Remount the workspace the run was started with. The user already confirmed + # this directory, so the target mount guard does not apply to it; it only has + # to still be there. + args.workspace_mount = workspace_mount + if workspace_mount: + if not Path(workspace_mount).expanduser().is_dir(): + parser.error( + f"--resume {args.resume}: the working directory {workspace_mount} " + f"is missing. Restore it before resuming, or start a fresh run." + ) + attach_workspace_mount(args) + if state.get("diff_scope"): + args.diff_scope = state.get("diff_scope") + persisted_scan_mode = state.get("scan_mode") + if persisted_scan_mode and args.scan_mode == "deep": + args.scan_mode = persisted_scan_mode diff --git a/strix/interface/environment.py b/strix/interface/environment.py new file mode 100644 index 00000000..7cb6a400 --- /dev/null +++ b/strix/interface/environment.py @@ -0,0 +1,227 @@ +"""Startup environment validation and Docker image management.""" + +import logging +import shutil +import sys + +from rich.console import Console +from rich.panel import Panel +from rich.text import Text + +from strix.config import codex, grok, load_settings +from strix.interface.utils import ( + check_docker_connection, + image_exists, + process_pull_line, +) + + +logger = logging.getLogger(__name__) + + +def validate_environment() -> None: + logger.info("Validating environment") + console = Console() + missing_required_vars = [] + missing_optional_vars = [] + + settings = load_settings() + + if codex.subscription_model(settings.llm.model): + if not codex.is_authenticated(): + console.print( + f"[red]STRIX_LLM={settings.llm.model} uses your ChatGPT subscription, " + "but you're not signed in.[/] Run [cyan]strix auth login chatgpt[/] first." + ) + sys.exit(1) + logger.info("Environment OK (ChatGPT subscription)") + return + + if grok.subscription_model(settings.llm.model): + if not grok.is_authenticated(): + console.print( + f"[red]STRIX_LLM={settings.llm.model} uses your Grok subscription, " + "but you're not signed in.[/] Run [cyan]strix auth login grok[/] first." + ) + sys.exit(1) + logger.info("Environment OK (Grok subscription)") + return + + if not settings.llm.model: + missing_required_vars.append("STRIX_LLM") + + if not settings.llm.api_key: + missing_optional_vars.append("LLM_API_KEY") + + if not settings.llm.api_base: + missing_optional_vars.append("LLM_API_BASE") + + if not settings.integrations.perplexity_api_key: + missing_optional_vars.append("PERPLEXITY_API_KEY") + + if missing_required_vars: + error_text = Text() + error_text.append("MISSING REQUIRED ENVIRONMENT VARIABLES", style="bold red") + error_text.append("\n\n", style="white") + + for var in missing_required_vars: + error_text.append(f"• {var}", style="bold yellow") + error_text.append(" is not set\n", style="white") + + if missing_optional_vars: + error_text.append("\nOptional environment variables:\n", style="dim white") + for var in missing_optional_vars: + error_text.append(f"• {var}", style="dim yellow") + error_text.append(" is not set\n", style="dim white") + + error_text.append("\nRequired environment variables:\n", style="white") + for var in missing_required_vars: + if var == "STRIX_LLM": + error_text.append("• ", style="white") + error_text.append("STRIX_LLM", style="bold cyan") + error_text.append( + " - Model name to use (e.g., 'openai/gpt-5.4' or " + "'anthropic/claude-opus-4-7')\n", + style="white", + ) + + if missing_optional_vars: + error_text.append("\nOptional environment variables:\n", style="white") + for var in missing_optional_vars: + if var == "LLM_API_BASE": + error_text.append("• ", style="white") + error_text.append("LLM_API_BASE", style="bold cyan") + error_text.append( + " - Custom API base URL if using local models (e.g., Ollama, LMStudio)\n", + style="white", + ) + elif var == "PERPLEXITY_API_KEY": + error_text.append("• ", style="white") + error_text.append("PERPLEXITY_API_KEY", style="bold cyan") + error_text.append( + " - API key for Perplexity AI web search (enables real-time research)\n", + style="white", + ) + elif var == "STRIX_REASONING_EFFORT": + error_text.append("• ", style="white") + error_text.append("STRIX_REASONING_EFFORT", style="bold cyan") + error_text.append( + " - Reasoning effort level: none, minimal, low, medium, high, xhigh, " + "max (default: high)\n", + style="white", + ) + + error_text.append("\nExample setup:\n", style="white") + error_text.append("export STRIX_LLM='openai/gpt-5.4'\n", style="dim white") + + if missing_optional_vars: + for var in missing_optional_vars: + if var == "LLM_API_BASE": + error_text.append( + "export LLM_API_BASE='http://localhost:11434' " + "# needed for local models only\n", + style="dim white", + ) + elif var == "PERPLEXITY_API_KEY": + error_text.append( + "export PERPLEXITY_API_KEY='your-perplexity-key-here'\n", style="dim white" + ) + elif var == "STRIX_REASONING_EFFORT": + error_text.append( + "export STRIX_REASONING_EFFORT='high'\n", + style="dim white", + ) + + panel = Panel( + error_text, + title="[bold white]STRIX", + title_align="left", + border_style="red", + padding=(1, 2), + ) + + logger.debug("Missing required env vars: %s", missing_required_vars) + console.print("\n") + console.print(panel) + console.print() + sys.exit(1) + logger.info( + "Environment OK (optional missing: %s)", + missing_optional_vars or "none", + ) + + +def check_docker_installed() -> None: + if shutil.which("docker") is None: + logger.debug("Docker CLI not found in PATH") + console = Console() + error_text = Text() + error_text.append("DOCKER NOT INSTALLED", style="bold red") + error_text.append("\n\n", style="white") + error_text.append("The 'docker' CLI was not found in your PATH.\n", style="white") + error_text.append( + "Please install Docker and ensure the 'docker' command is available.\n\n", style="white" + ) + + panel = Panel( + error_text, + title="[bold white]STRIX", + title_align="left", + border_style="red", + padding=(1, 2), + ) + console.print("\n", panel, "\n") + sys.exit(1) + logger.debug("Docker CLI present") + + +def pull_docker_image() -> None: + from docker.errors import DockerException + + console = Console() + client = check_docker_connection() + + image = load_settings().runtime.image + + if image_exists(client, image): + logger.debug("Docker image already present locally: %s", image) + return + + logger.info("Pulling docker image: %s", image) + console.print() + console.print(f"[dim]Pulling image[/] {image}") + console.print("[dim yellow]This only happens on first run and may take a few minutes...[/]") + console.print() + + with console.status("[bold cyan]Downloading image layers...", spinner="dots") as status: + try: + layers_info: dict[str, str] = {} + last_update = "" + + for line in client.api.pull(image, stream=True, decode=True): + last_update = process_pull_line(line, layers_info, status, last_update) + + except DockerException as e: + logger.debug("Failed to pull docker image %s", image, exc_info=True) + console.print() + error_text = Text() + error_text.append("FAILED TO PULL IMAGE", style="bold red") + error_text.append("\n\n", style="white") + error_text.append(f"Could not download: {image}\n", style="white") + error_text.append(str(e), style="dim red") + + panel = Panel( + error_text, + title="[bold white]STRIX", + title_align="left", + border_style="red", + padding=(1, 2), + ) + console.print(panel, "\n") + sys.exit(1) + + logger.info("Docker image %s ready", image) + success_text = Text() + success_text.append("Docker image ready", style="#22c55e") + console.print(success_text) + console.print() diff --git a/strix/interface/interactive.py b/strix/interface/interactive.py new file mode 100644 index 00000000..3c228d03 --- /dev/null +++ b/strix/interface/interactive.py @@ -0,0 +1,38 @@ +"""Launch the interactive terminal interface.""" + +from __future__ import annotations + +import logging +from typing import TYPE_CHECKING + + +if TYPE_CHECKING: + import argparse + + +logger = logging.getLogger(__name__) + + +class InteractiveSetupUnavailableError(RuntimeError): + """Raised when the interactive TUI cannot be launched.""" + + +async def run_tui(args: argparse.Namespace) -> None: + """Run the Bubble Tea TUI.""" + from strix.interface.tui.runtime import ( + GoTuiPreActivationError, + run_go_tui, + ) + + try: + await run_go_tui(args) + except GoTuiPreActivationError as exc: + raise InteractiveSetupUnavailableError( + f"The interactive interface could not start: {exc}" + ) from exc + + +__all__ = [ + "InteractiveSetupUnavailableError", + "run_tui", +] diff --git a/strix/interface/main.py b/strix/interface/main.py index 26e7ed16..ceb14c26 100644 --- a/strix/interface/main.py +++ b/strix/interface/main.py @@ -5,71 +5,46 @@ Strix Agent Interface import argparse import asyncio +import contextlib import os -import shutil import sys -from datetime import UTC, datetime from pathlib import Path -from agents.model_settings import ModelSettings -from agents.models.interface import ModelTracing -from docker.errors import DockerException from rich.console import Console from rich.panel import Panel from rich.text import Text -from strix.config import ( - apply_config_override, - codex, - grok, - load_settings, - persist_current, - subscription, +from strix.config import codex, load_settings, persist_current +from strix.core.paths import run_dir_for +from strix.interface.cli_args import parse_arguments +from strix.interface.environment import ( + check_docker_installed, + pull_docker_image, + validate_environment, ) -from strix.config.models import ( - RECOMMENDED_MODEL_NAMES, - StrixProvider, - configure_sdk_model_defaults, - is_known_openai_bare_model, - is_recommended_or_frontier_model, +from strix.interface.interactive import ( + InteractiveSetupUnavailableError, + run_tui, +) +from strix.interface.scan_setup import ( + ModelConnectionError, + preflight_model_connection, + prepare_run, + telemetry_start, ) -from strix.core.inputs import DEFAULT_MAX_TURNS -from strix.core.paths import run_dir_for, runtime_state_dir -from strix.interface.cli import run_cli -from strix.interface.tui import run_tui from strix.interface.update_check import ( is_binary_install, notify_update, prompt_update_if_available, - self_update, start_background_check, ) from strix.interface.utils import ( - assign_workspace_subdirs, build_final_stats_text, - build_mount_targets_info, - check_docker_connection, - clone_repository, - collect_local_sources, - dedupe_local_targets, - find_oversized_local_targets, - generate_run_name, - image_exists, - infer_target_type, - is_whitebox_scan, - process_pull_line, - read_target_list_file, - resolve_diff_scope_context, - rewrite_localhost_targets, - validate_config_file, ) -from strix.report.state import get_global_report_state -from strix.report.writer import read_run_record, write_run_record from strix.telemetry import posthog, scarf from strix.telemetry.logging import configure_dependency_logging -HOST_GATEWAY_HOSTNAME = "host.docker.internal" BEDROCK_MODEL_PREFIX = "bedrock/" BEDROCK_MISSING_MODULE_ERROR = "No module named 'boto3'" BEDROCK_EXTRA_HINT = ( @@ -88,176 +63,6 @@ import logging # noqa: E402 logger = logging.getLogger(__name__) -def validate_environment() -> None: - logger.info("Validating environment") - console = Console() - missing_required_vars = [] - missing_optional_vars = [] - - settings = load_settings() - - if codex.subscription_model(settings.llm.model): - if not codex.is_authenticated(): - console.print( - f"[red]STRIX_LLM={settings.llm.model} uses your ChatGPT subscription, " - "but you're not signed in.[/] Run [cyan]strix auth login chatgpt[/] first." - ) - sys.exit(1) - logger.info("Environment OK (ChatGPT subscription)") - return - - if grok.subscription_model(settings.llm.model): - if not grok.is_authenticated(): - console.print( - f"[red]STRIX_LLM={settings.llm.model} uses your Grok subscription, " - "but you're not signed in.[/] Run [cyan]strix auth login grok[/] first." - ) - sys.exit(1) - logger.info("Environment OK (Grok subscription)") - return - - if not settings.llm.model: - missing_required_vars.append("STRIX_LLM") - - if not settings.llm.api_key: - missing_optional_vars.append("LLM_API_KEY") - - if not settings.llm.api_base: - missing_optional_vars.append("LLM_API_BASE") - - if not settings.integrations.perplexity_api_key: - missing_optional_vars.append("PERPLEXITY_API_KEY") - - if missing_required_vars: - error_text = Text() - error_text.append("MISSING REQUIRED ENVIRONMENT VARIABLES", style="bold red") - error_text.append("\n\n", style="white") - - for var in missing_required_vars: - error_text.append(f"• {var}", style="bold yellow") - error_text.append(" is not set\n", style="white") - - if missing_optional_vars: - error_text.append("\nOptional environment variables:\n", style="dim white") - for var in missing_optional_vars: - error_text.append(f"• {var}", style="dim yellow") - error_text.append(" is not set\n", style="dim white") - - error_text.append("\nRequired environment variables:\n", style="white") - for var in missing_required_vars: - if var == "STRIX_LLM": - error_text.append("• ", style="white") - error_text.append("STRIX_LLM", style="bold cyan") - error_text.append( - " - Model name to use (e.g., 'openai/gpt-5.4' or " - "'anthropic/claude-opus-4-7')\n", - style="white", - ) - - if missing_optional_vars: - error_text.append("\nOptional environment variables:\n", style="white") - for var in missing_optional_vars: - if var == "LLM_API_KEY": - error_text.append("• ", style="white") - error_text.append("LLM_API_KEY", style="bold cyan") - error_text.append( - " - API key for the LLM provider " - "(not needed for local models, Vertex AI, AWS, etc.)\n", - style="white", - ) - elif var == "LLM_API_BASE": - error_text.append("• ", style="white") - error_text.append("LLM_API_BASE", style="bold cyan") - error_text.append( - " - Custom API base URL if using local models (e.g., Ollama, LMStudio)\n", - style="white", - ) - elif var == "PERPLEXITY_API_KEY": - error_text.append("• ", style="white") - error_text.append("PERPLEXITY_API_KEY", style="bold cyan") - error_text.append( - " - API key for Perplexity AI web search (enables real-time research)\n", - style="white", - ) - elif var == "STRIX_REASONING_EFFORT": - error_text.append("• ", style="white") - error_text.append("STRIX_REASONING_EFFORT", style="bold cyan") - error_text.append( - " - Reasoning effort level: none, minimal, low, medium, high, xhigh " - "(default: high)\n", - style="white", - ) - - error_text.append("\nExample setup:\n", style="white") - error_text.append("export STRIX_LLM='openai/gpt-5.4'\n", style="dim white") - - if missing_optional_vars: - for var in missing_optional_vars: - if var == "LLM_API_KEY": - error_text.append( - "export LLM_API_KEY='your-api-key-here' " - "# not needed for local models, Vertex AI, AWS, etc.\n", - style="dim white", - ) - elif var == "LLM_API_BASE": - error_text.append( - "export LLM_API_BASE='http://localhost:11434' " - "# needed for local models only\n", - style="dim white", - ) - elif var == "PERPLEXITY_API_KEY": - error_text.append( - "export PERPLEXITY_API_KEY='your-perplexity-key-here'\n", style="dim white" - ) - elif var == "STRIX_REASONING_EFFORT": - error_text.append( - "export STRIX_REASONING_EFFORT='high'\n", - style="dim white", - ) - - panel = Panel( - error_text, - title="[bold white]STRIX", - title_align="left", - border_style="red", - padding=(1, 2), - ) - - logger.debug("Missing required env vars: %s", missing_required_vars) - console.print("\n") - console.print(panel) - console.print() - sys.exit(1) - logger.info( - "Environment OK (optional missing: %s)", - missing_optional_vars or "none", - ) - - -def check_docker_installed() -> None: - if shutil.which("docker") is None: - logger.debug("Docker CLI not found in PATH") - console = Console() - error_text = Text() - error_text.append("DOCKER NOT INSTALLED", style="bold red") - error_text.append("\n\n", style="white") - error_text.append("The 'docker' CLI was not found in your PATH.\n", style="white") - error_text.append( - "Please install Docker and ensure the 'docker' command is available.\n\n", style="white" - ) - - panel = Panel( - error_text, - title="[bold white]STRIX", - title_align="left", - border_style="red", - padding=(1, 2), - ) - console.print("\n", panel, "\n") - sys.exit(1) - logger.debug("Docker CLI present") - - def _exception_messages(exc: BaseException) -> tuple[str, ...]: messages: list[str] = [] seen: set[int] = set() @@ -322,6 +127,18 @@ def _subscription_error_hint(exc: BaseException) -> str | None: async def warm_up_llm(show_model_warning: bool = True) -> None: + from agents.model_settings import ModelSettings + from agents.models.interface import ModelTracing + + from strix.config.models import ( + RECOMMENDED_MODEL_NAMES, + StrixProvider, + configure_sdk_model_defaults, + is_known_openai_bare_model, + is_recommended_or_frontier_model, + ) + from strix.core.inputs import make_model_settings + console = Console() logger.info("Warming up LLM connection") @@ -331,7 +148,6 @@ async def warm_up_llm(show_model_warning: bool = True) -> None: configure_sdk_model_defaults(settings) llm = settings.llm raw_model = (llm.model or "").strip() - if ( raw_model and "/" not in raw_model @@ -389,22 +205,7 @@ async def warm_up_llm(show_model_warning: bool = True) -> None: ), ) - model = StrixProvider().get_model(raw_model) - await asyncio.wait_for( - model.get_response( - system_instructions="You are a helpful assistant.", - input="Reply with just 'OK'.", - model_settings=ModelSettings(), - tools=[], - output_schema=None, - handoffs=[], - tracing=ModelTracing.DISABLED, - previous_response_id=None, - conversation_id=None, - prompt=None, - ), - timeout=llm.timeout, - ) + await preflight_model_connection(raw_model, settings=settings) logger.info("LLM warm-up succeeded for model %s", (llm.model or "").strip()) if settings.dedupe.model: @@ -413,10 +214,20 @@ async def warm_up_llm(show_model_warning: bool = True) -> None: dedupe_model = settings.dedupe.model.strip() raw_model = dedupe_model deduper = StrixProvider().get_model(dedupe_model) - # Match the runtime path: send the dedupe key/endpoint per call so a - # separate-provider dedupe model authenticates during warm-up too. deduper_extra = _dedupe_extra_args(settings.dedupe) - deduper_settings = ModelSettings(extra_args=deduper_extra or None) + # A dedicated dedupe model may route to another provider, which must + # never receive the main endpoint's headers; it has its own + # DEDUPE_LLM_EXTRA_HEADERS. + deduper_settings = make_model_settings( + None, + model_name=dedupe_model, + request_timeout=llm.timeout, + prompt_cache=False, + extra_headers=settings.dedupe.extra_headers, + ) + if deduper_extra: + merged = {**(deduper_settings.extra_args or {}), **deduper_extra} + deduper_settings = deduper_settings.resolve(ModelSettings(extra_args=merged)) await asyncio.wait_for( deduper.get_response( system_instructions="You are a helpful assistant.", @@ -434,429 +245,17 @@ async def warm_up_llm(show_model_warning: bool = True) -> None: ) logger.info("LLM warm-up succeeded for dedupe model %s", dedupe_model) - except Exception as e: + except ModelConnectionError: + logger.debug("Model route warm-up failed", exc_info=True) + raise + except Exception as exc: logger.debug("LLM warm-up failed", exc_info=True) - error_text = Text() - sub_hint = _subscription_error_hint(e) - if sub_hint is not None: - # The model/backend answered with a clear, actionable rejection — - # show that instead of a generic "connection failed". - border_style = "yellow" - error_text.append("MODEL NOT AVAILABLE ON SUBSCRIPTION", style="bold yellow") - error_text.append("\n\n", style="white") - error_text.append(f"{sub_hint}\n", style="white") - error_text.append(f"\nDetails: {e}", style="dim white") - else: - border_style = "red" - error_text.append("LLM CONNECTION FAILED", style="bold red") - error_text.append("\n\n", style="white") - error_text.append( - "Could not establish connection to the language model.\n", style="white" - ) - error_text.append("Please check your configuration and try again.\n", style="white") - hint = _provider_import_hint(e, raw_model) - if hint is not None: - error_text.append(f"\n{hint}\n", style="bold yellow") - error_text.append(f"\nError: {e}", style="dim white") - - panel = Panel( - error_text, - title="[bold white]STRIX", - title_align="left", - border_style=border_style, - padding=(1, 2), - ) - - console.print("\n") - console.print(panel) - console.print() - sys.exit(1) - - -def get_version() -> str: - try: - from importlib.metadata import version - - return version("strix-agent") - except Exception: - return "unknown" - - -def _positive_budget(value: str) -> float: - try: - budget = float(value) - except ValueError as exc: - raise argparse.ArgumentTypeError(f"invalid float value: {value!r}") from exc - import math - - if not math.isfinite(budget) or budget <= 0: - raise argparse.ArgumentTypeError("must be a finite number greater than 0") - return budget - - -def _positive_int(value: str) -> int: - try: - parsed = int(value) - except ValueError as exc: - raise argparse.ArgumentTypeError(f"invalid int value: {value!r}") from exc - if parsed <= 0: - raise argparse.ArgumentTypeError("must be an integer greater than 0") - return parsed - - -def parse_arguments() -> argparse.Namespace: - parser = argparse.ArgumentParser( - description="Strix Multi-Agent Cybersecurity Penetration Testing Tool", - formatter_class=argparse.RawDescriptionHelpFormatter, - epilog=""" -Examples: - # Web application penetration test - strix --target https://example.com - - # GitHub repository analysis - strix --target https://github.com/user/repo - strix --target git@github.com:user/repo.git - - # Local code analysis - strix --target ./my-project - - # Large local repository (bind-mounted read-only instead of copied) - strix --mount ./huge-monorepo - - # Domain penetration test - strix --target example.com - - # IP address penetration test - strix --target 192.168.1.42 - - # Multiple targets (e.g., white-box testing with source and deployed app) - strix --target https://github.com/user/repo --target https://example.com - strix --target ./my-project --target https://staging.example.com --target https://prod.example.com - - # Targets from a file, one target per non-empty, non-comment line - strix --target-list ./targets.txt - - # Custom instructions (inline) - strix --target example.com --instruction "Focus on authentication vulnerabilities" - - # Custom instructions (from file) - strix --target example.com --instruction-file ./instructions.txt - strix --target https://app.com --instruction-file /path/to/detailed_instructions.md - """, - ) - - parser.add_argument( - "-v", - "--version", - action="version", - version=f"strix {get_version()}", - ) - - parser.add_argument( - "--update", - action="store_true", - help="Update strix to the latest version and exit. Self-updates the " - "standalone binary install; for pip/pipx/uv installs, prints the " - "matching upgrade command instead.", - ) - - parser.add_argument( - "-t", - "--target", - type=str, - action="append", - help="Target to test (URL, repository, local directory path, domain name, or IP address). " - "Can be specified multiple times for multi-target scans. " - "Fresh runs require at least one of --target, --target-list, or --mount.", - ) - parser.add_argument( - "--target-list", - type=str, - action="append", - metavar="PATH", - help="Path to a file containing targets, one per non-empty, non-comment line. " - "Can be specified multiple times and combined with --target.", - ) - parser.add_argument( - "--mount", - type=str, - action="append", - metavar="PATH", - help="Bind-mount a local directory into the sandbox (read-only) instead of " - "copying it file-by-file. Use this for large repositories that are too big to " - "stream into the container. Can be specified multiple times.", - ) - parser.add_argument( - "--instruction", - type=str, - help="Custom instructions for the penetration test. This can be " - "specific vulnerability types to focus on (e.g., 'Focus on IDOR and XSS'), " - "testing approaches (e.g., 'Perform thorough authentication testing'), " - "test credentials (e.g., 'Use the following credentials to access the app: " - "admin:password123'), " - "or areas of interest (e.g., 'Check login API endpoint for security issues').", - ) - - parser.add_argument( - "--instruction-file", - type=str, - help="Path to a file containing detailed custom instructions for the penetration test. " - "Use this option when you have lengthy or complex instructions saved in a file " - "(e.g., '--instruction-file ./detailed_instructions.txt').", - ) - - parser.add_argument( - "-n", - "--non-interactive", - action="store_true", - help=( - "Run in non-interactive mode (no TUI, exits on completion). " - "Default is interactive mode with TUI." - ), - ) - - parser.add_argument( - "-m", - "--scan-mode", - type=str, - choices=["quick", "standard", "deep"], - default="deep", - help=( - "Scan mode: " - "'quick' for fast CI/CD checks, " - "'standard' for routine testing, " - "'deep' for thorough security reviews (default). " - "Default: deep." - ), - ) - - parser.add_argument( - "--scope-mode", - type=str, - choices=["auto", "diff", "full"], - default="auto", - help=( - "Scope mode for code targets: " - "'auto' enables PR diff-scope in CI/headless runs, " - "'diff' forces changed-files scope, " - "'full' disables diff-scope." - ), - ) - - parser.add_argument( - "--diff-base", - type=str, - help=( - "Target branch or commit to compare against (e.g., origin/main). " - "Defaults to the repository's default branch." - ), - ) - - parser.add_argument( - "--config", - type=str, - help="Path to a custom config file (JSON) to use instead of ~/.strix/cli-config.json", - ) - - parser.add_argument( - "--max-budget", - dest="max_budget_usd", - metavar="USD", - type=_positive_budget, - default=None, - help=( - "Maximum LLM cost in USD (> 0). The scan stops cleanly when this limit is reached. " - "Graduated wrap-up warnings are sent to all agents as it is approached." - ), - ) - - parser.add_argument( - "--max-turns", - dest="max_turns", - metavar="N", - type=_positive_int, - default=DEFAULT_MAX_TURNS, - help=( - "Maximum turns per agent (> 0, default %(default)s). Each agent is force-stopped " - "when it reaches this limit, with graduated wrap-up warnings as it is approached." - ), - ) - - parser.add_argument( - "--resume", - type=str, - metavar="RUN_NAME", - help=( - "Resume a prior scan by its run name (the dir under ./strix_runs/). " - "Picks up the root + every non-terminal subagent's full LLM history " - "and agent topology. Skips fresh run-name generation." - ), - ) - - args = parser.parse_args() - - if args.update: - sys.exit(0 if self_update() else 1) - - if args.instruction and args.instruction_file: - parser.error( - "Cannot specify both --instruction and --instruction-file. Use one or the other." - ) - - if args.instruction_file: - instruction_path = Path(args.instruction_file) - try: - with instruction_path.open(encoding="utf-8") as f: - args.instruction = f.read().strip() - if not args.instruction: - parser.error(f"Instruction file '{instruction_path}' is empty") - except Exception as e: - parser.error(f"Failed to read instruction file '{instruction_path}': {e}") - - args.user_explicit_instruction = args.instruction if args.resume else None - - if args.resume: - if args.target or args.target_list or args.mount: - parser.error( - "Cannot combine --resume with --target/--target-list/--mount. " - "--resume picks up where the prior run left off, including the " - "original target list." - ) - _load_resume_state(args, parser) - agents_path = runtime_state_dir(run_dir_for(args.resume)) / "agents.json" - if not agents_path.exists(): - parser.error( - f"--resume {args.resume}: missing {agents_path}. The run was " - f"persisted but never reached its first agent snapshot — " - f"there's nothing to resume from. Pick a fresh --run-name " - f"or remove --resume to start over with the same targets." - ) - else: - if not args.target and not args.target_list and not args.mount: - parser.error( - "the following arguments are required: -t/--target, --target-list, or --mount " - "(or use --resume to continue a prior scan)" - ) - args.targets_info = [] - targets = list(args.target or []) - for target_list_path in args.target_list or []: - try: - targets.extend(read_target_list_file(target_list_path)) - except ValueError as e: - parser.error(str(e)) - - for target in targets: - try: - target_type, target_dict = infer_target_type(target) - - if target_type == "local_code": - display_target = target_dict.get("target_path", target) - else: - display_target = target - - args.targets_info.append( - {"type": target_type, "details": target_dict, "original": display_target} - ) - except ValueError: - parser.error(f"Invalid target '{target}'") - - try: - args.targets_info.extend(build_mount_targets_info(args.mount or [])) - except ValueError as e: - parser.error(str(e)) - - args.targets_info = dedupe_local_targets(args.targets_info) - - assign_workspace_subdirs(args.targets_info) - rewrite_localhost_targets(args.targets_info, HOST_GATEWAY_HOSTNAME) - - max_local_copy_mb = load_settings().runtime.max_local_copy_mb - max_copy_bytes = max_local_copy_mb * 1024 * 1024 - oversized = find_oversized_local_targets(args.targets_info, max_copy_bytes) - if oversized: - details = "; ".join( - f"{path} ({size / (1024 * 1024):.0f} MB)" for path, size in oversized - ) - parser.error( - f"Local target too large to stream into the sandbox: {details}. " - f"The limit is {max_local_copy_mb} MB " - "(set STRIX_MAX_LOCAL_COPY_MB to change it). Re-run with " - "--mount to bind-mount the directory instead of copying it." - ) - - return args - - -def _persist_run_record(args: argparse.Namespace) -> None: - run_dir = run_dir_for(args.run_name) - run_dir.mkdir(parents=True, exist_ok=True) - model = load_settings().llm.model - run_record = { - "run_id": args.run_name, - "run_name": args.run_name, - "status": "running", - "start_time": datetime.now(UTC).isoformat(), - "end_time": None, - "auth_mode": subscription.auth_mode(model), - "subscription_provider": subscription.provider_label(model), - "targets_info": args.targets_info, - "scan_mode": args.scan_mode, - "instruction": args.instruction, - "non_interactive": args.non_interactive, - "local_sources": getattr(args, "local_sources", []), - "diff_scope": getattr(args, "diff_scope", {"active": False}), - "scope_mode": args.scope_mode, - "diff_base": args.diff_base, - } - write_run_record(run_dir, run_record) - - -def _load_resume_state(args: argparse.Namespace, parser: argparse.ArgumentParser) -> None: - """Populate ``args.targets_info`` and friends from a prior run's run.json.""" - run_dir = run_dir_for(args.resume) - state_path = run_dir / "run.json" - if not state_path.exists(): - parser.error( - f"--resume {args.resume}: no such run " - f"(missing {state_path}; remove --resume for a fresh start)" - ) - try: - state = read_run_record(run_dir) - except RuntimeError as exc: - parser.error(f"--resume {args.resume}: run.json unreadable: {exc}") - - args.targets_info = state.get("targets_info") or [] - if not args.targets_info: - parser.error(f"--resume {args.resume}: run.json has no targets_info") - - for target in args.targets_info: - if not isinstance(target, dict): - continue - details = target.get("details") or {} - if target.get("type") != "repository": - continue - cloned = details.get("cloned_repo_path") - if not cloned: - continue - if not Path(cloned).expanduser().exists(): - parser.error( - f"--resume {args.resume}: cloned repo at {cloned} is missing. " - f"It was deleted between runs. Pick a fresh --run-name to " - f"re-clone, or restore the directory before resuming." - ) - - if args.instruction is None: - args.instruction = state.get("instruction") - if state.get("local_sources"): - args.local_sources = state.get("local_sources") - if state.get("diff_scope"): - args.diff_scope = state.get("diff_scope") - persisted_scan_mode = state.get("scan_mode") - if persisted_scan_mode and args.scan_mode == "deep": - args.scan_mode = persisted_scan_mode + raise ModelConnectionError(raw_model, exc) from exc def display_completion_message(args: argparse.Namespace, results_path: Path) -> None: + from strix.report.state import get_global_report_state + console = Console() report_state = get_global_report_state() @@ -935,54 +334,79 @@ def display_completion_message(args: argparse.Namespace, results_path: Path) -> notify_update(console) -def pull_docker_image() -> None: +def _print_error_panel(title: str, message: str) -> None: console = Console() - client = check_docker_connection() + error_text = Text() + error_text.append(title, style="bold red") + error_text.append("\n\n", style="white") + error_text.append(message, style="white") + panel = Panel( + error_text, + title="[bold white]STRIX", + title_align="left", + border_style="red", + padding=(1, 2), + ) + console.print("\n") + console.print(panel) + console.print() - image = load_settings().runtime.image - if image_exists(client, image): - logger.debug("Docker image already present locally: %s", image) +def _print_model_connection_error(exc: BaseException, model_name: str) -> None: + console = Console() + error_text = Text() + sub_hint = _subscription_error_hint(exc) + if sub_hint is not None: + border_style = "yellow" + error_text.append("MODEL NOT AVAILABLE ON SUBSCRIPTION", style="bold yellow") + error_text.append("\n\n", style="white") + error_text.append(f"{sub_hint}\n", style="white") + error_text.append(f"\nDetails: {exc}", style="dim white") + else: + border_style = "red" + error_text.append("LLM CONNECTION FAILED", style="bold red") + error_text.append("\n\n", style="white") + error_text.append("Could not establish connection to the language model.\n", style="white") + error_text.append("Please check your configuration and try again.\n", style="white") + hint = _provider_import_hint(exc, model_name) + if hint is not None: + error_text.append(f"\n{hint}\n", style="bold yellow") + error_text.append(f"\nError: {exc}", style="dim white") + + panel = Panel( + error_text, + title="[bold white]STRIX", + title_align="left", + border_style=border_style, + padding=(1, 2), + ) + console.print("\n") + console.print(panel) + console.print() + + +def _bootstrap_scan(args: argparse.Namespace) -> None: + """Warm up the model and prepare the run for a non-interactive scan. + + Interactive launches only validate the environment here; the model + preflight and run preparation happen inside the TUI so the interface + paints immediately instead of waiting on a model round trip. + """ + validate_environment() + if not args.non_interactive: return - - logger.info("Pulling docker image: %s", image) - console.print() - console.print(f"[dim]Pulling image[/] {image}") - console.print("[dim yellow]This only happens on first run and may take a few minutes...[/]") - console.print() - - with console.status("[bold cyan]Downloading image layers...", spinner="dots") as status: - try: - layers_info: dict[str, str] = {} - last_update = "" - - for line in client.api.pull(image, stream=True, decode=True): - last_update = process_pull_line(line, layers_info, status, last_update) - - except DockerException as e: - logger.debug("Failed to pull docker image %s", image, exc_info=True) - console.print() - error_text = Text() - error_text.append("FAILED TO PULL IMAGE", style="bold red") - error_text.append("\n\n", style="white") - error_text.append(f"Could not download: {image}\n", style="white") - error_text.append(str(e), style="dim red") - - panel = Panel( - error_text, - title="[bold white]STRIX", - title_align="left", - border_style="red", - padding=(1, 2), - ) - console.print(panel, "\n") - sys.exit(1) - - logger.info("Docker image %s ready", image) - success_text = Text() - success_text.append("Docker image ready", style="#22c55e") - console.print(success_text) - console.print() + try: + asyncio.run(warm_up_llm(show_model_warning=True)) + except ModelConnectionError as exc: + _print_model_connection_error(exc, exc.model_name) + sys.exit(1) + persist_current() + try: + prepare_run(args) + except ValueError as e: + _print_error_panel("SCAN PREPARATION FAILED", str(e)) + sys.exit(1) + telemetry_start(args) def main() -> None: @@ -1008,9 +432,6 @@ def main() -> None: args = parse_arguments() - if args.config: - apply_config_override(validate_config_file(args.config)) - start_background_check() if not args.non_interactive and prompt_update_if_available(Console()): if is_binary_install() and sys.platform != "win32": @@ -1020,74 +441,25 @@ def main() -> None: check_docker_installed() pull_docker_image() - validate_environment() - asyncio.run(warm_up_llm(show_model_warning=args.non_interactive)) + # In setup mode the TUI collects the target, then runs prepare_run(), + # warm-up, and telemetry itself once the user starts the scan. + if not args.needs_setup: + _bootstrap_scan(args) - persist_current() - - args.run_name = args.resume or generate_run_name(args.targets_info) - - if not args.resume: - for target_info in args.targets_info: - if target_info["type"] == "repository": - repo_url = target_info["details"]["target_repo"] - dest_name = target_info["details"].get("workspace_subdir") - cloned_path = clone_repository(repo_url, args.run_name, dest_name) - target_info["details"]["cloned_repo_path"] = cloned_path - - args.local_sources = collect_local_sources(args.targets_info) - try: - diff_scope = resolve_diff_scope_context( - local_sources=args.local_sources, - scope_mode=args.scope_mode, - diff_base=args.diff_base, - non_interactive=args.non_interactive, - ) - except ValueError as e: - console = Console() - error_text = Text() - error_text.append("DIFF SCOPE RESOLUTION FAILED", style="bold red") - error_text.append("\n\n", style="white") - error_text.append(str(e), style="white") - - panel = Panel( - error_text, - title="[bold white]STRIX", - title_align="left", - border_style="red", - padding=(1, 2), - ) - console.print("\n") - console.print(panel) - console.print() - sys.exit(1) - - args.diff_scope = diff_scope.metadata - if diff_scope.instruction_block: - if args.instruction: - args.instruction = f"{diff_scope.instruction_block}\n\n{args.instruction}" - else: - args.instruction = diff_scope.instruction_block - - _persist_run_record(args) - - _telemetry_start_kwargs = { - "model": load_settings().llm.model, - "auth_mode": subscription.auth_mode(load_settings().llm.model), - "scan_mode": args.scan_mode, - "is_whitebox": is_whitebox_scan(args.targets_info), - "interactive": not args.non_interactive, - "has_instructions": bool(args.instruction), - } - posthog.start(**_telemetry_start_kwargs) - scarf.start(**_telemetry_start_kwargs) + from strix.report.state import get_global_report_state exit_reason = "user_exit" try: if args.non_interactive: + from strix.interface.cli import run_cli + asyncio.run(run_cli(args)) else: asyncio.run(run_tui(args)) + except InteractiveSetupUnavailableError as exc: + exit_reason = "error" + _print_error_panel("INTERACTIVE SETUP UNAVAILABLE", str(exc)) + sys.exit(1) except KeyboardInterrupt: exit_reason = "interrupted" except Exception: @@ -1103,8 +475,16 @@ def main() -> None: "stopped", ) report_state.cleanup(status=status) - posthog.end(report_state, exit_reason=exit_reason) - scarf.end(report_state, exit_reason=exit_reason) + # Best-effort beacons on the way out. They reach the network, so a + # second Ctrl-C lands here; abandon them rather than trading a clean + # exit for a traceback. + with contextlib.suppress(KeyboardInterrupt, Exception): + posthog.end(report_state, exit_reason=exit_reason) + scarf.end(report_state, exit_reason=exit_reason) + + if not args.run_name: + # Setup mode where the user quit before starting a scan: nothing ran. + return results_path = run_dir_for(args.run_name) diff --git a/strix/interface/scan_setup.py b/strix/interface/scan_setup.py new file mode 100644 index 00000000..4c9abe6c --- /dev/null +++ b/strix/interface/scan_setup.py @@ -0,0 +1,267 @@ +"""Scan bootstrap shared by the CLI entry point and the TUI setup flow. + +Target resolution, run preparation, model preflight, and start-of-run +telemetry live here so ``strix.interface.main`` (the CLI) and +``strix.interface.tui.runtime`` (interactive setup) depend on one module +instead of each other. Everything raises ordinary exceptions; rendering +errors and exiting the process is the caller's job. +""" + +from __future__ import annotations + +import asyncio +import logging +from datetime import UTC, datetime +from typing import TYPE_CHECKING, Any + +from strix.config import Settings, load_settings, subscription +from strix.core.paths import run_dir_for +from strix.interface.utils import ( + assign_workspace_subdirs, + clone_repository, + collect_local_sources, + dedupe_local_targets, + derive_local_base_name, + generate_run_name, + infer_target_type, + is_whitebox_scan, + read_target_list_file, + resolve_diff_scope_context, + rewrite_localhost_targets, + stage_api_specs, + write_fetched_collection, +) +from strix.telemetry import posthog, scarf +from strix.utils.api_spec import ( + SpecParseError, + fetch_postman_collection, + fetch_postman_environment, + load_spec, + spec_base_urls, + spec_title, +) + + +if TYPE_CHECKING: + import argparse + +logger = logging.getLogger(__name__) + +HOST_GATEWAY_HOSTNAME = "host.docker.internal" + + +class ModelConnectionError(RuntimeError): + """An ordinary model preflight failure, annotated with its model route.""" + + def __init__(self, model_name: str, cause: BaseException) -> None: + super().__init__(str(cause)) + self.model_name = model_name + + +async def preflight_model_connection( + model_name: str, + *, + settings: Settings | None = None, +) -> None: + """Verify the configured model route before starting a scan.""" + from agents.models.interface import ModelTracing + + from strix.config.models import StrixProvider, configure_sdk_model_defaults + from strix.core.inputs import make_model_settings + + resolved_settings = load_settings() if settings is None else settings + configure_sdk_model_defaults(resolved_settings) + model = StrixProvider().get_model(model_name) + request_settings = make_model_settings( + None, + model_name=model_name, + request_timeout=resolved_settings.llm.timeout, + prompt_cache=False, + extra_headers=resolved_settings.llm.extra_headers, + ) + await asyncio.wait_for( + model.get_response( + system_instructions="You are a helpful assistant.", + input="Reply with just 'OK'.", + model_settings=request_settings, + tools=[], + output_schema=None, + handoffs=[], + tracing=ModelTracing.DISABLED, + previous_response_id=None, + conversation_id=None, + prompt=None, + ), + timeout=resolved_settings.llm.timeout, + ) + + +def build_targets_info(args: argparse.Namespace) -> None: + """Populate ``args.targets_info`` from target/target-list inputs. + + Raises :class:`ValueError` with a user-facing message on any bad input so + callers can surface it via ``parser.error`` (CLI) or a console panel (home + page). + """ + args.targets_info = [] + targets = list(args.target or []) + for target_list_path in args.target_list or []: + targets.extend(read_target_list_file(target_list_path)) + + for target in targets: + try: + target_type, target_dict = infer_target_type(target) + except ValueError as e: + raise ValueError(f"Invalid target '{target}': {e}") from None + + if target_type == "local_code": + display_target = target_dict.get("target_path", target) + else: + display_target = target + + if target_type == "api_spec": + _resolve_api_spec(target, target_dict) + + args.targets_info.append( + {"type": target_type, "details": target_dict, "original": display_target} + ) + + args.targets_info = dedupe_local_targets(args.targets_info) + + assign_workspace_subdirs(args.targets_info) + rewrite_localhost_targets(args.targets_info, HOST_GATEWAY_HOSTNAME) + + +def _resolve_api_spec(target: str, details: dict[str, Any]) -> None: + """Read the spec up front so bad input fails before the run starts. + + Records the declared base URLs (the only thing scope authorization can take + from a spec) and, for a ``postman://`` target, downloads the collection to a + local file so the sandbox never needs the Postman API key. + """ + try: + if details.get("source") == "postman_api": + collection_uid = str(details["collection_uid"]) + api_key = load_settings().integrations.postman_api_key or "" + raw = fetch_postman_collection(collection_uid, api_key) + environment_uid = str(details.get("environment_uid") or "") + extra_variables = ( + fetch_postman_environment(environment_uid, api_key) if environment_uid else None + ) + details["target_spec"] = write_fetched_collection(raw, collection_uid) + else: + raw = load_spec(str(details["target_spec"])) + extra_variables = None + base_urls = spec_base_urls(raw, extra_variables=extra_variables) + except SpecParseError as exc: + raise ValueError(f"Invalid API spec '{target}': {exc}") from None + + details["spec_title"] = spec_title(raw) + details["base_urls"] = base_urls + + +def prepare_run(args: argparse.Namespace) -> None: + """Resolve the run name, clone repos, compute diff-scope, and persist state. + + Shared by the CLI startup path and the interactive TUI setup phase (once the + user has supplied a target via ``/target``). Mutates *args* in place and + raises :class:`ValueError` on any preparation failure. + """ + args.run_name = args.resume or generate_run_name(args.targets_info) + + if args.resume: + return + + for target_info in args.targets_info: + if target_info["type"] == "repository": + repo_url = target_info["details"]["target_repo"] + dest_name = target_info["details"].get("workspace_subdir") + cloned_path = clone_repository(repo_url, args.run_name, dest_name) + target_info["details"]["cloned_repo_path"] = cloned_path + + args.local_sources = collect_local_sources(args.targets_info) + args.local_sources.extend(stage_api_specs(args.targets_info, args.run_name)) + diff_scope = resolve_diff_scope_context( + local_sources=args.local_sources, + scope_mode=args.scope_mode, + diff_base=args.diff_base, + non_interactive=args.non_interactive, + ) + args.diff_scope = diff_scope.metadata + if diff_scope.instruction_block: + if args.instruction: + args.instruction = f"{diff_scope.instruction_block}\n\n{args.instruction}" + else: + args.instruction = diff_scope.instruction_block + + attach_workspace_mount(args) + _persist_run_record(args) + + +def attach_workspace_mount(args: argparse.Namespace) -> None: + """Expose ``args.workspace_mount`` to the sandbox without making it a target. + + A workspace mount is a directory the agent works in, not something to test: + it stays out of ``targets_info``, so it carries no authorized scope, and it + is attached after diff-scope resolution so it contributes no diff context. + The instruction is the only source of truth for what to do with it. + """ + mount = getattr(args, "workspace_mount", None) + if not mount: + return + args.workspace_subdir = derive_local_base_name(mount) + local_sources = list(getattr(args, "local_sources", None) or []) + local_sources.append( + { + "source_path": mount, + "workspace_subdir": args.workspace_subdir, + "protect_metadata": True, + } + ) + args.local_sources = local_sources + + +def telemetry_start(args: argparse.Namespace) -> None: + model = load_settings().llm.model + kwargs = { + "model": model, + "auth_mode": subscription.auth_mode(model), + "scan_mode": args.scan_mode, + "is_whitebox": is_whitebox_scan(args.targets_info), + "interactive": not args.non_interactive, + "has_instructions": bool(args.instruction), + } + posthog.start(**kwargs) + scarf.start(**kwargs) + + +def _persist_run_record(args: argparse.Namespace) -> None: + from strix.report.writer import write_run_record + + run_dir = run_dir_for(args.run_name) + run_dir.mkdir(parents=True, exist_ok=True) + model = load_settings().llm.model + run_record = { + "run_id": args.run_name, + "run_name": args.run_name, + "status": "running", + "start_time": datetime.now(UTC).isoformat(), + "end_time": None, + "auth_mode": subscription.auth_mode(model), + "subscription_provider": subscription.provider_label(model), + "targets_info": args.targets_info, + "scan_mode": args.scan_mode, + "instruction": args.instruction, + # Kept apart from instruction, which carries the diff-scope preamble: the + # transcript replays this as the user's opening message. + "user_instruction": getattr(args, "user_instruction", None), + "non_interactive": args.non_interactive, + "local_sources": getattr(args, "local_sources", []), + # Persisted so --resume can remount the workspace: it is not a target, + # so it cannot be rebuilt from targets_info. + "workspace_mount": getattr(args, "workspace_mount", None), + "diff_scope": getattr(args, "diff_scope", {"active": False}), + "scope_mode": args.scope_mode, + "diff_base": args.diff_base, + } + write_run_record(run_dir, run_record) diff --git a/strix/interface/tui/__init__.py b/strix/interface/tui/__init__.py index 371ef812..541c0cdc 100644 --- a/strix/interface/tui/__init__.py +++ b/strix/interface/tui/__init__.py @@ -1,6 +1,6 @@ -"""Textual TUI interface.""" +"""Terminal user interface: Go/Bubble Tea frontend plus its Python runtime and backend.""" -from strix.interface.tui.app import StrixTUIApp, run_tui +from strix.interface.tui.live_view import TuiLiveView -__all__ = ["StrixTUIApp", "run_tui"] +__all__ = ["TuiLiveView"] diff --git a/strix/interface/tui/app.py b/strix/interface/tui/app.py deleted file mode 100644 index cc5a36c4..00000000 --- a/strix/interface/tui/app.py +++ /dev/null @@ -1,2078 +0,0 @@ -import argparse -import asyncio -import atexit -import contextlib -import logging -import signal -import sys -import threading -import webbrowser -from collections.abc import Callable -from importlib.metadata import PackageNotFoundError -from importlib.metadata import version as pkg_version -from pathlib import Path -from typing import TYPE_CHECKING, Any, ClassVar - - -if TYPE_CHECKING: - from textual.timer import Timer - -from rich.align import Align -from rich.console import Group -from rich.panel import Panel -from rich.style import Style -from rich.text import Span, Text -from textual import events, on -from textual.app import App, ComposeResult -from textual.binding import Binding -from textual.containers import Grid, Horizontal, Vertical, VerticalScroll -from textual.reactive import reactive -from textual.screen import ModalScreen -from textual.widgets import Button, Label, Static, TextArea, Tree -from textual.widgets.tree import TreeNode - -from strix.config import load_settings -from strix.config.models import is_recommended_or_frontier_model -from strix.core.hooks import BudgetExceededError -from strix.core.inputs import DEFAULT_MAX_TURNS -from strix.core.runner import run_strix_scan -from strix.interface.tui.live_view import TuiLiveView -from strix.interface.tui.messages import send_user_message_to_agent -from strix.interface.tui.renderers import render_tool_widget -from strix.interface.tui.renderers.agent_message_renderer import AgentMessageRenderer -from strix.interface.tui.renderers.user_message_renderer import UserMessageRenderer -from strix.interface.utils import build_tui_stats_text -from strix.report.state import ReportState, set_global_report_state -from strix.report.writer import ( - guess_language_name, - parse_fenced_code, - resolve_lexer, - safe_fence, -) -from strix.runtime import session_manager - - -logger = logging.getLogger(__name__) - - -def get_package_version() -> str: - try: - return pkg_version("strix-agent") - except PackageNotFoundError: - return "dev" - - -class ChatTextArea(TextArea): # type: ignore[misc] - def __init__(self, *args: Any, **kwargs: Any) -> None: - super().__init__(*args, **kwargs) - self._app_reference: StrixTUIApp | None = None - - def set_app_reference(self, app: "StrixTUIApp") -> None: - self._app_reference = app - - def on_mount(self) -> None: - self._update_height() - - def _on_key(self, event: events.Key) -> None: - if event.key == "shift+enter": - self.insert("\n") - event.prevent_default() - return - - if event.key == "enter" and self._app_reference: - text_content = str(self.text) # type: ignore[has-type] - message = text_content.strip() - if message: - self.text = "" - - self._app_reference._send_user_message(message) - - event.prevent_default() - return - - super()._on_key(event) - - @on(TextArea.Changed) # type: ignore[misc] - def _update_height(self, _event: TextArea.Changed | None = None) -> None: - if not self.parent: - return - - line_count = self.document.line_count - target_lines = min(max(1, line_count), 8) - - new_height = target_lines + 2 - - if self.parent.styles.height != new_height: - self.parent.styles.height = new_height - self.scroll_cursor_visible() - - -class SplashScreen(Static): # type: ignore[misc] - ALLOW_SELECT = False - PRIMARY_GREEN = "#22c55e" - BANNER = ( - " ███████╗████████╗██████╗ ██╗██╗ ██╗\n" - " ██╔════╝╚══██╔══╝██╔══██╗██║╚██╗██╔╝\n" - " ███████╗ ██║ ██████╔╝██║ ╚███╔╝\n" - " ╚════██║ ██║ ██╔══██╗██║ ██╔██╗\n" - " ███████║ ██║ ██║ ██║██║██╔╝ ██╗\n" - " ╚══════╝ ╚═╝ ╚═╝ ╚═╝╚═╝╚═╝ ╚═╝" - ) - - def __init__(self, *args: Any, **kwargs: Any) -> None: - super().__init__(*args, **kwargs) - self._animation_step = 0 - self._animation_timer: Timer | None = None - self._panel_static: Static | None = None - self._version = "dev" - self._non_frontier_model: str | None = None - - def compose(self) -> ComposeResult: - self._version = get_package_version() - try: - model = (load_settings().llm.model or "").strip() - except Exception: - model = "" - if model and not is_recommended_or_frontier_model(model): - self._non_frontier_model = model - self._animation_step = 0 - start_line = self._build_start_line_text(self._animation_step) - panel = self._build_panel(start_line) - - panel_static = Static(panel, id="splash_content") - self._panel_static = panel_static - yield panel_static - - def on_mount(self) -> None: - self._animation_timer = self.set_interval(0.1, self._animate_start_line) - - def on_unmount(self) -> None: - if self._animation_timer is not None: - self._animation_timer.stop() - self._animation_timer = None - - def _animate_start_line(self) -> None: - if not self._panel_static: - return - - self._animation_step += 1 - start_line = self._build_start_line_text(self._animation_step) - panel = self._build_panel(start_line) - self._panel_static.update(panel) - - def _build_panel(self, start_line: Text) -> Panel: - rows = [ - Align.center(Text(self.BANNER.strip("\n"), style=self.PRIMARY_GREEN, justify="center")), - Align.center(Text(" ")), - Align.center(self._build_welcome_text()), - Align.center(self._build_version_text()), - Align.center(self._build_tagline_text()), - Align.center(Text(" ")), - Align.center(start_line.copy()), - Align.center(Text(" ")), - Align.center(self._build_url_text()), - ] - if self._non_frontier_model: - rows.extend( - ( - Align.center(Text(" ")), - Align.center(self._build_model_warning_text(self._non_frontier_model)), - ) - ) - - return Panel.fit(Group(*rows), border_style=self.PRIMARY_GREEN, padding=(1, 6)) - - @staticmethod - def _build_model_warning_text(model: str) -> Text: - text = Text("⚠ ", style=Style(color="yellow", bold=True)) - text.append(model, style=Style(color="cyan", bold=True)) - text.append( - " is not a recommended frontier model - pentest quality could be degraded", - style=Style(color="yellow"), - ) - return text - - def _build_url_text(self) -> Text: - return Text("strix.ai", style=Style(color=self.PRIMARY_GREEN, bold=True)) - - def _build_welcome_text(self) -> Text: - text = Text("Welcome to ", style=Style(color="white", bold=True)) - text.append("Strix", style=Style(color=self.PRIMARY_GREEN, bold=True)) - text.append("!", style=Style(color="white", bold=True)) - return text - - def _build_version_text(self) -> Text: - return Text(f"v{self._version}", style=Style(color="white", dim=True)) - - def _build_tagline_text(self) -> Text: - return Text("Open-source AI hackers for your apps", style=Style(color="white", dim=True)) - - def _build_start_line_text(self, phase: int) -> Text: - full_text = "Starting Strix Agent" - text_len = len(full_text) - - shine_pos = phase % (text_len + 8) - - text = Text() - for i, char in enumerate(full_text): - dist = abs(i - shine_pos) - - if dist <= 1: - style = Style(color="bright_white", bold=True) - elif dist <= 3: - style = Style(color="white", bold=True) - elif dist <= 5: - style = Style(color="#a3a3a3") - else: - style = Style(color="#525252") - - text.append(char, style=style) - - return text - - -class HelpScreen(ModalScreen): # type: ignore[misc] - def compose(self) -> ComposeResult: - yield Grid( - Label("Strix Help", id="help_title"), - Label( - "F1 Help\nCtrl+Q/C Quit\nESC Stop Agent\n" - "Enter Send message to agent\nTab Switch panels\n↑/↓ Navigate tree", - id="help_content", - ), - id="dialog", - ) - - def on_key(self, _event: events.Key) -> None: - self.app.pop_screen() - - -class StopAgentScreen(ModalScreen): # type: ignore[misc] - def __init__(self, agent_name: str, agent_id: str): - super().__init__() - self.agent_name = agent_name - self.agent_id = agent_id - - def compose(self) -> ComposeResult: - yield Grid( - Label(f"🛑 Stop '{self.agent_name}'?", id="stop_agent_title"), - Grid( - Button("Yes", variant="error", id="stop_agent"), - Button("No", variant="default", id="cancel_stop"), - id="stop_agent_buttons", - ), - id="stop_agent_dialog", - ) - - def on_mount(self) -> None: - cancel_button = self.query_one("#cancel_stop", Button) - cancel_button.focus() - - def on_key(self, event: events.Key) -> None: - if event.key in ("left", "right", "up", "down"): - focused = self.focused - - if focused and focused.id == "stop_agent": - cancel_button = self.query_one("#cancel_stop", Button) - cancel_button.focus() - else: - stop_button = self.query_one("#stop_agent", Button) - stop_button.focus() - - event.prevent_default() - elif event.key == "enter": - focused = self.focused - if focused and isinstance(focused, Button): - focused.press() - event.prevent_default() - elif event.key == "escape": - self.app.pop_screen() - event.prevent_default() - - def on_button_pressed(self, event: Button.Pressed) -> None: - self.app.pop_screen() - if event.button.id == "stop_agent": - self.app.action_confirm_stop_agent(self.agent_id) - - -class VulnerabilityDetailScreen(ModalScreen): # type: ignore[misc] - SEVERITY_COLORS: ClassVar[dict[str, str]] = { - "critical": "#dc2626", # Red - "high": "#ea580c", # Orange - "medium": "#d97706", # Amber - "low": "#22c55e", # Green - "info": "#3b82f6", # Blue - } - - FIELD_STYLE: ClassVar[str] = "bold #4ade80" - - def __init__(self, vulnerability: dict[str, Any]) -> None: - super().__init__() - self.vulnerability = vulnerability - - def compose(self) -> ComposeResult: - content = self._render_vulnerability() - yield Grid( - VerticalScroll(Static(content, id="vuln_detail_content"), id="vuln_detail_scroll"), - Horizontal( - Button("Copy", variant="default", id="copy_vuln_detail"), - Button("Done", variant="default", id="close_vuln_detail"), - id="vuln_detail_buttons", - ), - id="vuln_detail_dialog", - ) - - def on_mount(self) -> None: - close_button = self.query_one("#close_vuln_detail", Button) - close_button.focus() - - def _get_cvss_color(self, cvss_score: float) -> str: - if cvss_score >= 9.0: - return "#dc2626" - if cvss_score >= 7.0: - return "#ea580c" - if cvss_score >= 4.0: - return "#d97706" - if cvss_score >= 0.1: - return "#65a30d" - return "#6b7280" - - def _highlight_python(self, code: str, language: str | None = None) -> Text: - try: - from pygments.styles import get_style_by_name - - lexer = resolve_lexer(language, code) - style = get_style_by_name("native") - colors = { - token: f"#{style_def['color']}" for token, style_def in style if style_def["color"] - } - - text = Text() - for token_type, token_value in lexer.get_tokens(code): - if not token_value: - continue - color = None - tt = token_type - while tt: - if tt in colors: - color = colors[tt] - break - tt = tt.parent - text.append(token_value, style=color) - except (ImportError, KeyError, AttributeError): - return Text(code) - else: - return text - - def _render_vulnerability(self) -> Text: - vuln = self.vulnerability - text = Text() - - text.append("🐞 ") - text.append("Vulnerability Report", style="bold #ea580c") - - agent_name = vuln.get("agent_name", "") - if agent_name: - text.append("\n\n") - text.append("Agent: ", style=self.FIELD_STYLE) - text.append(agent_name) - - title = vuln.get("title", "") - if title: - text.append("\n\n") - text.append("Title: ", style=self.FIELD_STYLE) - text.append(title) - - severity = vuln.get("severity", "") - if severity: - text.append("\n\n") - text.append("Severity: ", style=self.FIELD_STYLE) - severity_color = self.SEVERITY_COLORS.get(severity.lower(), "#6b7280") - text.append(severity.upper(), style=f"bold {severity_color}") - - cvss_score = vuln.get("cvss") - if cvss_score is not None: - text.append("\n\n") - text.append("CVSS Score: ", style=self.FIELD_STYLE) - cvss_color = self._get_cvss_color(float(cvss_score)) - text.append(str(cvss_score), style=f"bold {cvss_color}") - - target = vuln.get("target", "") - if target: - text.append("\n\n") - text.append("Target: ", style=self.FIELD_STYLE) - text.append(target) - - dep_meta = vuln.get("dependency_metadata") or {} - for label, key in ( - ("Package", "package_name"), - ("Ecosystem", "package_ecosystem"), - ("Installed Version", "installed_version"), - ("Fixed Version", "fixed_version"), - ): - value = dep_meta.get(key) - if value: - text.append("\n\n") - text.append(f"{label}: ", style=self.FIELD_STYLE) - text.append(str(value)) - - endpoint = vuln.get("endpoint", "") - if endpoint: - text.append("\n\n") - text.append("Endpoint: ", style=self.FIELD_STYLE) - text.append(endpoint) - - method = vuln.get("method", "") - if method: - text.append("\n\n") - text.append("Method: ", style=self.FIELD_STYLE) - text.append(method) - - cve = vuln.get("cve", "") - if cve: - text.append("\n\n") - text.append("CVE: ", style=self.FIELD_STYLE) - text.append(cve) - - cwe = vuln.get("cwe", "") - if cwe: - text.append("\n\n") - text.append("CWE: ", style=self.FIELD_STYLE) - text.append(cwe) - - fix_effort = vuln.get("fix_effort", "") - if fix_effort: - text.append("\n\n") - text.append("Fix Effort: ", style=self.FIELD_STYLE) - text.append(str(fix_effort).title()) - - cvss_breakdown = vuln.get("cvss_breakdown", {}) - if cvss_breakdown: - cvss_parts = [] - if cvss_breakdown.get("attack_vector"): - cvss_parts.append(f"AV:{cvss_breakdown['attack_vector']}") - if cvss_breakdown.get("attack_complexity"): - cvss_parts.append(f"AC:{cvss_breakdown['attack_complexity']}") - if cvss_breakdown.get("privileges_required"): - cvss_parts.append(f"PR:{cvss_breakdown['privileges_required']}") - if cvss_breakdown.get("user_interaction"): - cvss_parts.append(f"UI:{cvss_breakdown['user_interaction']}") - if cvss_breakdown.get("scope"): - cvss_parts.append(f"S:{cvss_breakdown['scope']}") - if cvss_breakdown.get("confidentiality"): - cvss_parts.append(f"C:{cvss_breakdown['confidentiality']}") - if cvss_breakdown.get("integrity"): - cvss_parts.append(f"I:{cvss_breakdown['integrity']}") - if cvss_breakdown.get("availability"): - cvss_parts.append(f"A:{cvss_breakdown['availability']}") - if cvss_parts: - text.append("\n\n") - text.append("CVSS Vector: ", style=self.FIELD_STYLE) - text.append("/".join(cvss_parts), style="dim") - - description = vuln.get("description", "") - if description: - text.append("\n\n") - text.append("Description", style=self.FIELD_STYLE) - text.append("\n") - text.append(description) - - impact = vuln.get("impact", "") - if impact: - text.append("\n\n") - text.append("Impact", style=self.FIELD_STYLE) - text.append("\n") - text.append(impact) - - technical_analysis = vuln.get("technical_analysis", "") - if technical_analysis: - text.append("\n\n") - text.append("Technical Analysis", style=self.FIELD_STYLE) - text.append("\n") - text.append(technical_analysis) - - evidence = vuln.get("evidence", "") - if evidence: - text.append("\n\n") - text.append("Evidence", style=self.FIELD_STYLE) - text.append("\n") - text.append(evidence) - - poc_description = vuln.get("poc_description", "") - if poc_description: - text.append("\n\n") - text.append("PoC Description", style=self.FIELD_STYLE) - text.append("\n") - text.append(poc_description) - - poc_script_code = vuln.get("poc_script_code", "") - if poc_script_code: - poc_language, poc_code = parse_fenced_code(poc_script_code) - text.append("\n\n") - text.append("PoC Code", style=self.FIELD_STYLE) - text.append("\n") - text.append_text(self._highlight_python(poc_code, poc_language)) - - remediation_steps = vuln.get("remediation_steps", "") - if remediation_steps: - text.append("\n\n") - text.append("Remediation", style=self.FIELD_STYLE) - text.append("\n") - text.append(remediation_steps) - - assumptions = vuln.get("assumptions", "") - if assumptions: - text.append("\n\n") - text.append("Assumptions", style=self.FIELD_STYLE) - text.append("\n") - text.append(assumptions) - - return text - - def _get_markdown_report(self) -> str: - """Get Markdown version of vulnerability report for clipboard.""" - vuln = self.vulnerability - lines: list[str] = [] - - title = vuln.get("title", "Untitled Vulnerability") - lines.append(f"# {title}") - lines.append("") - - if vuln.get("id"): - lines.append(f"**ID:** {vuln['id']}") - if vuln.get("severity"): - lines.append(f"**Severity:** {vuln['severity'].upper()}") - if vuln.get("timestamp"): - lines.append(f"**Found:** {vuln['timestamp']}") - if vuln.get("agent_name"): - lines.append(f"**Agent:** {vuln['agent_name']}") - if vuln.get("target"): - lines.append(f"**Target:** {vuln['target']}") - dep_meta = vuln.get("dependency_metadata") or {} - if dep_meta.get("package_name"): - lines.append(f"**Package:** {dep_meta['package_name']}") - if dep_meta.get("package_ecosystem"): - lines.append(f"**Ecosystem:** {dep_meta['package_ecosystem']}") - if dep_meta.get("installed_version"): - lines.append(f"**Installed Version:** {dep_meta['installed_version']}") - if dep_meta.get("fixed_version"): - lines.append(f"**Fixed Version:** {dep_meta['fixed_version']}") - if vuln.get("endpoint"): - lines.append(f"**Endpoint:** {vuln['endpoint']}") - if vuln.get("method"): - lines.append(f"**Method:** {vuln['method']}") - if vuln.get("cve"): - lines.append(f"**CVE:** {vuln['cve']}") - if vuln.get("cwe"): - lines.append(f"**CWE:** {vuln['cwe']}") - if vuln.get("cvss") is not None: - lines.append(f"**CVSS:** {vuln['cvss']}") - if vuln.get("fix_effort"): - lines.append(f"**Fix Effort:** {str(vuln['fix_effort']).title()}") - - cvss_breakdown = vuln.get("cvss_breakdown", {}) - if cvss_breakdown: - abbrevs = { - "attack_vector": "AV", - "attack_complexity": "AC", - "privileges_required": "PR", - "user_interaction": "UI", - "scope": "S", - "confidentiality": "C", - "integrity": "I", - "availability": "A", - } - parts = [ - f"{abbrevs.get(k, k)}:{v}" for k, v in cvss_breakdown.items() if v and k in abbrevs - ] - if parts: - lines.append(f"**CVSS Vector:** {'/'.join(parts)}") - - lines.append("") - lines.append("## Description") - lines.append("") - lines.append(vuln.get("description") or "No description provided.") - - if vuln.get("impact"): - lines.extend(["", "## Impact", "", vuln["impact"]]) - - if vuln.get("technical_analysis"): - lines.extend(["", "## Technical Analysis", "", vuln["technical_analysis"]]) - - if vuln.get("evidence"): - lines.extend(["", "## Evidence", "", vuln["evidence"]]) - - if vuln.get("poc_description") or vuln.get("poc_script_code"): - lines.extend(["", "## Proof of Concept", ""]) - if vuln.get("poc_description"): - lines.append(vuln["poc_description"]) - lines.append("") - if vuln.get("poc_script_code"): - poc_language, poc_code = parse_fenced_code(vuln["poc_script_code"]) - fence_lang = poc_language or guess_language_name(poc_code) - fence = safe_fence(poc_code) - lines.append(f"{fence}{fence_lang}") - lines.append(poc_code) - lines.append(fence) - - if vuln.get("code_locations"): - lines.extend(["", "## Code Analysis", ""]) - for i, loc in enumerate(vuln["code_locations"]): - file_ref = loc.get("file", "unknown") - line_ref = "" - if loc.get("start_line") is not None: - if loc.get("end_line") and loc["end_line"] != loc["start_line"]: - line_ref = f" (lines {loc['start_line']}-{loc['end_line']})" - else: - line_ref = f" (line {loc['start_line']})" - lines.append(f"**Location {i + 1}:** `{file_ref}`{line_ref}") - if loc.get("label"): - lines.append(f" {loc['label']}") - if loc.get("snippet"): - snippet = str(loc["snippet"]) - snippet_fence = safe_fence(snippet) - lines.append(f"{snippet_fence}\n{snippet}\n{snippet_fence}") - if loc.get("fix_before") or loc.get("fix_after"): - lines.append("**Suggested Fix:**") - lines.append("```diff") - if loc.get("fix_before"): - lines.extend(f"- {line}" for line in loc["fix_before"].splitlines()) - if loc.get("fix_after"): - lines.extend(f"+ {line}" for line in loc["fix_after"].splitlines()) - lines.append("```") - lines.append("") - - if vuln.get("remediation_steps"): - lines.extend(["", "## Remediation", "", vuln["remediation_steps"]]) - - if vuln.get("assumptions"): - lines.extend(["", "## Assumptions", "", vuln["assumptions"]]) - - lines.append("") - return "\n".join(lines) - - def on_key(self, event: events.Key) -> None: - if event.key == "escape": - self.app.pop_screen() - event.prevent_default() - - def on_button_pressed(self, event: Button.Pressed) -> None: - if event.button.id == "copy_vuln_detail": - markdown_text = self._get_markdown_report() - self.app.copy_to_clipboard(markdown_text) - - copy_button = self.query_one("#copy_vuln_detail", Button) - copy_button.label = "Copied!" - self.set_timer(1.5, lambda: setattr(copy_button, "label", "Copy")) - elif event.button.id == "close_vuln_detail": - self.app.pop_screen() - - -class VulnerabilityItem(Static): # type: ignore[misc] - def __init__(self, label: Text, vuln_data: dict[str, Any], **kwargs: Any) -> None: - super().__init__(label, **kwargs) - self.vuln_data = vuln_data - - def on_click(self, _event: events.Click) -> None: - """Handle click to open vulnerability detail.""" - self.app.push_screen(VulnerabilityDetailScreen(self.vuln_data)) - - -class VulnerabilitiesPanel(VerticalScroll): # type: ignore[misc] - SEVERITY_COLORS: ClassVar[dict[str, str]] = { - "critical": "#dc2626", # Red - "high": "#ea580c", # Orange - "medium": "#d97706", # Amber - "low": "#22c55e", # Green - "info": "#3b82f6", # Blue - } - - def __init__(self, *args: Any, **kwargs: Any) -> None: - super().__init__(*args, **kwargs) - self._vulnerabilities: list[dict[str, Any]] = [] - - def compose(self) -> ComposeResult: - return [] - - def update_vulnerabilities(self, vulnerabilities: list[dict[str, Any]]) -> None: - """Update the list of vulnerabilities and re-render.""" - if self._vulnerabilities == vulnerabilities: - return - self._vulnerabilities = list(vulnerabilities) - self._render_panel() - - def _render_panel(self) -> None: - """Render the vulnerabilities panel content.""" - for child in list(self.children): - if isinstance(child, VulnerabilityItem): - child.remove() - - if not self._vulnerabilities: - return - - for vuln in self._vulnerabilities: - severity = vuln.get("severity", "info").lower() - title = vuln.get("title", "Unknown Vulnerability") - color = self.SEVERITY_COLORS.get(severity, "#3b82f6") - - label = Text() - label.append("● ", style=Style(color=color)) - label.append(title, style=Style(color="#d4d4d4")) - - item = VulnerabilityItem(label, vuln, classes="vuln-item") - self.mount(item) - - -class QuitScreen(ModalScreen): # type: ignore[misc] - def compose(self) -> ComposeResult: - yield Grid( - Label("Quit Strix?", id="quit_title"), - Grid( - Button("Yes", variant="error", id="quit"), - Button("No", variant="default", id="cancel"), - id="quit_buttons", - ), - id="quit_dialog", - ) - - def on_mount(self) -> None: - cancel_button = self.query_one("#cancel", Button) - cancel_button.focus() - - def on_key(self, event: events.Key) -> None: - if event.key in ("left", "right", "up", "down"): - focused = self.focused - - if focused and focused.id == "quit": - cancel_button = self.query_one("#cancel", Button) - cancel_button.focus() - else: - quit_button = self.query_one("#quit", Button) - quit_button.focus() - - event.prevent_default() - elif event.key == "enter": - focused = self.focused - if focused and isinstance(focused, Button): - focused.press() - event.prevent_default() - elif event.key == "escape": - self.app.pop_screen() - event.prevent_default() - - async def on_button_pressed(self, event: Button.Pressed) -> None: - if event.button.id == "quit": - await self.app.action_custom_quit() - else: - self.app.pop_screen() - - -class StrixTUIApp(App): # type: ignore[misc] - CSS_PATH = str(Path(__file__).resolve().parent.parent / "assets" / "tui_styles.tcss") - ALLOW_SELECT = True - - SIDEBAR_MIN_WIDTH = 120 - - selected_agent_id: reactive[str | None] = reactive(default=None) - show_splash: reactive[bool] = reactive(default=True) - - BINDINGS: ClassVar[list[Binding]] = [ - Binding("f1", "toggle_help", "Help", priority=True), - Binding("ctrl+q", "request_quit", "Quit", priority=True), - Binding("ctrl+c", "request_quit", "Quit", priority=True), - Binding("escape", "stop_selected_agent", "Stop Agent", priority=True), - Binding("ctrl+o", "open_viewer", "Open Viewer", priority=True), - ] - - def __init__(self, args: argparse.Namespace): - super().__init__() - self.args = args - self.scan_config = self._build_scan_config(args) - - self.report_state = ReportState(self.scan_config["run_name"]) - self.report_state.hydrate_from_run_dir() - self.report_state.set_scan_config(self.scan_config) - self.report_state.save_run_data() - set_global_report_state(self.report_state) - self.live_view = TuiLiveView() - self.live_view.hydrate_from_run_dir(self.report_state.get_run_dir()) - self._agent_graph_sync_future: Any | None = None - - from strix.core.agents import AgentCoordinator - - self.coordinator = AgentCoordinator() - - self.agent_nodes: dict[str, TreeNode] = {} - - self._displayed_agents: set[str] = set() - self._displayed_events: list[str] = [] - - self._scan_thread: threading.Thread | None = None - self._viewer_httpd: Any = None - self._viewer_url: str | None = None - self._scan_loop: asyncio.AbstractEventLoop | None = None - self._scan_stop_event = threading.Event() - self._scan_completed = threading.Event() - self._scan_error: BaseException | None = None - self._error_noted_agents: set[str] = set() - self._budget_pause_notified = False - - self._spinner_frame_index: int = 0 - self._sweep_num_squares: int = 6 - self._sweep_colors: list[str] = [ - "#000000", # Dimmest (shows dot) - "#031a09", - "#052e16", - "#0d4a2a", - "#15803d", - "#22c55e", - "#4ade80", - "#86efac", # Brightest - ] - self._dot_animation_timer: Any | None = None - self._pending_scroll_end = False - - self._setup_cleanup_handlers() - - def _build_scan_config(self, args: argparse.Namespace) -> dict[str, Any]: - return { - "scan_id": args.run_name, - "targets": args.targets_info, - "user_instructions": args.instruction or "", - "run_name": args.run_name, - "diff_scope": getattr(args, "diff_scope", {"active": False}), - "scan_mode": getattr(args, "scan_mode", "deep"), - "non_interactive": bool(getattr(args, "non_interactive", False)), - "local_sources": getattr(args, "local_sources", None) or [], - "scope_mode": getattr(args, "scope_mode", "auto"), - "diff_base": getattr(args, "diff_base", None), - "resume_instruction": getattr(args, "user_explicit_instruction", None) or "", - } - - def _setup_cleanup_handlers(self) -> None: - def cleanup_on_exit() -> None: - self.report_state.cleanup() - - def signal_handler(_signum: int, _frame: Any) -> None: - self._fire_sandbox_cleanup() - self.report_state.cleanup(status="interrupted") - sys.exit(0) - - atexit.register(cleanup_on_exit) - signal.signal(signal.SIGINT, signal_handler) - signal.signal(signal.SIGTERM, signal_handler) - if hasattr(signal, "SIGHUP"): - signal.signal(signal.SIGHUP, signal_handler) - - def compose(self) -> ComposeResult: - if self.show_splash: - yield SplashScreen(id="splash_screen") - - def watch_show_splash(self, show_splash: bool) -> None: - if not show_splash and self.is_mounted: - try: - splash = self.query_one("#splash_screen") - splash.remove() - except ValueError: - pass - - main_container = Vertical(id="main_container") - - self.mount(main_container) - - content_container = Horizontal(id="content_container") - main_container.mount(content_container) - - chat_area_container = Vertical(id="chat_area_container") - - chat_display = Static("", id="chat_display") - chat_history = VerticalScroll(chat_display, id="chat_history") - chat_history.can_focus = True - - status_text = Static("", id="status_text") - status_text.ALLOW_SELECT = False - keymap_indicator = Static("", id="keymap_indicator") - keymap_indicator.ALLOW_SELECT = False - - agent_status_display = Horizontal( - status_text, keymap_indicator, id="agent_status_display", classes="hidden" - ) - - chat_prompt = Static("> ", id="chat_prompt") - chat_prompt.ALLOW_SELECT = False - chat_input = ChatTextArea( - "", - id="chat_input", - show_line_numbers=False, - ) - chat_input.set_app_reference(self) - chat_input_container = Horizontal(chat_prompt, chat_input, id="chat_input_container") - - agents_tree = Tree("Agents", id="agents_tree") - agents_tree.root.expand() - agents_tree.show_root = False - - agents_tree.show_guide = True - agents_tree.guide_depth = 3 - agents_tree.guide_style = "dashed" - - stats_display = Static("", id="stats_display") - stats_scroll = VerticalScroll(stats_display, id="stats_scroll") - - vulnerabilities_panel = VulnerabilitiesPanel(id="vulnerabilities_panel") - - viewer_cta = Static(self._viewer_cta_markup(), id="viewer_cta") - viewer_cta.ALLOW_SELECT = False - - sidebar = Vertical( - viewer_cta, agents_tree, vulnerabilities_panel, stats_scroll, id="sidebar" - ) - - content_container.mount(chat_area_container) - content_container.mount(sidebar) - - chat_area_container.mount(chat_history) - chat_area_container.mount(agent_status_display) - chat_area_container.mount(chat_input_container) - - self.call_after_refresh(self._focus_chat_input) - - def _focus_chat_input(self) -> None: - if len(self.screen_stack) > 1 or self.show_splash: - return - - if not self.is_mounted: - return - - try: - chat_input = self.query_one("#chat_input", ChatTextArea) - chat_input.show_vertical_scrollbar = False - chat_input.show_horizontal_scrollbar = False - chat_input.focus() - except (ValueError, Exception): - self.call_after_refresh(self._focus_chat_input) - - def _focus_agents_tree(self) -> None: - if len(self.screen_stack) > 1 or self.show_splash: - return - - if not self.is_mounted: - return - - try: - agents_tree = self.query_one("#agents_tree", Tree) - agents_tree.focus() - - if agents_tree.root.children: - first_node = agents_tree.root.children[0] - agents_tree.select_node(first_node) - except (ValueError, Exception): - self.call_after_refresh(self._focus_agents_tree) - - def on_mount(self) -> None: - self.title = "strix" - - self.set_timer(4.5, self._hide_splash_screen) - - def _hide_splash_screen(self) -> None: - self.show_splash = False - - self._start_scan_thread() - - self.set_interval(0.5, self._update_ui) - - def _update_ui(self) -> None: - if self.show_splash: - return - - if len(self.screen_stack) > 1: - return - - if not self.is_mounted: - return - - try: - chat_history = self.query_one("#chat_history", VerticalScroll) - agents_tree = self.query_one("#agents_tree", Tree) - - if not self._is_widget_safe(chat_history) or not self._is_widget_safe(agents_tree): - return - except (ValueError, Exception): - return - - self._sync_agent_graph() - - for agent_id, agent_data in list(self.live_view.agents.items()): - if agent_id not in self._displayed_agents: - self._add_agent_node(agent_data) - self._displayed_agents.add(agent_id) - else: - self._update_agent_node(agent_id, agent_data) - - self._update_chat_view() - - self._update_agent_status_display() - - self._update_stats_display() - - self._update_vulnerabilities_panel() - - def _sync_agent_graph(self) -> None: - future = self._agent_graph_sync_future - if future is not None: - if not future.done(): - if self._scan_loop is not None and self._scan_loop.is_closed(): - future.cancel() - self._agent_graph_sync_future = None - else: - return - else: - self._agent_graph_sync_future = None - try: - parent_of, statuses, names, errors = future.result() - except Exception: - logger.exception("TUI agent graph sync failed") - else: - for agent_id, status in statuses.items(): - error = errors.get(agent_id) - self.live_view.upsert_agent( - agent_id, - name=names.get(agent_id, agent_id), - parent_id=parent_of.get(agent_id), - status=status, - error_message=error, - ) - if status in {"failed", "crashed"} and error: - if agent_id not in self._error_noted_agents: - self._error_noted_agents.add(agent_id) - self.live_view.record_agent_error(agent_id, error) - else: - self._error_noted_agents.discard(agent_id) - self._notify_budget_pause(statuses) - - if self._scan_loop is None or self._scan_loop.is_closed(): - return - - async def collect() -> tuple[ - dict[str, str | None], dict[str, Any], dict[str, str], dict[str, str] - ]: - return await self.coordinator.graph_snapshot() - - self._agent_graph_sync_future = asyncio.run_coroutine_threadsafe(collect(), self._scan_loop) - - def _notify_budget_pause(self, statuses: dict[str, Any]) -> None: - paused = any(status == "budget_paused" for status in statuses.values()) - if paused and not self._budget_pause_notified: - self._budget_pause_notified = True - self.notify( - "Budget limit reached \u2014 agents paused. Send a message to continue " - "(this extends the budget), or ctrl-q to quit.", - severity="warning", - timeout=15, - ) - elif not paused: - self._budget_pause_notified = False - - def _update_agent_node(self, agent_id: str, agent_data: dict[str, Any]) -> bool: - if agent_id not in self.agent_nodes: - return False - - try: - agent_node = self.agent_nodes[agent_id] - agent_name_raw = agent_data.get("name", "Agent") - status = agent_data.get("status", "running") - - status_indicators = { - "running": "⚪", - "waiting": "⏸", - "budget_paused": "⏸", - "completed": "🟢", - "failed": "🔴", - "crashed": "🔴", - "stopped": "■", - } - - status_icon = status_indicators.get(status, "○") - vuln_count = self._agent_vulnerability_count(agent_id) - vuln_indicator = f" ({vuln_count})" if vuln_count > 0 else "" - agent_name = f"{status_icon} {agent_name_raw}{vuln_indicator}" - - if agent_node.label != agent_name: - agent_node.set_label(agent_name) - return True - - except (KeyError, AttributeError, ValueError) as e: - logger.warning(f"Failed to update agent node label: {e}") - - return False - - def _get_chat_content( - self, - ) -> tuple[Any, str | None]: - if not self.selected_agent_id: - return self._get_chat_placeholder_content("Loading...", "placeholder-no-agent") - - events = self._gather_agent_events(self.selected_agent_id) - - if not events: - return self._get_chat_placeholder_content( - "Starting agent...", "placeholder-no-activity" - ) - - current_event_ids = [f"{e['id']}:{e.get('version', 0)}" for e in events] - if current_event_ids == self._displayed_events: - return None, None - - self._displayed_events = current_event_ids - return self._get_rendered_events_content(events), "chat-content" - - def _update_chat_view(self) -> None: - if len(self.screen_stack) > 1 or self.show_splash or not self.is_mounted: - return - - try: - chat_history = self.query_one("#chat_history", VerticalScroll) - except (ValueError, Exception): - return - - if not self._is_widget_safe(chat_history): - return - - try: - is_at_bottom = chat_history.scroll_y >= chat_history.max_scroll_y - except (AttributeError, ValueError): - is_at_bottom = True - - content, css_class = self._get_chat_content() - if content is None: - return - - chat_display = self.query_one("#chat_display", Static) - self._safe_widget_operation(chat_display.update, content) - chat_display.set_classes(css_class) - - if is_at_bottom and not self._pending_scroll_end: - self._pending_scroll_end = True - self.call_later(self._do_scroll_end, chat_history) - - def _do_scroll_end(self, chat_history: VerticalScroll) -> None: - self._pending_scroll_end = False - try: - chat_history.scroll_end(animate=False) - except Exception: - logger.debug("Failed to scroll chat to end", exc_info=True) - - def _get_chat_placeholder_content( - self, message: str, placeholder_class: str - ) -> tuple[Text, str]: - self._displayed_events = [placeholder_class] - text = Text() - text.append(message) - return text, f"chat-placeholder {placeholder_class}" - - @staticmethod - def _merge_renderables(renderables: list[Any]) -> Text: - """Merge renderables into a single Text for mouse text selection support.""" - combined = Text() - for i, item in enumerate(renderables): - if i > 0: - combined.append("\n") - StrixTUIApp._append_renderable(combined, item) - return StrixTUIApp._sanitize_text(combined) - - @staticmethod - def _sanitize_text(text: Text) -> Text: - """Clamp spans so Rich/Textual can't crash on malformed offsets.""" - plain = text.plain - text_length = len(plain) - sanitized_spans: list[Span] = [] - - for span in text.spans: - start = max(0, min(span.start, text_length)) - end = max(0, min(span.end, text_length)) - if end > start: - sanitized_spans.append(Span(start, end, span.style)) - - return Text( - plain, - style=text.style, - justify=text.justify, - overflow=text.overflow, - no_wrap=text.no_wrap, - end=text.end, - tab_size=text.tab_size, - spans=sanitized_spans, - ) - - @staticmethod - def _append_renderable(combined: Text, item: Any) -> None: - """Recursively append a renderable's text content to a combined Text.""" - if isinstance(item, Text): - combined.append_text(StrixTUIApp._sanitize_text(item)) - elif isinstance(item, Group): - for j, sub in enumerate(item.renderables): - if j > 0: - combined.append("\n") - StrixTUIApp._append_renderable(combined, sub) - else: - inner = getattr(item, "content", None) or getattr(item, "renderable", None) - if inner is not None: - StrixTUIApp._append_renderable(combined, inner) - else: - combined.append(str(item)) - - def _get_rendered_events_content(self, events: list[dict[str, Any]]) -> Any: - renderables: list[Any] = [] - - if not events: - return Text() - - for event in events: - content: Any = None - - if event["type"] == "chat": - content = self._render_chat_content(event["data"]) - elif event["type"] == "tool": - content = render_tool_widget(event["data"]) - - if content: - if renderables: - renderables.append(Text("")) - renderables.append(content) - - if not renderables: - return Text() - - if len(renderables) == 1 and isinstance(renderables[0], Text): - return self._sanitize_text(renderables[0]) - - return self._merge_renderables(renderables) - - def _get_status_display_content( - self, agent_id: str, agent_data: dict[str, Any] - ) -> tuple[Text | None, Text, bool]: - status = agent_data.get("status", "running") - - def keymap_styled(keys: list[tuple[str, str]]) -> Text: - t = Text() - for i, (key, action) in enumerate(keys): - if i > 0: - t.append(" · ", style="dim") - t.append(key, style="white") - t.append(" ", style="dim") - t.append(action, style="dim") - return t - - simple_statuses: dict[str, tuple[str, str]] = { - "stopped": ("Agent stopped", ""), - "completed": ("Agent completed", ""), - } - - if status in simple_statuses: - msg, _ = simple_statuses[status] - text = Text() - text.append(msg) - return (text, Text(), False) - - if status in {"failed", "crashed"}: - error_msg = agent_data.get("error_message", "") - text = Text() - text.append(error_msg or "Agent failed", style="red") - text.append(" · ", style="dim") - text.append("Send message to resume", style="dim") - self._stop_dot_animation() - return (text, Text(), False) - - if status in {"waiting", "budget_paused"}: - text = Text() - keymap = Text() - if status == "budget_paused": - text.append("Budget limit reached", style="yellow") - text.append(" \u00b7 ", style="dim") - text.append("Send a message to continue", style="dim") - keymap = keymap_styled([("ctrl-q", "quit")]) - else: - text.append("Send message to resume", style="dim") - return (text, keymap, False) - - if status == "running": - if self._agent_has_real_activity(agent_id): - animated_text = Text() - animated_text.append_text(self._get_sweep_animation(self._sweep_colors)) - animated_text.append("esc", style="white") - animated_text.append(" ", style="dim") - animated_text.append("stop", style="dim") - return (animated_text, keymap_styled([("ctrl-q", "quit")]), True) - animated_text = self._get_animated_verb_text(agent_id, "Initializing") - return (animated_text, keymap_styled([("ctrl-q", "quit")]), True) - - return (None, Text(), False) - - def _update_agent_status_display(self) -> None: - try: - status_display = self.query_one("#agent_status_display", Horizontal) - status_text = self.query_one("#status_text", Static) - keymap_indicator = self.query_one("#keymap_indicator", Static) - except (ValueError, Exception): - return - - widgets = [status_display, status_text, keymap_indicator] - if not all(self._is_widget_safe(w) for w in widgets): - return - - if not self.selected_agent_id: - self._safe_widget_operation(status_display.add_class, "hidden") - return - - try: - agent_data = self.live_view.agents[self.selected_agent_id] - content, keymap, should_animate = self._get_status_display_content( - self.selected_agent_id, agent_data - ) - - if not content: - self._safe_widget_operation(status_display.add_class, "hidden") - return - - self._safe_widget_operation(status_text.update, content) - self._safe_widget_operation(keymap_indicator.update, keymap) - self._safe_widget_operation(status_display.remove_class, "hidden") - - if should_animate: - self._start_dot_animation() - - except (KeyError, Exception): - self._safe_widget_operation(status_display.add_class, "hidden") - - def _update_stats_display(self) -> None: - try: - stats_display = self.query_one("#stats_display", Static) - except (ValueError, Exception): - return - - if not self._is_widget_safe(stats_display): - return - - if self.screen.selections: - return - - stats_content = Text() - - stats_text = build_tui_stats_text(self.report_state) - if stats_text: - stats_content.append(stats_text) - - version = get_package_version() - stats_content.append(f"\nv{version}", style="white") - - self._safe_widget_operation(stats_display.update, stats_content) - - def _update_vulnerabilities_panel(self) -> None: - """Update the vulnerabilities panel with current vulnerability data.""" - try: - vuln_panel = self.query_one("#vulnerabilities_panel", VulnerabilitiesPanel) - except (ValueError, Exception): - return - - if not self._is_widget_safe(vuln_panel): - return - - vulnerabilities = self.report_state.vulnerability_reports - - if not vulnerabilities: - self._safe_widget_operation(vuln_panel.add_class, "hidden") - return - - enriched_vulns = [] - for vuln in vulnerabilities: - enriched = dict(vuln) - agent_name = enriched.get("agent_name") - agent_id = enriched.get("agent_id") - if not agent_name and isinstance(agent_id, str): - agent_name = self._get_agent_name(agent_id) - if agent_name: - enriched["agent_name"] = agent_name - enriched_vulns.append(enriched) - - self._safe_widget_operation(vuln_panel.remove_class, "hidden") - vuln_panel.update_vulnerabilities(enriched_vulns) - - def _get_sweep_animation(self, color_palette: list[str]) -> Text: - text = Text() - num_squares = self._sweep_num_squares - num_colors = len(color_palette) - - offset = num_colors - 1 - max_pos = (num_squares - 1) + offset - total_range = max_pos + offset - cycle_length = total_range * 2 - frame_in_cycle = self._spinner_frame_index % cycle_length - - wave_pos = total_range - abs(total_range - frame_in_cycle) - sweep_pos = wave_pos - offset - - dot_color = "#0a3d1f" - - for i in range(num_squares): - dist = abs(i - sweep_pos) - color_idx = max(0, num_colors - 1 - dist) - - if color_idx == 0: - text.append("·", style=Style(color=dot_color)) - else: - color = color_palette[color_idx] - text.append("▪", style=Style(color=color)) - - text.append(" ") - return text - - def _get_animated_verb_text(self, agent_id: str, verb: str) -> Text: # noqa: ARG002 - text = Text() - sweep = self._get_sweep_animation(self._sweep_colors) - text.append_text(sweep) - parts = verb.split(" ", 1) - text.append(parts[0], style="white") - if len(parts) > 1: - text.append(" ", style="dim") - text.append(parts[1], style="dim") - return text - - def _start_dot_animation(self) -> None: - if self._dot_animation_timer is None: - self._dot_animation_timer = self.set_interval(0.06, self._animate_dots) - - def _stop_dot_animation(self) -> None: - if self._dot_animation_timer is not None: - self._dot_animation_timer.stop() - self._dot_animation_timer = None - - def _animate_dots(self) -> None: - has_active_agents = False - - if self.selected_agent_id and self.selected_agent_id in self.live_view.agents: - agent_data = self.live_view.agents[self.selected_agent_id] - status = agent_data.get("status", "running") - if status in ["running", "waiting"]: - has_active_agents = True - num_colors = len(self._sweep_colors) - offset = num_colors - 1 - max_pos = (self._sweep_num_squares - 1) + offset - total_range = max_pos + offset - cycle_length = total_range * 2 - self._spinner_frame_index = (self._spinner_frame_index + 1) % cycle_length - self._update_agent_status_display() - - if not has_active_agents: - has_active_agents = any( - agent_data.get("status", "running") in ["running", "waiting"] - for agent_data in self.live_view.agents.values() - ) - - if not has_active_agents: - self._stop_dot_animation() - self._spinner_frame_index = 0 - - def _agent_has_real_activity(self, agent_id: str) -> bool: - return self.live_view.has_events_for_agent(agent_id) - - def _agent_vulnerability_count(self, agent_id: str) -> int: - return sum( - 1 - for vuln in self.report_state.vulnerability_reports - if vuln.get("agent_id") == agent_id - ) - - def _gather_agent_events(self, agent_id: str) -> list[dict[str, Any]]: - events = self.live_view.events_for_agent(agent_id) - events.sort(key=lambda e: (e["timestamp"], e["id"])) - return events - - def watch_selected_agent_id(self, _agent_id: str | None) -> None: - if len(self.screen_stack) > 1 or self.show_splash: - return - - if not self.is_mounted: - return - - self._displayed_events.clear() - - self.call_later(self._update_chat_view) - self._update_agent_status_display() - - def _start_scan_thread(self) -> None: - def scan_target() -> None: - try: - loop = asyncio.new_event_loop() - asyncio.set_event_loop(loop) - self._scan_loop = loop - - try: - if not self._scan_stop_event.is_set(): - image = load_settings().runtime.image or "strix-sandbox:latest" - loop.run_until_complete( - run_strix_scan( - scan_config=self.scan_config, - scan_id=self.scan_config["run_name"], - image=str(image), - local_sources=getattr(self.args, "local_sources", None) or [], - coordinator=self.coordinator, - interactive=True, - max_budget_usd=getattr(self.args, "max_budget_usd", None), - max_turns=getattr(self.args, "max_turns", DEFAULT_MAX_TURNS), - event_sink=self._capture_sdk_event, - ), - ) - - except (KeyboardInterrupt, asyncio.CancelledError): - logger.info("Scan interrupted by user") - except BudgetExceededError: - logger.info("Scan stopped: --max-budget limit reached") - except (ConnectionError, TimeoutError) as e: - logging.exception("Network error during scan") - self._scan_error = e - except RuntimeError as e: - logging.exception("Runtime error during scan") - self._scan_error = e - except Exception as e: - logging.exception("Unexpected error during scan") - self._scan_error = e - finally: - with contextlib.suppress(Exception): - loop.run_until_complete( - session_manager.cleanup(self.scan_config["run_name"]), - ) - loop.close() - self._scan_completed.set() - - except Exception: - logging.exception("Error setting up scan thread") - self._scan_completed.set() - - self._scan_thread = threading.Thread(target=scan_target, daemon=True) - self._scan_thread.start() - - def _capture_sdk_event(self, agent_id: str, event: Any) -> None: - try: - self.call_from_thread(self._record_sdk_event, agent_id, event) - except RuntimeError: - self._record_sdk_event(agent_id, event) - - def _record_sdk_event(self, agent_id: str, event: Any) -> None: - self.live_view.ingest_sdk_event(agent_id, event) - - def _add_agent_node(self, agent_data: dict[str, Any]) -> None: - if len(self.screen_stack) > 1 or self.show_splash: - return - - if not self.is_mounted: - return - - agent_id = agent_data["id"] - parent_id = agent_data.get("parent_id") - status = agent_data.get("status", "running") - - try: - agents_tree = self.query_one("#agents_tree", Tree) - except (ValueError, Exception): - return - - agent_name_raw = agent_data.get("name", "Agent") - - status_indicators = { - "running": "⚪", - "waiting": "⏸", - "budget_paused": "⏸", - "completed": "🟢", - "failed": "🔴", - "crashed": "🔴", - "stopped": "■", - } - - status_icon = status_indicators.get(status, "○") - vuln_count = self._agent_vulnerability_count(agent_id) - vuln_indicator = f" ({vuln_count})" if vuln_count > 0 else "" - agent_name = f"{status_icon} {agent_name_raw}{vuln_indicator}" - - try: - if parent_id and parent_id in self.agent_nodes: - parent_node = self.agent_nodes[parent_id] - agent_node = parent_node.add( - agent_name, - data={"agent_id": agent_id}, - ) - parent_node.allow_expand = True - else: - agent_node = agents_tree.root.add( - agent_name, - data={"agent_id": agent_id}, - ) - - agent_node.allow_expand = False - agent_node.expand() - self.agent_nodes[agent_id] = agent_node - - if len(self.agent_nodes) == 1: - agents_tree.select_node(agent_node) - self.selected_agent_id = agent_id - - self._reorganize_orphaned_agents(agent_id) - except (AttributeError, ValueError, RuntimeError) as e: - logger.warning(f"Failed to add agent node {agent_id}: {e}") - - def _copy_node_under(self, node_to_copy: TreeNode, new_parent: TreeNode) -> None: - agent_id = node_to_copy.data["agent_id"] - agent_data = self.live_view.agents.get(agent_id, {}) - agent_name_raw = agent_data.get("name", "Agent") - status = agent_data.get("status", "running") - - status_indicators = { - "running": "⚪", - "waiting": "⏸", - "budget_paused": "⏸", - "completed": "🟢", - "failed": "🔴", - "crashed": "🔴", - "stopped": "■", - } - - status_icon = status_indicators.get(status, "○") - vuln_count = self._agent_vulnerability_count(agent_id) - vuln_indicator = f" ({vuln_count})" if vuln_count > 0 else "" - agent_name = f"{status_icon} {agent_name_raw}{vuln_indicator}" - - new_node = new_parent.add( - agent_name, - data=node_to_copy.data, - ) - new_node.allow_expand = node_to_copy.allow_expand - - self.agent_nodes[agent_id] = new_node - - for child in node_to_copy.children: - self._copy_node_under(child, new_node) - - if node_to_copy.is_expanded: - new_node.expand() - - def _reorganize_orphaned_agents(self, new_parent_id: str) -> None: - agents_to_move = [] - - for agent_id, agent_data in list(self.live_view.agents.items()): - if ( - agent_data.get("parent_id") == new_parent_id - and agent_id in self.agent_nodes - and agent_id != new_parent_id - ): - agents_to_move.append(agent_id) - - if not agents_to_move: - return - - parent_node = self.agent_nodes[new_parent_id] - - for child_agent_id in agents_to_move: - if child_agent_id in self.agent_nodes: - old_node = self.agent_nodes[child_agent_id] - - if old_node.parent is parent_node: - continue - - self._copy_node_under(old_node, parent_node) - - old_node.remove() - - parent_node.allow_expand = True - parent_node.expand() - - def _render_chat_content(self, msg_data: dict[str, Any]) -> Any: - role = msg_data.get("role") - content = msg_data.get("content", "") - metadata = msg_data.get("metadata", {}) - - if not content: - return None - - del metadata - if role == "user": - return UserMessageRenderer.render_simple(content) - - return AgentMessageRenderer.render_simple(content) - - @on(Tree.NodeHighlighted) # type: ignore[misc] - def handle_tree_highlight(self, event: Tree.NodeHighlighted) -> None: - if len(self.screen_stack) > 1 or self.show_splash: - return - - if not self.is_mounted: - return - - node = event.node - - try: - agents_tree = self.query_one("#agents_tree", Tree) - except (ValueError, Exception): - return - - if self.focused == agents_tree and node.data: - agent_id = node.data.get("agent_id") - if agent_id: - self.selected_agent_id = agent_id - - @on(Tree.NodeSelected) # type: ignore[misc] - def handle_tree_node_selected(self, event: Tree.NodeSelected) -> None: - if len(self.screen_stack) > 1 or self.show_splash: - return - - if not self.is_mounted: - return - - node = event.node - - if node.allow_expand: - if node.is_expanded: - node.collapse() - else: - node.expand() - - def _send_user_message(self, message: str) -> None: - if not self.selected_agent_id: - return - - logger.info( - "TUI: user message -> %s (len=%d)", - self.selected_agent_id, - len(message), - ) - target_agent_id = self.selected_agent_id - - submitted = send_user_message_to_agent( - coordinator=self.coordinator, - loop=self._scan_loop, - live_view=self.live_view, - target_agent_id=target_agent_id, - message=message, - ) - if not submitted: - if self._scan_completed.is_set(): - self.notify("The scan has ended; message was not sent", severity="warning") - else: - self.notify("Scan loop is not ready; message was not sent", severity="warning") - return - - self._displayed_events.clear() - self._update_chat_view() - - self.call_after_refresh(self._focus_chat_input) - - def _get_agent_name(self, agent_id: str) -> str: - try: - if agent_id in self.live_view.agents: - agent_name = self.live_view.agents[agent_id].get("name") - if isinstance(agent_name, str): - return agent_name - except (KeyError, AttributeError) as e: - logger.warning(f"Could not retrieve agent name for {agent_id}: {e}") - return "Unknown Agent" - - def action_toggle_help(self) -> None: - if self.show_splash or not self.is_mounted: - return - - try: - self.query_one("#main_container") - except (ValueError, Exception): - return - - if isinstance(self.screen, HelpScreen): - self.pop_screen() - return - - if len(self.screen_stack) > 1: - return - - self.push_screen(HelpScreen()) - - async def action_request_quit(self) -> None: - if self.show_splash or not self.is_mounted: - await self.action_custom_quit() - return - - if len(self.screen_stack) > 1: - return - - try: - self.query_one("#main_container") - except (ValueError, Exception): - await self.action_custom_quit() - return - - self.push_screen(QuitScreen()) - - def action_stop_selected_agent(self) -> None: - if self.show_splash or not self.is_mounted: - return - - if len(self.screen_stack) > 1: - self.pop_screen() - return - - if not self.selected_agent_id: - return - - agent_name, should_stop = self._validate_agent_for_stopping() - if not should_stop: - return - - try: - self.query_one("#main_container") - except (ValueError, Exception): - return - - self.push_screen(StopAgentScreen(agent_name, self.selected_agent_id)) - - def _validate_agent_for_stopping(self) -> tuple[str, bool]: - agent_name = "Unknown Agent" - - try: - if self.selected_agent_id in self.live_view.agents: - agent_data = self.live_view.agents[self.selected_agent_id] - agent_name = agent_data.get("name", "Unknown Agent") - - agent_status = agent_data.get("status", "running") - if agent_status not in ["running", "waiting"]: - return agent_name, False - - agent_events = self._gather_agent_events(self.selected_agent_id) - if not agent_events: - return agent_name, False - - return agent_name, True - - except (KeyError, AttributeError, ValueError) as e: - logger.warning(f"Failed to gather agent events: {e}") - - return agent_name, False - - def action_confirm_stop_agent(self, agent_id: str) -> None: - if self._scan_loop is None or self._scan_loop.is_closed(): - logger.warning("No active scan loop; cannot stop agent %s", agent_id) - return - logger.info("TUI: graceful stop requested for %s (cascade)", agent_id) - asyncio.run_coroutine_threadsafe( - self.coordinator.cancel_descendants_graceful(agent_id), - self._scan_loop, - ) - - async def action_custom_quit(self) -> None: - self._fire_sandbox_cleanup() - self._shutdown_viewer() - - if self._scan_thread and self._scan_thread.is_alive(): - self._scan_stop_event.set() - - self.report_state.cleanup() - - self.exit() - - def _viewer_cta_markup(self, url: str | None = None) -> str: - if url: - return f"[@click=app.open_viewer][#22c55e]● Viewer running[/][/]\n[dim]{url}[/]" - return "[@click=app.open_viewer]▶ Watch live in browser[/]" - - def _set_viewer_cta(self, markup: str) -> None: - with contextlib.suppress(Exception): - self.query_one("#viewer_cta", Static).update(markup) - - def action_open_viewer(self) -> None: - if self._viewer_url: - with contextlib.suppress(Exception): - webbrowser.open(self._viewer_url) - return - try: - from strix.interface.viewer.server import authorized_url, bundle_is_built, serve - - if not bundle_is_built(): - self._set_viewer_cta("[#eab308]Viewer UI not built[/]") - return - run_dir = self.report_state.get_run_dir() - - def _viewer_steer(agent_id: str, message: str) -> bool: - # Reuse the exact TUI delivery path, but target the agent the - # web graph selected (not the TUI's current selection). - return send_user_message_to_agent( - coordinator=self.coordinator, - loop=self._scan_loop, - live_view=self.live_view, - target_agent_id=agent_id, - message=message, - ) - - httpd, url, token = serve(run_dir, open_browser=True, steer_handler=_viewer_steer) - except Exception: - logger.debug("failed to start local viewer", exc_info=True) - self._set_viewer_cta("[red]Viewer failed to start[/]") - return - self._viewer_httpd = httpd - # Store the tokened URL so reopening the CTA re-authorizes the browser - # (this viewer carries a steer handler, so the session is required). - self._viewer_url = authorized_url(url, token) - self._set_viewer_cta(self._viewer_cta_markup(self._viewer_url)) - - with contextlib.suppress(Exception): - from strix.telemetry import posthog - - live = self.report_state.run_record.get("status") not in { - "completed", - "stopped", - "failed", - "interrupted", - } - posthog.viewer_opened(source="tui", live=live) - - def _shutdown_viewer(self) -> None: - httpd = self._viewer_httpd - if httpd is None: - return - self._viewer_httpd = None - with contextlib.suppress(Exception): - httpd.shutdown() - httpd.server_close() - - def _fire_sandbox_cleanup(self) -> None: - self.coordinator.mark_shutting_down() - loop = self._scan_loop - if loop is None or loop.is_closed(): - return - run_name = self.scan_config.get("run_name") - if not run_name: - return - with contextlib.suppress(Exception): - asyncio.run_coroutine_threadsafe(session_manager.cleanup(run_name), loop) - - def _is_widget_safe(self, widget: Any) -> bool: - try: - _ = widget.screen - except (AttributeError, ValueError, Exception): - return False - else: - return bool(widget.is_mounted) - - def _safe_widget_operation( - self, operation: Callable[..., Any], *args: Any, **kwargs: Any - ) -> bool: - try: - operation(*args, **kwargs) - except (AttributeError, ValueError, Exception): - return False - else: - return True - - def on_resize(self, event: events.Resize) -> None: - if self.show_splash or not self.is_mounted: - return - - try: - sidebar = self.query_one("#sidebar", Vertical) - chat_area = self.query_one("#chat_area_container", Vertical) - except (ValueError, Exception): - return - - if event.size.width < self.SIDEBAR_MIN_WIDTH: - sidebar.add_class("-hidden") - chat_area.add_class("-full-width") - else: - sidebar.remove_class("-hidden") - chat_area.remove_class("-full-width") - - def on_mouse_up(self, _event: events.MouseUp) -> None: - self.set_timer(0.05, self._auto_copy_selection) - - _ICON_PREFIXES: ClassVar[tuple[str, ...]] = ( - "🐞 ", - "🌐 ", - "📋 ", - "🧠 ", - "◆ ", - "◇ ", - "◈ ", - "→ ", - "○ ", - "● ", - "✓ ", - "✗ ", - "⚠ ", - "▍ ", - "▍", - "┃ ", - "• ", - ">_ ", - " ", - "<~> ", - "[ ] ", - "[~] ", - "[•] ", - ) - - _DECORATIVE_LINES: ClassVar[frozenset[str]] = frozenset( - { - "● In progress...", - "✓ Done", - "✗ Failed", - "✗ Error", - "○ Unknown", - } - ) - - @staticmethod - def _clean_copied_text(text: str) -> str: - lines = text.split("\n") - cleaned: list[str] = [] - for line in lines: - stripped = line.lstrip() - if stripped in StrixTUIApp._DECORATIVE_LINES: - continue - if stripped and all(c == "─" for c in stripped): - continue - out = line - for prefix in StrixTUIApp._ICON_PREFIXES: - if stripped.startswith(prefix): - leading = line[: len(line) - len(line.lstrip())] - out = leading + stripped[len(prefix) :] - break - cleaned.append(out) - return "\n".join(cleaned) - - def _auto_copy_selection(self) -> None: - copied = False - - try: - if self.screen.selections: - selected = self.screen.get_selected_text() - self.screen.clear_selection() - if selected and selected.strip(): - cleaned = self._clean_copied_text(selected) - self.copy_to_clipboard(cleaned if cleaned.strip() else selected) - copied = True - except Exception: - logger.debug("Failed to copy screen selection", exc_info=True) - - if not copied: - try: - chat_input = self.query_one("#chat_input", ChatTextArea) - selected = chat_input.selected_text - if selected and selected.strip(): - self.copy_to_clipboard(selected) - chat_input.move_cursor(chat_input.cursor_location) - copied = True - except Exception: - logger.debug("Failed to copy chat input selection", exc_info=True) - - if copied: - self.notify("Copied to clipboard", timeout=2) - - -async def run_tui(args: argparse.Namespace) -> None: - app = StrixTUIApp(args) - await app.run_async() - if app._scan_error is not None: - raise app._scan_error diff --git a/strix/interface/tui/backend/__init__.py b/strix/interface/tui/backend/__init__.py new file mode 100644 index 00000000..58120d2a --- /dev/null +++ b/strix/interface/tui/backend/__init__.py @@ -0,0 +1,7 @@ +"""Backend bridge for external TUI clients.""" + +from strix.interface.tui.backend.controller import TuiController +from strix.interface.tui.backend.server import TuiBackendServer + + +__all__ = ["TuiBackendServer", "TuiController"] diff --git a/strix/interface/tui/backend/controller.py b/strix/interface/tui/backend/controller.py new file mode 100644 index 00000000..3784604d --- /dev/null +++ b/strix/interface/tui/backend/controller.py @@ -0,0 +1,497 @@ +"""UI-independent state and command controller for interactive Strix clients.""" + +from __future__ import annotations + +import asyncio +import contextlib +import math +import webbrowser +from collections.abc import Awaitable, Callable +from pathlib import Path +from typing import TYPE_CHECKING, Any + +from strix.config import load_settings +from strix.config.models import is_recommended_or_frontier_model +from strix.config.settings import DEFAULT_MAX_TURNS +from strix.interface.tui.backend.live_view import TuiLiveView +from strix.interface.tui.backend.projection import ( + MAX_TERMINAL_EVENTS, + MAX_TERMINAL_VULNERABILITIES, + SCAN_MODES, + SCOPE_MODES, + bounded_state_projection, + collection_item_projection, + sanitize_terminal_text, + terminal_projection, +) +from strix.interface.utils import is_subscription_run + + +if TYPE_CHECKING: + import argparse + + from strix.report.state import ReportState + + +_STOPPABLE_AGENT_STATUSES = frozenset({"running", "waiting", "budget_paused"}) + +ChangeCallback = Callable[[], None] +StartCallback = Callable[[bool], Awaitable[None]] +QuitCallback = Callable[[], Awaitable[None]] + + +class TuiController: + """Own setup state and expose serializable scan state to any TUI.""" + + def __init__( + self, + args: argparse.Namespace, + *, + live_view: TuiLiveView | None = None, + coordinator: Any = None, + report_state: ReportState | None = None, + on_start: StartCallback | None = None, + on_quit: QuitCallback | None = None, + on_change: ChangeCallback | None = None, + ) -> None: + self.args = args + self.live_view = live_view or TuiLiveView() + self.coordinator = coordinator + self.report_state = report_state + self.scan_loop: asyncio.AbstractEventLoop | None = None + self.setup_mode = bool(args.needs_setup) + self.scan_started = not self.setup_mode + self._start_in_progress = False + self.scan_state = "setup" if self.setup_mode else "running" + self.targets = [ + str(target["original"]) + for target in args.targets_info + if isinstance(target, dict) and target.get("original") + ] + instruction = args.instruction + self.instruction = instruction.strip() if isinstance(instruction, str) else "" + requested_scan_mode = str(args.scan_mode) + self.scan_mode = requested_scan_mode if requested_scan_mode in SCAN_MODES else "deep" + raw_budget = args.max_budget_usd + self.max_budget_usd = ( + float(raw_budget) + if isinstance(raw_budget, int | float) + and not isinstance(raw_budget, bool) + and math.isfinite(float(raw_budget)) + and raw_budget > 0 + else None + ) + raw_turns = args.max_turns + self.max_turns = ( + raw_turns + if isinstance(raw_turns, int) and not isinstance(raw_turns, bool) and raw_turns > 0 + else DEFAULT_MAX_TURNS + ) + requested_scope = str(args.scope_mode) + self.scope_mode = requested_scope if requested_scope in SCOPE_MODES else "auto" + raw_diff_base = args.diff_base + self.diff_base = raw_diff_base.strip() if isinstance(raw_diff_base, str) else None + # Host directory mounted for the agent to work in when the scan has no + # target, set only once the user confirms it. It is a workspace, not a + # target: it carries no scan scope, and the instruction is the only + # source of truth for what to do. + self.workspace_mount: str | None = None + # A target-less launch enters the live view and asks there before + # anything is prepared; this holds the directory awaiting that answer. + self.pending_workspace_mount: str | None = None + self._pending_verify = True + self.messages: list[dict[str, str]] = [] + self._next_message_id = 1 + self.error: str | None = None + self.viewer_status = "idle" + self.viewer_url: str | None = None + self._viewer_httpd: Any = None + self._on_start = on_start + self._on_quit = on_quit + self._on_change = on_change + + def set_change_callback(self, callback: ChangeCallback) -> None: + self._on_change = callback + + def notify_changed(self) -> None: + if self._on_change is not None: + self._on_change() + + def set_runtime( + self, + *, + report_state: ReportState | None = None, + scan_loop: asyncio.AbstractEventLoop | None = None, + ) -> None: + if report_state is not None: + self.report_state = report_state + if scan_loop is not None: + self.scan_loop = scan_loop + + def begin_preparation(self) -> None: + """Mark a directly-launched run as preparing behind the live TUI.""" + self.scan_state = "preparing" + self.notify_changed() + + def fail_preparation(self, detail: str) -> None: + self.scan_state = "failed" + self.error = detail + self.notify_changed() + + def enter_setup(self) -> None: + """Return a session to the start screen, e.g. on a declined mount.""" + self.setup_mode = True + self.scan_started = False + self.scan_state = "setup" + self.notify_changed() + + def add_message(self, text: str, level: str = "info") -> None: + self._append_message(text, level) + self.notify_changed() + + def _append_message(self, text: str, level: str) -> None: + self.messages.append( + { + "id": f"message-{self._next_message_id}", + "text": sanitize_terminal_text(text), + "level": sanitize_terminal_text(level), + } + ) + self._next_message_id += 1 + self.messages = self.messages[-200:] + + def snapshot(self) -> dict[str, Any]: + """Return small mutable state; histories are streamed as collections.""" + model = "" + with contextlib.suppress(Exception): + model = (load_settings().llm.model or "").strip() + usage: dict[str, Any] = {} + if self.report_state is not None: + usage = dict(self.report_state.get_total_llm_usage()) + subscription = False + with contextlib.suppress(Exception): + subscription = is_subscription_run(self.report_state) + model_warning = "" + if model and not is_recommended_or_frontier_model(model): + model_warning = ( + f"{model} is not a recommended frontier model; pentest quality could be degraded" + ) + state = { + "setup_mode": self.setup_mode, + "scan_started": self.scan_started, + "scan_state": self.scan_state, + "targets": [ + terminal_projection(target, max_string=128) for target in self.targets[:16] + ], + "target_count": len(self.targets), + "working_dir": str(Path.cwd()), + "pending_mount": self.pending_workspace_mount or "", + "instruction": terminal_projection(self.instruction, max_string=2 * 1024), + "scan_mode": self.scan_mode, + "max_budget_usd": self.max_budget_usd, + "max_turns": self.max_turns, + "scope_mode": self.scope_mode, + "diff_base": terminal_projection(self.diff_base, max_string=256), + "model": terminal_projection(model, max_string=256), + "model_warning": terminal_projection(model_warning, max_string=512), + "caido_url": terminal_projection( + getattr(self.report_state, "caido_url", None), max_string=1024 + ), + "messages": [ + { + "id": str(message.get("id", ""))[:64], + "text": terminal_projection(message.get("text", ""), max_string=256), + "level": str(message.get("level", "info"))[:32], + } + for message in self.messages[-10:] + ], + "usage": terminal_projection(usage, max_string=256, max_items=20), + "subscription": subscription, + "viewer_status": self.viewer_status, + "viewer_url": terminal_projection(self.viewer_url, max_string=1024), + "error": terminal_projection(self.error, max_string=2 * 1024), + } + return bounded_state_projection(state) + + def collection(self, name: str) -> list[dict[str, Any]]: + """Return one bounded terminal projection with stable item identities.""" + if name == "agents": + return [ + { + key: terminal_projection(agent.get(key), max_string=256, max_items=5) + for key in ( + "id", + "name", + "parent_id", + "status", + "error_message", + "created_at", + "updated_at", + ) + if key in agent + } + for agent in self.live_view.agents.values() + ] + if name == "events": + return [collection_item_projection(event) for event in self.live_view.events] + if name == "vulnerabilities": + reports = ( + self.report_state.vulnerability_reports if self.report_state is not None else [] + )[-MAX_TERMINAL_VULNERABILITIES:] + result: list[dict[str, Any]] = [] + for index, report in enumerate(reports): + projected = collection_item_projection(report) + report_id = projected.get("id") + if not isinstance(report_id, str) or not report_id: + projected["id"] = f"vulnerability-{index}" + result.append(projected) + return result + raise ValueError(f"Unknown collection: {name}") + + def collection_snapshot(self, name: str) -> tuple[int | None, list[dict[str, Any]]]: + """Return a collection cursor and complete bounded projection.""" + if name == "events": + cursor, events = self.live_view.event_snapshot(limit=MAX_TERMINAL_EVENTS) + return cursor, [collection_item_projection(event) for event in events] + return None, self.collection(name) + + def collection_changes( + self, + name: str, + cursor: int, + ) -> tuple[int, list[dict[str, Any]]]: + """Return event upserts since a monotonic source cursor.""" + if name != "events": + raise ValueError(f"Collection {name!r} does not expose incremental changes") + next_cursor, events = self.live_view.event_changes_since(cursor) + return next_cursor, [ + collection_item_projection(event) for event in events[-MAX_TERMINAL_EVENTS:] + ] + + async def handle(self, command: str, payload: dict[str, Any]) -> dict[str, Any]: + handlers = { + "setup.add_target": self._add_target, + "setup.set_instruction": self._set_instruction, + "setup.start": self._start, + "setup.confirm_mount": self._confirm_mount, + "agent.send_message": self._send_message, + "agent.stop": self._stop_agent, + "viewer.open": self._open_viewer, + "app.quit": self._quit, + } + handler = handlers.get(command) + if handler is None: + raise ValueError(f"Unknown command: {command}") + result = await handler(payload) + self.notify_changed() + return result + + async def _add_target(self, payload: dict[str, Any]) -> dict[str, Any]: + self._require_setup_mutable() + target = self._required_string(payload, "target") + if target not in self.targets: + self.targets.append(target) + return {"target": target, "total": len(self.targets)} + + async def _set_instruction(self, payload: dict[str, Any]) -> dict[str, Any]: + self._require_setup_mutable() + instruction = payload.get("instruction", "") + if not isinstance(instruction, str): + raise TypeError("instruction must be a string") + self.instruction = instruction.strip() + return {"instruction": self.instruction} + + async def _start(self, payload: dict[str, Any]) -> dict[str, Any]: + if self.scan_started or self._start_in_progress: + raise RuntimeError("Scan is already starting or running") + # A bare prompt launches optimistically, like a coding agent: it skips + # the network model preflight and surfaces any model error live. A named + # target keeps the preflight so a real scan does not commit blind. + verify = payload.get("verify", True) + if not isinstance(verify, bool): + raise TypeError("verify must be a boolean") + # Launching with no target mounts the working directory, so it requires + # the user's explicit confirmation rather than happening silently. + mount_working_dir = payload.get("mount_working_dir", False) + if not isinstance(mount_working_dir, bool): + raise TypeError("mount_working_dir must be a boolean") + model = (load_settings().llm.model or "").strip() + if not model: + raise ValueError("No model configured. Set STRIX_LLM first.") + if self._on_start is None: + raise RuntimeError("Scan start is unavailable") + if not self.targets: + if not mount_working_dir: + raise ValueError("No target set. Add a target first.") + # Mounting the working directory needs the user's confirmation, and + # that is asked in the live view. Enter it now and prepare nothing + # until the answer arrives, so declining leaves no run behind. + self.pending_workspace_mount = str(Path.cwd()) + self._pending_verify = verify + self.setup_mode = False + self.scan_started = True + self.scan_state = "preparing" + return {"started": True} + await self._begin_scan(verify) + return {"started": True} + + async def _begin_scan(self, verify: bool) -> None: + if self._on_start is None: + raise RuntimeError("Scan start is unavailable") + self._start_in_progress = True + try: + await self._on_start(verify) + finally: + self._start_in_progress = False + self.setup_mode = False + self.scan_started = True + self.scan_state = "running" + + async def _confirm_mount(self, payload: dict[str, Any]) -> dict[str, Any]: + """Answer the pending working-directory mount asked for in the live view.""" + mount = self.pending_workspace_mount + if mount is None: + raise RuntimeError("No mount confirmation is pending") + approved = payload.get("approved") + if not isinstance(approved, bool): + raise TypeError("approved must be a boolean") + self.pending_workspace_mount = None + if not approved: + # Nothing was prepared, so return to the start screen untouched. + self.workspace_mount = None + self.enter_setup() + return {"approved": False} + self.workspace_mount = mount + await self._begin_scan(self._pending_verify) + return {"approved": True} + + async def _send_message(self, payload: dict[str, Any]) -> dict[str, Any]: + agent_id = self._required_string(payload, "agent_id") + message = self._required_string(payload, "message") + if self.coordinator is None: + raise RuntimeError("Agent coordinator is unavailable") + if self.scan_loop is None or self.scan_loop.is_closed(): + raise RuntimeError("Scan loop is not ready") + self.live_view.record_user_message(agent_id, message) + if self.scan_loop is asyncio.get_running_loop(): + delivered = await self.coordinator.send( + agent_id, + {"from": "user", "content": message, "type": "instruction"}, + ) + else: + future = asyncio.run_coroutine_threadsafe( + self.coordinator.send( + agent_id, + {"from": "user", "content": message, "type": "instruction"}, + ), + self.scan_loop, + ) + delivered = await asyncio.wrap_future(future) + if not delivered: + raise RuntimeError("Message could not be delivered") + return {"sent": True} + + async def _stop_agent(self, payload: dict[str, Any]) -> dict[str, Any]: + agent_id = self._required_string(payload, "agent_id") + agent = self.live_view.agents.get(agent_id) + if agent is None: + raise ValueError(f"Unknown agent: {agent_id}") + status = str(agent.get("status", "")) + if status not in _STOPPABLE_AGENT_STATUSES: + raise RuntimeError(f"Agent '{agent_id}' cannot be stopped while {status or 'unknown'}") + if self.coordinator is None or self.scan_loop is None or self.scan_loop.is_closed(): + raise RuntimeError("Scan loop is not ready") + if self.scan_loop is asyncio.get_running_loop(): + accepted = await self.coordinator.cancel_descendants_graceful(agent_id) + else: + future = asyncio.run_coroutine_threadsafe( + self.coordinator.cancel_descendants_graceful(agent_id), self.scan_loop + ) + accepted = await asyncio.wrap_future(future) + if not accepted: + raise RuntimeError(f"Agent '{agent_id}' is no longer active") + return {"stopped": True} + + async def _open_viewer(self, _payload: dict[str, Any]) -> dict[str, Any]: + if self.viewer_url: + with contextlib.suppress(Exception): + webbrowser.open(self.viewer_url) + return {"status": "running", "url": self.viewer_url} + if self.report_state is None: + self.viewer_status = "failed" + return {"status": self.viewer_status, "error": "Scan output is not ready"} + try: + from strix.interface.tui.backend.messages import ( + send_user_message_to_agent, + ) + from strix.interface.viewer.server import ( + authorized_url, + bundle_is_built, + serve, + ) + + if not bundle_is_built(): + self.viewer_status = "unavailable" + return {"status": self.viewer_status, "error": "Viewer UI not built"} + + def steer(agent_id: str, message: str) -> bool: + return send_user_message_to_agent( + coordinator=self.coordinator, + loop=self.scan_loop, + live_view=self.live_view, + target_agent_id=agent_id, + message=message, + notify_changed=self.notify_changed, + wait_for_delivery=True, + ) + + httpd, url, token = serve( + self.report_state.get_run_dir(), + open_browser=True, + steer_handler=steer, + ) + self._viewer_httpd = httpd + self.viewer_url = authorized_url(url, token) + self.viewer_status = "running" + with contextlib.suppress(Exception): + from strix.telemetry import posthog + + live = self.report_state.run_record.get("status") not in { + "completed", + "stopped", + "failed", + "interrupted", + } + posthog.viewer_opened(source="tui", live=live) + except Exception: # noqa: BLE001 - viewer startup failures must not crash the TUI + self.viewer_status = "failed" + return {"status": self.viewer_status, "error": "Viewer failed to start"} + else: + return {"status": self.viewer_status, "url": self.viewer_url} + + def close_viewer(self) -> None: + httpd = self._viewer_httpd + if httpd is None: + return + self._viewer_httpd = None + with contextlib.suppress(Exception): + httpd.shutdown() + httpd.server_close() + + async def _quit(self, _payload: dict[str, Any]) -> dict[str, Any]: + self.close_viewer() + if self._on_quit is not None: + await self._on_quit() + self.scan_state = "stopped" + return {"quitting": True} + + @staticmethod + def _required_string(payload: dict[str, Any], name: str) -> str: + value = payload.get(name) + if not isinstance(value, str) or not value.strip(): + raise ValueError(f"{name} must be a non-empty string") + return value.strip() + + def _require_setup_mutable(self) -> None: + if not self.setup_mode or self.scan_started or self._start_in_progress: + raise RuntimeError("Setup can no longer be changed after the scan starts") diff --git a/strix/interface/tui/backend/live_view.py b/strix/interface/tui/backend/live_view.py new file mode 100644 index 00000000..bc12c034 --- /dev/null +++ b/strix/interface/tui/backend/live_view.py @@ -0,0 +1,136 @@ +"""Go-TUI event projection layered on the shared base projection.""" + +from __future__ import annotations + +from datetime import UTC, datetime +from typing import Any + +from strix.interface.tui.live_view import TuiLiveView as BaseLiveView + + +_MAX_LIVE_EVENTS = 10_000 + + +class TuiLiveView(BaseLiveView): + """Add protocol cursors and bounds on top of the shared projection state.""" + + def __init__(self) -> None: + super().__init__() + self._event_cursor = 0 + self._event_change_cursor: dict[str, int] = {} + self._events_by_id: dict[str, dict[str, Any]] = {} + + def upsert_agent( # type: ignore[override] + self, + agent_id: str, + *, + name: str | None = None, + parent_id: str | None = None, + status: str | None = None, + error_message: str | None = None, + ) -> bool: + now = datetime.now(UTC).isoformat() + current = self.agents.get(agent_id) + if current is None: + current = { + "id": agent_id, + "name": name or agent_id, + "parent_id": parent_id, + "status": status or "running", + "created_at": now, + "updated_at": now, + } + if error_message: + current["error_message"] = error_message + self.agents[agent_id] = current + return True + + changed = False + if name is not None and current.get("name") != name: + current["name"] = name + changed = True + if (parent_id is not None or "parent_id" not in current) and current.get( + "parent_id" + ) != parent_id: + current["parent_id"] = parent_id + changed = True + if status is not None and current.get("status") != status: + current["status"] = status + changed = True + if error_message and current.get("error_message") != error_message: + current["error_message"] = error_message + changed = True + if changed: + current["updated_at"] = now + return changed + + def _append_event( + self, + agent_id: str, + event_type: str, + data: dict[str, Any], + *, + timestamp: str | None = None, + ) -> dict[str, Any]: + event = super()._append_event( + agent_id, + event_type, + data, + timestamp=timestamp, + ) + self._events_by_id[event["id"]] = event + self._mark_event_changed(event) + if len(self.events) > _MAX_LIVE_EVENTS: + removed = self.events.pop(0) + removed_id = str(removed.get("id", "")) + self._events_by_id.pop(removed_id, None) + self._event_change_cursor.pop(removed_id, None) + self._open_assistant_event_by_agent = { + current_agent_id: current + for current_agent_id, current in self._open_assistant_event_by_agent.items() + if current is not removed + } + self._tool_event_by_agent_and_call_id = { + key: current + for key, current in self._tool_event_by_agent_and_call_id.items() + if current is not removed + } + return event + + def _bump_event( # type: ignore[override] + self, + event: dict[str, Any], + *, + timestamp: str | None = None, + ) -> None: + event["version"] = int(event.get("version", 0)) + 1 + event["timestamp"] = timestamp or datetime.now(UTC).isoformat() + self._mark_event_changed(event) + + def _mark_event_changed(self, event: dict[str, Any]) -> None: + event_id = event.get("id") + if not isinstance(event_id, str) or not event_id: + return + self._event_cursor += 1 + self._event_change_cursor[event_id] = self._event_cursor + + def event_snapshot(self, *, limit: int | None = None) -> tuple[int, list[dict[str, Any]]]: + events = self.events[-limit:] if limit is not None else self.events + return self._event_cursor, list(events) + + def event_changes_since(self, cursor: int) -> tuple[int, list[dict[str, Any]]]: + if cursor < 0 or cursor > self._event_cursor: + raise ValueError("event cursor is outside the available history") + changed_ids = sorted( + ( + (change_cursor, event_id) + for event_id, change_cursor in self._event_change_cursor.items() + if change_cursor > cursor + ) + ) + changed = [ + self._events_by_id[event_id] + for _change_cursor, event_id in changed_ids + if event_id in self._events_by_id + ] + return self._event_cursor, changed diff --git a/strix/interface/tui/backend/messages.py b/strix/interface/tui/backend/messages.py new file mode 100644 index 00000000..77bc8bf2 --- /dev/null +++ b/strix/interface/tui/backend/messages.py @@ -0,0 +1,61 @@ +"""Confirmed message delivery for non-Textual interactive clients.""" + +from __future__ import annotations + +import asyncio +import logging +from typing import TYPE_CHECKING, Any + + +if TYPE_CHECKING: + from collections.abc import Callable + + +logger = logging.getLogger(__name__) + + +def send_user_message_to_agent( + *, + coordinator: Any, + loop: asyncio.AbstractEventLoop | None, + live_view: Any, + target_agent_id: str, + message: str, + notify_changed: Callable[[], None] | None = None, + wait_for_delivery: bool = False, +) -> bool: + if loop is None or loop.is_closed(): + return False + + async def deliver() -> bool: + delivered = bool( + await coordinator.send( + target_agent_id, + {"from": "user", "content": message, "type": "instruction"}, + ) + ) + if delivered: + live_view.record_user_message(target_agent_id, message) + if notify_changed is not None: + notify_changed() + return delivered + + future = asyncio.run_coroutine_threadsafe(deliver(), loop) + if wait_for_delivery: + try: + return bool(future.result(timeout=10)) + except Exception: + logger.exception("TUI user message delivery failed") + return False + future.add_done_callback(_log_delivery_failure) + return True + + +def _log_delivery_failure(future: Any) -> None: + try: + delivered = bool(future.result()) + except Exception: + logger.exception("TUI user message delivery failed") + return + if not delivered: + logger.warning("TUI user message was not persisted to the SDK session") diff --git a/strix/interface/tui/backend/projection.py b/strix/interface/tui/backend/projection.py new file mode 100644 index 00000000..22fa957e --- /dev/null +++ b/strix/interface/tui/backend/projection.py @@ -0,0 +1,182 @@ +"""Wire-safe projections of runtime state for the TUI backend.""" + +from __future__ import annotations + +import json +import re +from typing import Any + + +SCAN_MODES = ("quick", "standard", "deep") +SCOPE_MODES = ("auto", "diff", "full") +MAX_PROJECTION_STRING = 64 * 1024 +MAX_IMAGE_DATA_URI_BYTES = 2 * 1024 * 1024 +MAX_COLLECTION_ITEM_BYTES = 512 * 1024 +MAX_TERMINAL_EVENTS = 5_000 +MAX_TERMINAL_VULNERABILITIES = 1_000 +STATE_TARGET_BYTES = 48 * 1024 +TERMINAL_ESCAPE_RE = re.compile(r"\x1b\][^\x07\x1b]*(?:\x07|\x1b\\)|\x1b[@-_][0-?]*[ -/]*[@-~]") + + +def sanitize_terminal_text(value: str) -> str: + without_escapes = TERMINAL_ESCAPE_RE.sub("", value) + return "".join( + character + for character in without_escapes + if character in "\n\t" or (ord(character) >= 32 and not 127 <= ord(character) <= 159) + ) + + +def terminal_projection( # noqa: PLR0911 + value: Any, + *, + max_string: int = MAX_PROJECTION_STRING, + max_items: int = 200, + depth: int = 0, +) -> Any: + """Copy and bound terminal-only data without changing durable history.""" + if isinstance(value, str): + if value.startswith("data:image/"): + if len(value) <= MAX_IMAGE_DATA_URI_BYTES: + return value + return "[image omitted from terminal projection]" + clean = sanitize_terminal_text(value) + if len(clean) <= max_string: + return clean + omitted = len(clean) - max_string + return f"{clean[:max_string]}\n...[{omitted} characters omitted from terminal projection]" + if value is None or isinstance(value, bool | int | float): + return value + if depth >= 8: + return "[nested value omitted from terminal projection]" + if isinstance(value, dict): + items = list(value.items()) + projected = { + sanitize_terminal_text(str(key)): terminal_projection( + item, + max_string=max_string, + max_items=max_items, + depth=depth + 1, + ) + for key, item in items[:max_items] + } + if len(items) > max_items: + projected["_projection_notice"] = ( + f"{len(items) - max_items} fields omitted from terminal projection" + ) + return projected + if isinstance(value, list | tuple): + projected_items = [ + terminal_projection( + item, + max_string=max_string, + max_items=max_items, + depth=depth + 1, + ) + for item in value[:max_items] + ] + if len(value) > max_items: + projected_items.append( + f"[{len(value) - max_items} items omitted from terminal projection]" + ) + return projected_items + return terminal_projection( + str(value), + max_string=max_string, + max_items=max_items, + depth=depth, + ) + + +def collection_item_projection(item: dict[str, Any]) -> dict[str, Any]: + # Image data URIs are exempt from string truncation, so grant them their + # own byte budget on top of the regular per-item budget. + item_budget = MAX_COLLECTION_ITEM_BYTES + MAX_IMAGE_DATA_URI_BYTES + projected = terminal_projection(item) + assert isinstance(projected, dict) + if len(json.dumps(projected, default=str, separators=(",", ":")).encode()) <= item_budget: + return projected + + projected = terminal_projection(item, max_string=8 * 1024, max_items=40) + assert isinstance(projected, dict) + projected["projection_truncated"] = True + if len(json.dumps(projected, default=str, separators=(",", ":")).encode()) <= item_budget: + return projected + + # Preserve identity and useful summary fields even for pathological nested + # tool output or finding evidence. + compact: dict[str, Any] = { + key: terminal_projection(item[key], max_string=8 * 1024, max_items=10) + for key in ( + "id", + "version", + "type", + "agent_id", + "timestamp", + "title", + "severity", + "description", + ) + if key in item + } + compact["projection_truncated"] = True + return compact + + +def bounded_state_projection(state: dict[str, Any]) -> dict[str, Any]: + """Keep mutable control state comfortably below the 64 KiB frame limit.""" + + def encoded_size(value: dict[str, Any]) -> int: + return len( + json.dumps(value, default=str, ensure_ascii=False, separators=(",", ":")).encode() + ) + + if encoded_size(state) <= STATE_TARGET_BYTES: + return state + + state["projection_truncated"] = True + state["targets"] = [ + terminal_projection(target, max_string=64) for target in state["targets"][:8] + ] + state["instruction"] = terminal_projection(state["instruction"], max_string=512) + state["messages"] = [ + { + **message, + "text": terminal_projection(message.get("text", ""), max_string=128), + } + for message in state["messages"][-5:] + ] + state["usage"] = {} + state["error"] = terminal_projection(state["error"], max_string=512) + state["model_warning"] = terminal_projection(state["model_warning"], max_string=256) + state["caido_url"] = terminal_projection(state["caido_url"], max_string=256) + state["viewer_url"] = terminal_projection(state["viewer_url"], max_string=256) + if encoded_size(state) <= STATE_TARGET_BYTES: + return state + + # Defensive final projection: use an explicit schema so future snapshot + # fields cannot silently bypass the aggregate byte budget. + return { + "setup_mode": state["setup_mode"], + "scan_started": state["scan_started"], + "scan_state": state["scan_state"], + "targets": state["targets"][:4], + "target_count": state["target_count"], + "instruction": terminal_projection(state["instruction"], max_string=128), + "scan_mode": state["scan_mode"], + "max_budget_usd": state["max_budget_usd"], + "max_turns": state["max_turns"], + "scope_mode": state["scope_mode"], + "diff_base": state["diff_base"], + "provider": state["provider"], + "model": state["model"], + "model_warning": "", + "caido_url": None, + "messages": [], + "usage": {}, + "subscription": state["subscription"], + "viewer_status": state["viewer_status"], + "viewer_url": None, + "error": terminal_projection(state["error"], max_string=256), + "projection_truncated": True, + } diff --git a/strix/interface/tui/backend/protocol.py b/strix/interface/tui/backend/protocol.py new file mode 100644 index 00000000..99da5823 --- /dev/null +++ b/strix/interface/tui/backend/protocol.py @@ -0,0 +1,40 @@ +"""Versioned JSON protocol shared with the Go TUI.""" + +from __future__ import annotations + +from typing import Any + + +PROTOCOL_VERSION = 3 +PROTOCOL_CAPABILITIES = ( + "state-revisions", + "collection-deltas", + "structured-command-errors", + "agents-collection", +) + +# Commands and control messages are intentionally small. Event and finding +# history uses a separate bounded collection stream so a resumed run can be +# larger than any individual frame. +MAX_COMMAND_BYTES = 64 * 1024 +MAX_COLLECTION_FRAME_BYTES = 4 * 1024 * 1024 + + +class ProtocolHandshakeError(RuntimeError): + """Raised before the Go TUI is activated when v3 negotiation fails.""" + + +def envelope( + message_type: str, + payload: dict[str, Any], + *, + request_id: str | None = None, +) -> dict[str, Any]: + message: dict[str, Any] = { + "version": PROTOCOL_VERSION, + "type": message_type, + "payload": payload, + } + if request_id: + message["request_id"] = request_id + return message diff --git a/strix/interface/tui/backend/server.py b/strix/interface/tui/backend/server.py new file mode 100644 index 00000000..f884b3b6 --- /dev/null +++ b/strix/interface/tui/backend/server.py @@ -0,0 +1,531 @@ +"""Private framed IPC connection used by the Go TUI.""" + +from __future__ import annotations + +import asyncio +import contextlib +import json +import logging +import struct +from collections import deque +from dataclasses import dataclass, field +from typing import TYPE_CHECKING, Any + +from strix.interface.tui.backend.projection import sanitize_terminal_text +from strix.interface.tui.backend.protocol import ( + MAX_COLLECTION_FRAME_BYTES, + MAX_COMMAND_BYTES, + PROTOCOL_CAPABILITIES, + PROTOCOL_VERSION, + ProtocolHandshakeError, + envelope, +) + + +if TYPE_CHECKING: + import socket + + from strix.interface.tui.backend.controller import TuiController + +logger = logging.getLogger(__name__) + +_HEADER = struct.Struct(">I") +_HANDSHAKE_TIMEOUT = 10.0 +_COLLECTIONS = ("agents", "events", "vulnerabilities") +_COLLECTION_ITEM_LIMITS = {"events": 5_000, "vulnerabilities": 1_000} +# Leave enough room for the collection envelope and cursor metadata. +_COLLECTION_PAYLOAD_TARGET = MAX_COLLECTION_FRAME_BYTES - 16 * 1024 + + +class _MessageTooLargeError(ValueError): + pass + + +@dataclass +class _CollectionState: + revision: int = 0 + bootstrapped: bool = False + order: list[str] = field(default_factory=list) + items: dict[str, dict[str, Any]] = field(default_factory=dict) + fingerprints: dict[str, str] = field(default_factory=dict) + source_cursor: int | None = None + + +class TuiBackendServer: + """Serve one TUI child over an authenticated, connected socket.""" + + def __init__(self, controller: TuiController) -> None: + self.controller = controller + self._socket: socket.socket | None = None + self._reader_task: asyncio.Task[None] | None = None + self._broadcast_event = asyncio.Event() + self._broadcast_task: asyncio.Task[None] | None = None + self._write_lock = asyncio.Lock() + self._sync_lock = asyncio.Lock() + self._state_revision = 0 + self._state_fingerprint = "" + self._collections = {name: _CollectionState() for name in _COLLECTIONS} + self._seen_request_ids: set[str] = set() + self._request_id_order: deque[str] = deque() + self.activated = False + controller.set_change_callback(self.notify_changed) + + async def start(self, connection: socket.socket) -> None: + """Negotiate protocol v3 before activating command or state traffic.""" + if self._socket is not None: + raise RuntimeError("TUI backend is already started") + connection.setblocking(False) # noqa: FBT003 + self._socket = connection + try: + await self._send(envelope("hello", {"capabilities": list(PROTOCOL_CAPABILITIES)})) + await asyncio.wait_for(self._receive_ready(), timeout=_HANDSHAKE_TIMEOUT) + except TimeoutError as exc: + raise ProtocolHandshakeError("Timed out waiting for TUI protocol ready") from exc + except (EOFError, ConnectionError, OSError) as exc: + raise ProtocolHandshakeError(f"TUI closed during protocol handshake: {exc}") from exc + except (TypeError, ValueError, json.JSONDecodeError, UnicodeDecodeError) as exc: + raise ProtocolHandshakeError(str(exc)) from exc + + self.activated = True + self._reader_task = asyncio.create_task(self._read_loop()) + self._broadcast_task = asyncio.create_task(self._broadcast_loop()) + self.notify_changed() + + async def close(self) -> None: + tasks = [task for task in (self._reader_task, self._broadcast_task) if task is not None] + for task in tasks: + task.cancel() + for task in tasks: + if task is asyncio.current_task(): + continue + with contextlib.suppress(asyncio.CancelledError): + await task + self._reader_task = None + self._broadcast_task = None + self._close_socket() + + def _close_socket(self) -> None: + if self._socket is not None: + self._socket.close() + self._socket = None + + def notify_changed(self) -> None: + if self.activated: + self._broadcast_event.set() + + async def _read_exactly(self, size: int) -> bytes: + connection = self._socket + if connection is None: + raise ConnectionError("TUI IPC connection is closed") + loop = asyncio.get_running_loop() + chunks: list[bytes] = [] + remaining = size + while remaining: + chunk = await loop.sock_recv(connection, remaining) + if not chunk: + raise EOFError("TUI IPC peer closed") + chunks.append(chunk) + remaining -= len(chunk) + return b"".join(chunks) + + async def _read_frame(self, maximum: int) -> bytes: + (size,) = _HEADER.unpack(await self._read_exactly(_HEADER.size)) + if size == 0 or size > maximum: + # Reject the length before allocating or reading its payload. + raise ConnectionError(f"invalid TUI IPC frame size: {size}") + return await self._read_exactly(size) + + async def _receive_ready(self) -> None: + raw = await self._read_frame(MAX_COMMAND_BYTES) + message = json.loads(raw.decode("utf-8")) + if not isinstance(message, dict): + raise TypeError("TUI ready message must be an object") + if message.get("version") != PROTOCOL_VERSION: + raise ValueError( + f"TUI protocol mismatch: expected v{PROTOCOL_VERSION}, " + f"received v{message.get('version')}" + ) + if message.get("type") != "ready": + raise ValueError("TUI protocol handshake expected ready") + payload = message.get("payload") + if not isinstance(payload, dict): + raise TypeError("TUI ready payload must be an object") + capabilities = payload.get("capabilities") + if capabilities != list(PROTOCOL_CAPABILITIES): + raise ValueError("TUI protocol capability mismatch") + + async def _read_loop(self) -> None: + try: + while True: + raw = await self._read_frame(MAX_COMMAND_BYTES) + response, resync = await self._handle_message(raw) + if response is not None: + await self._send_command_response(response) + if resync is not None: + await self._resync_collection(resync) + except asyncio.CancelledError: + raise + except (EOFError, ConnectionError, OSError): + self._close_socket() + + @staticmethod + def _decode_message(raw: bytes) -> tuple[str, str, dict[str, object]]: + message = json.loads(raw.decode("utf-8")) + if not isinstance(message, dict): + raise TypeError("message must be an object") + request_id = message.get("request_id") + if not isinstance(request_id, str) or not request_id: + raise ValueError("command request_id must be a non-empty string") + if message.get("version") != PROTOCOL_VERSION: + raise ValueError(f"unsupported protocol version; expected {PROTOCOL_VERSION}") + command = message.get("type") + payload = message.get("payload", {}) + if not isinstance(command, str) or not isinstance(payload, dict): + raise TypeError("invalid command envelope") + if len(command) > 128: + raise ValueError("command name exceeds 128 characters") + return request_id, command, payload + + @staticmethod + def _structured_error(exc: Exception) -> dict[str, object]: + if isinstance(exc, OSError): + return {"code": "persistence_error", "message": str(exc), "retryable": True} + if isinstance(exc, TypeError | ValueError | json.JSONDecodeError | UnicodeDecodeError): + return {"code": "invalid_request", "message": str(exc), "retryable": False} + if isinstance(exc, RuntimeError): + return {"code": "command_failed", "message": str(exc), "retryable": False} + logger.exception("Unhandled TUI command error", exc_info=exc) + return { + "code": "internal_error", + "message": "The command failed unexpectedly", + "retryable": True, + } + + async def _handle_message(self, raw: bytes) -> tuple[dict[str, Any] | None, str | None]: + request_id: str | None = None + command = "" + resync: str | None = None + try: + preliminary = json.loads(raw.decode("utf-8")) + if isinstance(preliminary, dict): + raw_request_id = preliminary.get("request_id") + if isinstance(raw_request_id, str) and raw_request_id: + request_id = raw_request_id + raw_command = preliminary.get("type") + if isinstance(raw_command, str): + command = raw_command[:128] + request_id, command, payload = self._decode_message(raw) + if request_id in self._seen_request_ids: + raise ValueError(f"duplicate request_id: {request_id}") # noqa: TRY301 + self._seen_request_ids.add(request_id) + self._request_id_order.append(request_id) + if len(self._request_id_order) > 10_000: + self._seen_request_ids.discard(self._request_id_order.popleft()) + if command == "collection.resync": + collection = payload.get("collection") + if not isinstance(collection, str) or collection not in _COLLECTIONS: + choices = ", ".join(_COLLECTIONS) + raise ValueError(f"collection must be one of: {choices}") # noqa: TRY301 + result: dict[str, Any] = {"collection": collection, "resyncing": True} + resync = collection + else: + result = await self.controller.handle(command, payload) + response = envelope( + "command_result", + {"ok": True, "command": command, "result": result}, + request_id=request_id, + ) + except Exception as exc: # noqa: BLE001 - command failures are protocol results + if request_id is None: + # A malformed envelope without an ID cannot be correlated. Keep + # the reader alive and wait for the next valid command. + logger.warning("Ignoring uncorrelatable TUI command: %s", exc) + return None, None + response = envelope( + "command_result", + { + "ok": False, + "command": command, + "error": self._structured_error(exc), + }, + request_id=request_id, + ) + return response, resync + + def _encode(self, message: dict[str, Any]) -> bytes: + raw = json.dumps( + self._sanitize_wire_value(message), + default=str, + ensure_ascii=False, + separators=(",", ":"), + ).encode("utf-8") + maximum = ( + MAX_COLLECTION_FRAME_BYTES + if message.get("type") in {"collection_bootstrap", "collection_delta"} + else MAX_COMMAND_BYTES + ) + if len(raw) > maximum: + raise _MessageTooLargeError(f"TUI IPC message exceeds {maximum} bytes") + return raw + + @classmethod + def _sanitize_wire_value(cls, value: Any) -> Any: + if isinstance(value, str): + return sanitize_terminal_text(value) + if isinstance(value, dict): + return { + sanitize_terminal_text(str(key)): cls._sanitize_wire_value(item) + for key, item in value.items() + } + if isinstance(value, list): + return [cls._sanitize_wire_value(item) for item in value] + if isinstance(value, tuple): + return [cls._sanitize_wire_value(item) for item in value] + return value + + async def _send(self, message: dict[str, Any]) -> None: + connection = self._socket + if connection is None: + raise ConnectionError("TUI IPC connection is closed") + raw = self._encode(message) + framed = _HEADER.pack(len(raw)) + raw + async with self._write_lock: + await asyncio.get_running_loop().sock_sendall(connection, framed) + + async def _send_command_response(self, response: dict[str, Any]) -> None: + try: + await self._send(response) + except _MessageTooLargeError: + request_id = response.get("request_id") + payload = response.get("payload") + command = payload.get("command", "") if isinstance(payload, dict) else "" + await self._send( + envelope( + "command_result", + { + "ok": False, + "command": command, + "error": { + "code": "result_too_large", + "message": "Command result exceeds the terminal frame limit", + "retryable": False, + }, + }, + request_id=request_id if isinstance(request_id, str) else None, + ) + ) + + @staticmethod + def _fingerprint(value: Any) -> str: + return json.dumps(value, default=str, sort_keys=True, separators=(",", ":")) + + async def _send_state_if_changed(self) -> None: + state = self.controller.snapshot() + fingerprint = self._fingerprint(state) + if fingerprint == self._state_fingerprint: + return + revision = self._state_revision + 1 + await self._send(envelope("state", {"revision": revision, "state": state})) + self._state_revision = revision + self._state_fingerprint = fingerprint + + @staticmethod + def _collection_values( + items: list[dict[str, Any]], + ) -> tuple[list[str], dict[str, dict[str, Any]], dict[str, str]]: + order: list[str] = [] + by_id: dict[str, dict[str, Any]] = {} + fingerprints: dict[str, str] = {} + for item in items: + item_id = item.get("id") + if not isinstance(item_id, str) or not item_id: + continue + order.append(item_id) + by_id[item_id] = item + fingerprints[item_id] = TuiBackendServer._fingerprint(item) + return order, by_id, fingerprints + + async def _send_collection_frames( + self, + message_type: str, + fixed: dict[str, Any], + field_name: str, + values: list[dict[str, Any]], + ) -> None: + cursor = 0 + if not values: + payload = {**fixed, "cursor": 0, "next_cursor": 0, "done": True, field_name: []} + await self._send(envelope(message_type, payload)) + return + + while cursor < len(values): + chunk: list[dict[str, Any]] = [] + next_cursor = cursor + empty_payload = { + **fixed, + "cursor": cursor, + "next_cursor": cursor, + "done": False, + field_name: [], + } + estimated_size = len( + json.dumps( + envelope(message_type, empty_payload), + default=str, + separators=(",", ":"), + ).encode("utf-8") + ) + while next_cursor < len(values): + item = values[next_cursor] + item_size = len( + json.dumps(item, default=str, separators=(",", ":")).encode("utf-8") + ) + if estimated_size + item_size + 1 > _COLLECTION_PAYLOAD_TARGET and chunk: + break + chunk.append(item) + estimated_size += item_size + 1 + next_cursor += 1 + payload = { + **fixed, + "cursor": cursor, + "next_cursor": next_cursor, + "done": next_cursor == len(values), + field_name: chunk, + } + await self._send(envelope(message_type, payload)) + cursor = next_cursor + + async def _send_collection_bootstrap( + self, + name: str, + items: list[dict[str, Any]] | None = None, + ) -> None: + state = self._collections[name] + source_cursor: int | None = None + if items is None: + source_cursor, projected = self.controller.collection_snapshot(name) + else: + projected = items + order, by_id, fingerprints = self._collection_values(projected) + revision = state.revision + 1 + await self._send_collection_frames( + "collection_bootstrap", + {"collection": name, "revision": revision}, + "items", + [by_id[item_id] for item_id in order], + ) + state.revision = revision + state.bootstrapped = True + state.order = order + state.items = by_id + state.fingerprints = fingerprints + state.source_cursor = source_cursor + + async def _send_collection_if_changed(self, name: str) -> None: + state = self._collections[name] + if name == "events" and state.bootstrapped and state.source_cursor is not None: + next_cursor, changed = self.controller.collection_changes( + name, + state.source_cursor, + ) + if next_cursor == state.source_cursor: + return + operations: list[dict[str, Any]] = [] + for item in changed: + item_id = item.get("id") + if not isinstance(item_id, str) or not item_id: + continue + operations.append({"op": "upsert", "item": item}) + if item_id not in state.items: + state.order.append(item_id) + state.items[item_id] = item + state.fingerprints[item_id] = self._fingerprint(item) + limit = _COLLECTION_ITEM_LIMITS[name] + while len(state.order) > limit: + removed_id = state.order.pop(0) + state.items.pop(removed_id, None) + state.fingerprints.pop(removed_id, None) + operations.append({"op": "delete", "id": removed_id}) + if operations: + revision = state.revision + 1 + await self._send_collection_frames( + "collection_delta", + { + "collection": name, + "base_revision": state.revision, + "revision": revision, + }, + "operations", + operations, + ) + state.revision = revision + state.source_cursor = next_cursor + return + projected = self.controller.collection(name) + order, by_id, fingerprints = self._collection_values(projected) + if not state.bootstrapped: + await self._send_collection_bootstrap( + name, + None if name == "events" else projected, + ) + return + if order == state.order and fingerprints == state.fingerprints: + return + + retained = [item_id for item_id in state.order if item_id in by_id] + expected_order = retained + [item_id for item_id in order if item_id not in state.items] + if order != expected_order: + await self._send_collection_bootstrap(name, projected) + return + + operations = [ + {"op": "delete", "id": item_id} for item_id in state.order if item_id not in by_id + ] + [ + {"op": "upsert", "item": by_id[item_id]} + for item_id in order + if fingerprints[item_id] != state.fingerprints.get(item_id) + ] + if not operations: + await self._send_collection_bootstrap(name, projected) + return + + revision = state.revision + 1 + await self._send_collection_frames( + "collection_delta", + { + "collection": name, + "base_revision": state.revision, + "revision": revision, + }, + "operations", + operations, + ) + state.revision = revision + state.order = order + state.items = by_id + state.fingerprints = fingerprints + + async def _flush_updates(self) -> None: + async with self._sync_lock: + await self._send_state_if_changed() + for name in _COLLECTIONS: + await self._send_collection_if_changed(name) + + async def _resync_collection(self, name: str) -> None: + async with self._sync_lock: + await self._send_collection_bootstrap(name) + + async def _broadcast_loop(self) -> None: + try: + while True: + await self._broadcast_event.wait() + self._broadcast_event.clear() + await asyncio.sleep(0.05) + await self._flush_updates() + except asyncio.CancelledError: + raise + except (_MessageTooLargeError, ValueError): + logger.exception("TUI projection could not be framed") + self._close_socket() + except (ConnectionError, OSError): + self._close_socket() diff --git a/strix/interface/tui/cmd/strix-tui/main.go b/strix/interface/tui/cmd/strix-tui/main.go new file mode 100644 index 00000000..335725d5 --- /dev/null +++ b/strix/interface/tui/cmd/strix-tui/main.go @@ -0,0 +1,35 @@ +package main + +import ( + "fmt" + "os" + + tea "github.com/charmbracelet/bubbletea" + "github.com/usestrix/strix/tui/internal/app" + "github.com/usestrix/strix/tui/internal/render" +) + +func main() { + app.SetVersion(os.Getenv("STRIX_VERSION")) + render.DetectKittyGraphics() + client, err := app.ConnectFromEnvironment() + if err != nil { + fmt.Fprintln(os.Stderr, "connect to Strix backend:", err) + os.Exit(1) + } + defer client.Close() + if err := client.Handshake(); err != nil { + fmt.Fprintln(os.Stderr, "negotiate Strix TUI protocol:", err) + os.Exit(1) + } + program := tea.NewProgram(app.New(client), tea.WithAltScreen(), tea.WithMouseCellMotion()) + finalModel, err := program.Run() + if err != nil { + fmt.Fprintln(os.Stderr, "run TUI:", err) + os.Exit(1) + } + if model, ok := finalModel.(interface{ FatalError() error }); ok && model.FatalError() != nil { + fmt.Fprintln(os.Stderr, "run TUI:", model.FatalError()) + os.Exit(1) + } +} diff --git a/strix/interface/tui/go.mod b/strix/interface/tui/go.mod new file mode 100644 index 00000000..1ff6ec35 --- /dev/null +++ b/strix/interface/tui/go.mod @@ -0,0 +1,32 @@ +module github.com/usestrix/strix/tui + +go 1.24.0 + +require ( + github.com/alecthomas/chroma/v2 v2.14.0 + github.com/atotto/clipboard v0.1.4 + github.com/charmbracelet/bubbles v0.21.0 + github.com/charmbracelet/bubbletea v1.3.10 + github.com/charmbracelet/lipgloss v1.1.0 + github.com/charmbracelet/x/ansi v0.10.1 + github.com/charmbracelet/x/term v0.2.1 + github.com/muesli/termenv v0.16.0 + golang.org/x/sys v0.36.0 +) + +require ( + github.com/aymanbagabas/go-osc52/v2 v2.0.1 // indirect + github.com/charmbracelet/colorprofile v0.2.3-0.20250311203215-f60798e515dc // indirect + github.com/charmbracelet/x/cellbuf v0.0.13-0.20250311204145-2c3ea96c31dd // indirect + github.com/dlclark/regexp2 v1.11.0 // indirect + github.com/erikgeiser/coninput v0.0.0-20211004153227-1c3628e74d0f // indirect + github.com/lucasb-eyer/go-colorful v1.2.0 // indirect + github.com/mattn/go-isatty v0.0.20 // indirect + github.com/mattn/go-localereader v0.0.1 // indirect + github.com/mattn/go-runewidth v0.0.16 // indirect + github.com/muesli/ansi v0.0.0-20230316100256-276c6243b2f6 // indirect + github.com/muesli/cancelreader v0.2.2 // indirect + github.com/rivo/uniseg v0.4.7 // indirect + github.com/xo/terminfo v0.0.0-20220910002029-abceb7e1c41e // indirect + golang.org/x/text v0.3.8 // indirect +) diff --git a/strix/interface/tui/go.sum b/strix/interface/tui/go.sum new file mode 100644 index 00000000..f255aec1 --- /dev/null +++ b/strix/interface/tui/go.sum @@ -0,0 +1,61 @@ +github.com/MakeNowJust/heredoc v1.0.0 h1:cXCdzVdstXyiTqTvfqk9SDHpKNjxuom+DOlyEeQ4pzQ= +github.com/MakeNowJust/heredoc v1.0.0/go.mod h1:mG5amYoWBHf8vpLOuehzbGGw0EHxpZZ6lCpQ4fNJ8LE= +github.com/alecthomas/assert/v2 v2.7.0 h1:QtqSACNS3tF7oasA8CU6A6sXZSBDqnm7RfpLl9bZqbE= +github.com/alecthomas/assert/v2 v2.7.0/go.mod h1:Bze95FyfUr7x34QZrjL+XP+0qgp/zg8yS+TtBj1WA3k= +github.com/alecthomas/chroma/v2 v2.14.0 h1:R3+wzpnUArGcQz7fCETQBzO5n9IMNi13iIs46aU4V9E= +github.com/alecthomas/chroma/v2 v2.14.0/go.mod h1:QolEbTfmUHIMVpBqxeDnNBj2uoeI4EbYP4i6n68SG4I= +github.com/alecthomas/repr v0.4.0 h1:GhI2A8MACjfegCPVq9f1FLvIBS+DrQ2KQBFZP1iFzXc= +github.com/alecthomas/repr v0.4.0/go.mod h1:Fr0507jx4eOXV7AlPV6AVZLYrLIuIeSOWtW57eE/O/4= +github.com/atotto/clipboard v0.1.4 h1:EH0zSVneZPSuFR11BlR9YppQTVDbh5+16AmcJi4g1z4= +github.com/atotto/clipboard v0.1.4/go.mod h1:ZY9tmq7sm5xIbd9bOK4onWV4S6X0u6GY7Vn0Yu86PYI= +github.com/aymanbagabas/go-osc52/v2 v2.0.1 h1:HwpRHbFMcZLEVr42D4p7XBqjyuxQH5SMiErDT4WkJ2k= +github.com/aymanbagabas/go-osc52/v2 v2.0.1/go.mod h1:uYgXzlJ7ZpABp8OJ+exZzJJhRNQ2ASbcXHWsFqH8hp8= +github.com/aymanbagabas/go-udiff v0.2.0 h1:TK0fH4MteXUDspT88n8CKzvK0X9O2xu9yQjWpi6yML8= +github.com/aymanbagabas/go-udiff v0.2.0/go.mod h1:RE4Ex0qsGkTAJoQdQQCA0uG+nAzJO/pI/QwceO5fgrA= +github.com/charmbracelet/bubbles v0.21.0 h1:9TdC97SdRVg/1aaXNVWfFH3nnLAwOXr8Fn6u6mfQdFs= +github.com/charmbracelet/bubbles v0.21.0/go.mod h1:HF+v6QUR4HkEpz62dx7ym2xc71/KBHg+zKwJtMw+qtg= +github.com/charmbracelet/bubbletea v1.3.10 h1:otUDHWMMzQSB0Pkc87rm691KZ3SWa4KUlvF9nRvCICw= +github.com/charmbracelet/bubbletea v1.3.10/go.mod h1:ORQfo0fk8U+po9VaNvnV95UPWA1BitP1E0N6xJPlHr4= +github.com/charmbracelet/colorprofile v0.2.3-0.20250311203215-f60798e515dc h1:4pZI35227imm7yK2bGPcfpFEmuY1gc2YSTShr4iJBfs= +github.com/charmbracelet/colorprofile v0.2.3-0.20250311203215-f60798e515dc/go.mod h1:X4/0JoqgTIPSFcRA/P6INZzIuyqdFY5rm8tb41s9okk= +github.com/charmbracelet/lipgloss v1.1.0 h1:vYXsiLHVkK7fp74RkV7b2kq9+zDLoEU4MZoFqR/noCY= +github.com/charmbracelet/lipgloss v1.1.0/go.mod h1:/6Q8FR2o+kj8rz4Dq0zQc3vYf7X+B0binUUBwA0aL30= +github.com/charmbracelet/x/ansi v0.10.1 h1:rL3Koar5XvX0pHGfovN03f5cxLbCF2YvLeyz7D2jVDQ= +github.com/charmbracelet/x/ansi v0.10.1/go.mod h1:3RQDQ6lDnROptfpWuUVIUG64bD2g2BgntdxH0Ya5TeE= +github.com/charmbracelet/x/cellbuf v0.0.13-0.20250311204145-2c3ea96c31dd h1:vy0GVL4jeHEwG5YOXDmi86oYw2yuYUGqz6a8sLwg0X8= +github.com/charmbracelet/x/cellbuf v0.0.13-0.20250311204145-2c3ea96c31dd/go.mod h1:xe0nKWGd3eJgtqZRaN9RjMtK7xUYchjzPr7q6kcvCCs= +github.com/charmbracelet/x/term v0.2.1 h1:AQeHeLZ1OqSXhrAWpYUtZyX1T3zVxfpZuEQMIQaGIAQ= +github.com/charmbracelet/x/term v0.2.1/go.mod h1:oQ4enTYFV7QN4m0i9mzHrViD7TQKvNEEkHUMCmsxdUg= +github.com/dlclark/regexp2 v1.11.0 h1:G/nrcoOa7ZXlpoa/91N3X7mM3r8eIlMBBJZvsz/mxKI= +github.com/dlclark/regexp2 v1.11.0/go.mod h1:DHkYz0B9wPfa6wondMfaivmHpzrQ3v9q8cnmRbL6yW8= +github.com/erikgeiser/coninput v0.0.0-20211004153227-1c3628e74d0f h1:Y/CXytFA4m6baUTXGLOoWe4PQhGxaX0KpnayAqC48p4= +github.com/erikgeiser/coninput v0.0.0-20211004153227-1c3628e74d0f/go.mod h1:vw97MGsxSvLiUE2X8qFplwetxpGLQrlU1Q9AUEIzCaM= +github.com/hexops/gotextdiff v1.0.3 h1:gitA9+qJrrTCsiCl7+kh75nPqQt1cx4ZkudSTLoUqJM= +github.com/hexops/gotextdiff v1.0.3/go.mod h1:pSWU5MAI3yDq+fZBTazCSJysOMbxWL1BSow5/V2vxeg= +github.com/lucasb-eyer/go-colorful v1.2.0 h1:1nnpGOrhyZZuNyfu1QjKiUICQ74+3FNCN69Aj6K7nkY= +github.com/lucasb-eyer/go-colorful v1.2.0/go.mod h1:R4dSotOR9KMtayYi1e77YzuveK+i7ruzyGqttikkLy0= +github.com/mattn/go-isatty v0.0.20 h1:xfD0iDuEKnDkl03q4limB+vH+GxLEtL/jb4xVJSWWEY= +github.com/mattn/go-isatty v0.0.20/go.mod h1:W+V8PltTTMOvKvAeJH7IuucS94S2C6jfK/D7dTCTo3Y= +github.com/mattn/go-localereader v0.0.1 h1:ygSAOl7ZXTx4RdPYinUpg6W99U8jWvWi9Ye2JC/oIi4= +github.com/mattn/go-localereader v0.0.1/go.mod h1:8fBrzywKY7BI3czFoHkuzRoWE9C+EiG4R1k4Cjx5p88= +github.com/mattn/go-runewidth v0.0.16 h1:E5ScNMtiwvlvB5paMFdw9p4kSQzbXFikJ5SQO6TULQc= +github.com/mattn/go-runewidth v0.0.16/go.mod h1:Jdepj2loyihRzMpdS35Xk/zdY8IAYHsh153qUoGf23w= +github.com/muesli/ansi v0.0.0-20230316100256-276c6243b2f6 h1:ZK8zHtRHOkbHy6Mmr5D264iyp3TiX5OmNcI5cIARiQI= +github.com/muesli/ansi v0.0.0-20230316100256-276c6243b2f6/go.mod h1:CJlz5H+gyd6CUWT45Oy4q24RdLyn7Md9Vj2/ldJBSIo= +github.com/muesli/cancelreader v0.2.2 h1:3I4Kt4BQjOR54NavqnDogx/MIoWBFa0StPA8ELUXHmA= +github.com/muesli/cancelreader v0.2.2/go.mod h1:3XuTXfFS2VjM+HTLZY9Ak0l6eUKfijIfMUZ4EgX0QYo= +github.com/muesli/termenv v0.16.0 h1:S5AlUN9dENB57rsbnkPyfdGuWIlkmzJjbFf0Tf5FWUc= +github.com/muesli/termenv v0.16.0/go.mod h1:ZRfOIKPFDYQoDFF4Olj7/QJbW60Ol/kL1pU3VfY/Cnk= +github.com/rivo/uniseg v0.2.0/go.mod h1:J6wj4VEh+S6ZtnVlnTBMWIodfgj8LQOQFoIToxlJtxc= +github.com/rivo/uniseg v0.4.7 h1:WUdvkW8uEhrYfLC4ZzdpI2ztxP1I582+49Oc5Mq64VQ= +github.com/rivo/uniseg v0.4.7/go.mod h1:FN3SvrM+Zdj16jyLfmOkMNblXMcoc8DfTHruCPUcx88= +github.com/xo/terminfo v0.0.0-20220910002029-abceb7e1c41e h1:JVG44RsyaB9T2KIHavMF/ppJZNG9ZpyihvCd0w101no= +github.com/xo/terminfo v0.0.0-20220910002029-abceb7e1c41e/go.mod h1:RbqR21r5mrJuqunuUZ/Dhy/avygyECGrLceyNeo4LiM= +golang.org/x/exp v0.0.0-20220909182711-5c715a9e8561 h1:MDc5xs78ZrZr3HMQugiXOAkSZtfTpbJLDr/lwfgO53E= +golang.org/x/exp v0.0.0-20220909182711-5c715a9e8561/go.mod h1:cyybsKvd6eL0RnXn6p/Grxp8F5bW7iYuBgsNCOHpMYE= +golang.org/x/sys v0.0.0-20210809222454-d867a43fc93e/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= +golang.org/x/sys v0.6.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= +golang.org/x/sys v0.36.0 h1:KVRy2GtZBrk1cBYA7MKu5bEZFxQk4NIDV6RLVcC8o0k= +golang.org/x/sys v0.36.0/go.mod h1:OgkHotnGiDImocRcuBABYBEXf8A9a87e/uXjp9XT3ks= +golang.org/x/text v0.3.8 h1:nAL+RVCQ9uMn3vJZbV+MRnydTJFPf8qqY42YiA6MrqY= +golang.org/x/text v0.3.8/go.mod h1:E6s5w1FMmriuDzIBO73fBruAKo1PCIq6d2Q6DHfQ8WQ= diff --git a/strix/interface/tui/internal/app/agents.go b/strix/interface/tui/internal/app/agents.go new file mode 100644 index 00000000..bd590254 --- /dev/null +++ b/strix/interface/tui/internal/app/agents.go @@ -0,0 +1,253 @@ +package app + +import ( + "fmt" + "strings" + + "github.com/charmbracelet/lipgloss" + "github.com/usestrix/strix/tui/internal/protocol" + "github.com/usestrix/strix/tui/internal/render" +) + +type agentTreeEntry struct { + index int + depth int + prefix string +} + +// agentTreeEntries mirrors Textual Tree's depth-first ordering while retaining +// each agent's snapshot index for event lookup and commands. +func agentTreeEntries(agents []protocol.Agent, collapsed map[string]bool) []agentTreeEntry { + indexByID := make(map[string]int, len(agents)) + for i, agent := range agents { + indexByID[agent.ID] = i + } + children := make(map[int][]int, len(agents)) + var roots []int + for i, agent := range agents { + parentIndex := -1 + if agent.ParentID != nil { + if candidate, ok := indexByID[*agent.ParentID]; ok && candidate != i { + parentIndex = candidate + } + } + if parentIndex < 0 { + roots = append(roots, i) + } else { + children[parentIndex] = append(children[parentIndex], i) + } + } + + entries := make([]agentTreeEntry, 0, len(agents)) + visited := make(map[int]bool, len(agents)) + var hideDescendants func(int) + hideDescendants = func(index int) { + for _, child := range children[index] { + if visited[child] { + continue + } + visited[child] = true + hideDescendants(child) + } + } + var walk func(int, int, []bool, bool) + walk = func(index, depth int, continuations []bool, isLast bool) { + if visited[index] { + return + } + visited[index] = true + var prefix strings.Builder + if depth > 0 { + for _, continues := range continuations { + if continues { + prefix.WriteString("│ ") + } else { + prefix.WriteString(" ") + } + } + if isLast { + prefix.WriteString("└─ ") + } else { + prefix.WriteString("├─ ") + } + } + entries = append(entries, agentTreeEntry{index: index, depth: depth, prefix: prefix.String()}) + if collapsed[agents[index].ID] { + hideDescendants(index) + return + } + nextContinuations := continuations + if depth > 0 { + nextContinuations = append(append([]bool(nil), continuations...), !isLast) + } + for i, child := range children[index] { + walk(child, depth+1, nextContinuations, i == len(children[index])-1) + } + } + for i, root := range roots { + walk(root, 0, nil, i == len(roots)-1) + } + // Malformed cycles have no root. Keep their nodes visible rather than losing + // them, treating the first unvisited node as another root. + for i := range agents { + if !visited[i] { + walk(i, 0, nil, true) + } + } + return entries +} + +func hasAgentChildren(agentID string, agents []protocol.Agent) bool { + for _, agent := range agents { + if agent.ParentID != nil && *agent.ParentID == agentID { + return true + } + } + return false +} + +func windowStart(offset, length, size int) int { + return min(max(0, offset), max(0, length-size)) +} + +func selectedAgentRow(entries []agentTreeEntry, selectedIndex int) int { + for row, entry := range entries { + if entry.index == selectedIndex { + return row + } + } + return 0 +} + +func selectedAgentIndex(agents []protocol.Agent, selectedID string) int { + if selectedID != "" { + for i, agent := range agents { + if agent.ID == selectedID { + return i + } + } + } + return 0 +} + +func (m Model) selectedAgentID() string { + if m.selectedAgent >= 0 && m.selectedAgent < len(m.snapshot.Agents) { + return m.snapshot.Agents[m.selectedAgent].ID + } + return "" +} + +func (m Model) selectedAgentCanStop() bool { + if m.selectedAgent < 0 || m.selectedAgent >= len(m.snapshot.Agents) { + return false + } + switch m.snapshot.Agents[m.selectedAgent].Status { + case "running", "waiting", "budget_paused": + return true + default: + return false + } +} + +func (m Model) agentsView(width, height int) string { + // The tree's root ("Agents") is hidden (show_root = False), so no header row + // is drawn — only the agent nodes. + var lines []string + statusIcons := map[string]string{"running": "⚪", "waiting": "⏸", "budget_paused": "⏸", "completed": "🟢", "failed": "🔴", "crashed": "🔴", "stopped": "■"} + entries := agentTreeEntries(m.snapshot.Agents, m.collapsedAgents) + start := windowStart(m.agentOffset, len(entries), height) + end := min(len(entries), start+height) + for _, entry := range entries[start:end] { + agent := m.snapshot.Agents[entry.index] + icon := statusIcons[agent.Status] + if icon == "" { + icon = "○" + } + vulnSuffix := "" + if count := m.agentVulnCount(agent.ID); count > 0 { + vulnSuffix = fmt.Sprintf(" (%d)", count) + } + // Only a node with children carries a toggle; a leaf renders none at all, + // so its icon sits where its parent's toggle would be. + disclosure := "" + if hasAgentChildren(agent.ID, m.snapshot.Agents) { + disclosure = "▼ " + if m.collapsedAgents[agent.ID] { + disclosure = "▶ " + } + } + label := disclosure + icon + " " + agent.Name + vulnSuffix + // The guides are dim and stay outside the cursor; the cursor is a filled + // block behind the label alone. + labelStyle := lipgloss.NewStyle().Foreground(treeLabel) + if entry.index == m.selectedAgent { + labelStyle = labelStyle.Foreground(treeCursorFg).Background(treeCursorBg).Bold(true) + } + room := max(1, width-lipgloss.Width(entry.prefix)) + lines = append(lines, + lipgloss.NewStyle().Foreground(treeGuide).Render(entry.prefix)+ + labelStyle.Render(truncate(label, room))) + } + return strings.Join(lines, "\n") +} + +// agentVulnCount counts vulnerabilities attributed to an agent, matching the +// " (N)" suffix _update_agent_node appends to each tree node. +func (m Model) agentVulnCount(agentID string) int { + count := 0 + for _, vuln := range m.snapshot.Vulnerabilities { + if render.StringValue(vuln["agent_id"]) == agentID { + count++ + } + } + return count +} + +func (m *Model) ensureAgentVisible() { + entries := agentTreeEntries(m.snapshot.Agents, m.collapsedAgents) + if len(entries) == 0 { + m.agentOffset = 0 + return + } + _, _, agentHeight := m.sidebarHeights() + rows := max(1, agentHeight-4) + row := selectedAgentRow(entries, m.selectedAgent) + if row < m.agentOffset { + m.agentOffset = row + } else if row >= m.agentOffset+rows { + m.agentOffset = row - rows + 1 + } + m.agentOffset = min(m.agentOffset, max(0, len(entries)-rows)) +} + +func (m Model) agentPageSize() int { + _, _, agentHeight := m.sidebarHeights() + return max(1, agentHeight-4) +} + +func (m *Model) keepAgentSelectionInWindow() { + entries := agentTreeEntries(m.snapshot.Agents, m.collapsedAgents) + if len(entries) == 0 { + return + } + rows := m.agentPageSize() + row := selectedAgentRow(entries, m.selectedAgent) + if row < m.agentOffset { + m.selectedAgent = entries[m.agentOffset].index + } else if row >= m.agentOffset+rows { + m.selectedAgent = entries[min(len(entries)-1, m.agentOffset+rows-1)].index + } +} + +func (m Model) agentHasEvents(agentID string) bool { + for _, event := range m.snapshot.Events { + if event.AgentID == agentID { + return true + } + } + return false +} + +// sweepView ports _get_sweep_animation: a triangle-wave sweep of six squares +// across an 8-color palette (dimmest shows a "·"), matching the Python cadence +// and motion exactly. diff --git a/strix/interface/tui/internal/app/client.go b/strix/interface/tui/internal/app/client.go new file mode 100644 index 00000000..f1344de3 --- /dev/null +++ b/strix/interface/tui/internal/app/client.go @@ -0,0 +1,250 @@ +package app + +import ( + "encoding/binary" + "encoding/json" + "errors" + "fmt" + "io" + "net" + "os" + "reflect" + "strconv" + "sync" + "sync/atomic" + "time" + + "github.com/usestrix/strix/tui/internal/protocol" +) + +const ( + maxCommandBytes = 64 << 10 + maxCollectionBytes = 4 << 20 +) + +var ErrCommandPending = errors.New("command is already pending") + +type Client struct { + conn io.ReadWriteCloser + mu sync.Mutex + seq atomic.Uint64 + pending map[string]string + pendingByKey map[string]string + requestKeyByID map[string]string +} + +// ConnectInherited opens the connected socket descriptor passed by the Python +// parent. No listener, network address, or authentication secret is involved. +func ConnectInherited(fdValue string) (*Client, error) { + fd, err := strconv.ParseUint(fdValue, 10, 64) + if err != nil { + return nil, fmt.Errorf("invalid STRIX_TUI_FD: %w", err) + } + file := os.NewFile(uintptr(fd), "strix-tui-ipc") + if file == nil { + return nil, fmt.Errorf("invalid STRIX_TUI_FD %d", fd) + } + connection, err := net.FileConn(file) + _ = file.Close() + if err != nil { + return nil, fmt.Errorf("open inherited TUI connection: %w", err) + } + return newClient(connection), nil +} + +func newClient(connection io.ReadWriteCloser) *Client { + return &Client{ + conn: connection, + pending: map[string]string{}, + pendingByKey: map[string]string{}, + requestKeyByID: map[string]string{}, + } +} + +// ConnectFromEnvironment selects the private transport prepared by the Python +// parent. POSIX uses an inherited descriptor; Windows uses an authenticated +// one-use loopback connection because pass_fds is unavailable there. +func ConnectFromEnvironment() (*Client, error) { + if fd := os.Getenv("STRIX_TUI_FD"); fd != "" { + _ = os.Unsetenv("STRIX_TUI_FD") + return ConnectInherited(fd) + } + + address := os.Getenv("STRIX_TUI_ADDR") + token := os.Getenv("STRIX_TUI_TOKEN") + _ = os.Unsetenv("STRIX_TUI_ADDR") + _ = os.Unsetenv("STRIX_TUI_TOKEN") + if address == "" || token == "" { + return nil, fmt.Errorf("STRIX_TUI_FD or STRIX_TUI_ADDR and STRIX_TUI_TOKEN are required") + } + + connection, err := net.DialTimeout("tcp", address, 10*time.Second) + if err != nil { + return nil, fmt.Errorf("connect to TUI backend: %w", err) + } + if err := writeAll(connection, []byte(token)); err != nil { + connection.Close() + return nil, fmt.Errorf("authenticate to TUI backend: %w", err) + } + return newClient(connection), nil +} + +func writeAll(writer io.Writer, data []byte) error { + for len(data) > 0 { + n, err := writer.Write(data) + if err != nil { + return err + } + if n == 0 { + return io.ErrShortWrite + } + data = data[n:] + } + return nil +} + +func (c *Client) readEnvelope(maximum uint32) (protocol.Envelope, int, error) { + var header [4]byte + if _, err := io.ReadFull(c.conn, header[:]); err != nil { + return protocol.Envelope{}, 0, err + } + size := binary.BigEndian.Uint32(header[:]) + if size == 0 || size > maximum { + return protocol.Envelope{}, 0, fmt.Errorf("invalid TUI IPC message size: %d", size) + } + raw := make([]byte, size) + if _, err := io.ReadFull(c.conn, raw); err != nil { + return protocol.Envelope{}, 0, err + } + var envelope protocol.Envelope + if err := json.Unmarshal(raw, &envelope); err != nil { + return protocol.Envelope{}, 0, err + } + return envelope, int(size), nil +} + +func (c *Client) Read() (protocol.Envelope, error) { + envelope, size, err := c.readEnvelope(maxCollectionBytes) + if err != nil { + return protocol.Envelope{}, err + } + if envelope.Type != "collection_bootstrap" && envelope.Type != "collection_delta" && size > maxCommandBytes { + return protocol.Envelope{}, fmt.Errorf("TUI control message exceeds %d bytes", maxCommandBytes) + } + return envelope, nil +} + +// Handshake validates the exact v3 hello and acknowledges readiness. main calls +// this before constructing Bubble Tea, so mismatch errors never enter alt screen. +func (c *Client) Handshake() error { + if connection, ok := c.conn.(interface{ SetDeadline(time.Time) error }); ok { + if err := connection.SetDeadline(time.Now().Add(10 * time.Second)); err != nil { + return err + } + defer connection.SetDeadline(time.Time{}) //nolint:errcheck + } + envelope, _, err := c.readEnvelope(maxCommandBytes) + if err != nil { + return fmt.Errorf("read protocol hello: %w", err) + } + if envelope.Version != protocol.Version { + return fmt.Errorf("protocol mismatch: backend=%d client=%d", envelope.Version, protocol.Version) + } + if envelope.Type != "hello" { + return fmt.Errorf("protocol handshake expected hello, received %q", envelope.Type) + } + var hello protocol.Hello + if err := json.Unmarshal(envelope.Payload, &hello); err != nil { + return fmt.Errorf("decode protocol hello: %w", err) + } + if !reflect.DeepEqual(hello.Capabilities, protocol.Capabilities) { + return fmt.Errorf("protocol capability mismatch") + } + payload, err := json.Marshal(protocol.Hello{Capabilities: protocol.Capabilities}) + if err != nil { + return err + } + return c.sendEnvelope(protocol.Envelope{ + Version: protocol.Version, + Type: "ready", + Payload: payload, + }, maxCommandBytes) +} + +func (c *Client) sendEnvelope(envelope protocol.Envelope, maximum int) error { + raw, err := json.Marshal(envelope) + if err != nil { + return err + } + if len(raw) > maximum { + return fmt.Errorf("TUI IPC message exceeds %d bytes", maximum) + } + framed := make([]byte, 4+len(raw)) + binary.BigEndian.PutUint32(framed[:4], uint32(len(raw))) + copy(framed[4:], raw) + return writeAll(c.conn, framed) +} + +func pendingKey(command string, payload json.RawMessage) string { + if command == "collection.resync" { + return command + ":" + string(payload) + } + return command +} + +func (c *Client) Send(command string, payload any) (string, error) { + rawPayload, err := json.Marshal(payload) + if err != nil { + return "", err + } + requestID := fmt.Sprintf("go-%d", c.seq.Add(1)) + envelope := protocol.Envelope{ + Version: protocol.Version, Type: command, RequestID: requestID, Payload: rawPayload, + } + key := pendingKey(command, rawPayload) + + c.mu.Lock() + defer c.mu.Unlock() + if c.pending == nil { + c.pending = map[string]string{} + c.pendingByKey = map[string]string{} + c.requestKeyByID = map[string]string{} + } + if existing := c.pendingByKey[key]; existing != "" { + return "", fmt.Errorf("%w: %s (%s)", ErrCommandPending, command, existing) + } + c.pending[requestID] = command + c.pendingByKey[key] = requestID + c.requestKeyByID[requestID] = key + if err := c.sendEnvelope(envelope, maxCommandBytes); err != nil { + delete(c.pending, requestID) + delete(c.pendingByKey, key) + delete(c.requestKeyByID, requestID) + return "", err + } + return requestID, nil +} + +// Resolve accepts only the exact request/command pair that was submitted. +// Unknown or mismatched results remain inert and do not release pending state. +func (c *Client) Resolve(requestID, command string) bool { + c.mu.Lock() + defer c.mu.Unlock() + if requestID == "" || c.pending[requestID] != command { + return false + } + key := c.requestKeyByID[requestID] + delete(c.pending, requestID) + delete(c.pendingByKey, key) + delete(c.requestKeyByID, requestID) + return true +} + +func (c *Client) ExpectedCommand(requestID string) (string, bool) { + c.mu.Lock() + defer c.mu.Unlock() + command, ok := c.pending[requestID] + return command, ok +} + +func (c *Client) Close() error { return c.conn.Close() } diff --git a/strix/interface/tui/internal/app/client_test.go b/strix/interface/tui/internal/app/client_test.go new file mode 100644 index 00000000..651355b0 --- /dev/null +++ b/strix/interface/tui/internal/app/client_test.go @@ -0,0 +1,284 @@ +package app + +import ( + "bytes" + "encoding/binary" + "encoding/json" + "errors" + "fmt" + "io" + "net" + "os" + "reflect" + "strings" + "testing" + + "github.com/usestrix/strix/tui/internal/protocol" +) + +func writeEnvelopeFrame(writer io.Writer, envelope protocol.Envelope) error { + raw, err := json.Marshal(envelope) + if err != nil { + return err + } + var header [4]byte + binary.BigEndian.PutUint32(header[:], uint32(len(raw))) + return writeAll(writer, append(header[:], raw...)) +} + +func readEnvelopeFrame(reader io.Reader) (protocol.Envelope, error) { + var header [4]byte + if _, err := io.ReadFull(reader, header[:]); err != nil { + return protocol.Envelope{}, err + } + raw := make([]byte, binary.BigEndian.Uint32(header[:])) + if _, err := io.ReadFull(reader, raw); err != nil { + return protocol.Envelope{}, err + } + var envelope protocol.Envelope + return envelope, json.Unmarshal(raw, &envelope) +} + +func TestHandshakeValidatesHelloAndSendsReady(t *testing.T) { + server, connection := net.Pipe() + client := newClient(connection) + serverErr := make(chan error, 1) + go func() { + defer server.Close() + payload, _ := json.Marshal(protocol.Hello{Capabilities: protocol.Capabilities}) + if err := writeEnvelopeFrame(server, protocol.Envelope{Version: protocol.Version, Type: "hello", Payload: payload}); err != nil { + serverErr <- err + return + } + var header [4]byte + if _, err := io.ReadFull(server, header[:]); err != nil { + serverErr <- err + return + } + raw := make([]byte, binary.BigEndian.Uint32(header[:])) + if _, err := io.ReadFull(server, raw); err != nil { + serverErr <- err + return + } + var ready protocol.Envelope + if err := json.Unmarshal(raw, &ready); err != nil { + serverErr <- err + return + } + var readyPayload protocol.Hello + if err := json.Unmarshal(ready.Payload, &readyPayload); err != nil { + serverErr <- err + return + } + if ready.Type != "ready" || ready.Version != protocol.Version || !reflect.DeepEqual(readyPayload.Capabilities, protocol.Capabilities) { + serverErr <- fmt.Errorf("unexpected ready: %#v %#v", ready, readyPayload) + return + } + serverErr <- nil + }() + + if err := client.Handshake(); err != nil { + t.Fatal(err) + } + if err := <-serverErr; err != nil { + t.Fatal(err) + } +} + +func TestHandshakeRejectsMismatchBeforeReady(t *testing.T) { + server, connection := net.Pipe() + client := newClient(connection) + go func() { + defer server.Close() + payload, _ := json.Marshal(protocol.Hello{Capabilities: []string{"state-revisions"}}) + _ = writeEnvelopeFrame(server, protocol.Envelope{Version: 2, Type: "hello", Payload: payload}) + }() + + err := client.Handshake() + if err == nil || !strings.Contains(err.Error(), "protocol mismatch") { + t.Fatalf("handshake error = %v, want protocol mismatch", err) + } +} + +func TestReadRejectsOversizedCollectionLengthBeforePayload(t *testing.T) { + server, connection := net.Pipe() + client := newClient(connection) + written := make(chan error, 1) + go func() { + var header [4]byte + binary.BigEndian.PutUint32(header[:], maxCollectionBytes+1) + _, err := server.Write(header[:]) + written <- err + }() + + _, err := client.Read() + if err == nil || !strings.Contains(err.Error(), "invalid TUI IPC message size") { + t.Fatalf("read error = %v", err) + } + if err := <-written; err != nil { + t.Fatal(err) + } + server.Close() +} + +func TestClientPreventsDuplicateCommandsAndRequiresExactCorrelation(t *testing.T) { + connection := &recordingConn{} + client := newClient(connection) + requestID, err := client.Send("setup.select_model", map[string]string{"model": "openai/gpt-5"}) + if err != nil { + t.Fatal(err) + } + if _, err := client.Send("setup.select_model", map[string]string{"model": "openai/gpt-5.1"}); !errors.Is(err, ErrCommandPending) { + t.Fatalf("duplicate error = %v, want ErrCommandPending", err) + } + if client.Resolve("unknown", "setup.select_model") || client.Resolve(requestID, "models.list") { + t.Fatal("unknown or mismatched result resolved pending request") + } + if !client.Resolve(requestID, "setup.select_model") { + t.Fatal("exact result did not resolve pending request") + } + if _, err := client.Send("setup.select_model", map[string]string{"model": "openai/gpt-5.1"}); err != nil { + t.Fatalf("command remained blocked after success: %v", err) + } +} + +func TestClientRejectsOversizedCommandBeforeWrite(t *testing.T) { + connection := &recordingConn{} + client := newClient(connection) + _, err := client.Send("setup.set_instruction", map[string]string{"instruction": strings.Repeat("x", maxCommandBytes)}) + if err == nil || !strings.Contains(err.Error(), "exceeds") { + t.Fatalf("oversized send error = %v", err) + } + if connection.Len() != 0 || len(client.pending) != 0 { + t.Fatal("oversized command was written or left pending") + } +} + +func TestClientReadsCollectionFrameLargerThanOneMegabyte(t *testing.T) { + server, connection := net.Pipe() + client := &Client{conn: connection} + payload, err := json.Marshal(map[string]string{"content": string(bytes.Repeat([]byte("x"), 2<<20))}) + if err != nil { + t.Fatal(err) + } + raw, err := json.Marshal(protocol.Envelope{ + Version: protocol.Version, + Type: "collection_bootstrap", + Payload: payload, + }) + if err != nil { + t.Fatal(err) + } + + writeErr := make(chan error, 1) + go func() { + defer server.Close() + var header [4]byte + binary.BigEndian.PutUint32(header[:], uint32(len(raw))) + if _, err := server.Write(header[:]); err != nil { + writeErr <- err + return + } + _, err := server.Write(raw) + writeErr <- err + }() + + message, err := client.Read() + if err != nil { + t.Fatal(err) + } + if message.Type != "collection_bootstrap" { + t.Fatalf("message type = %q, want collection_bootstrap", message.Type) + } + if err := <-writeErr; err != nil { + t.Fatal(err) + } +} + +func TestConnectFromEnvironmentAuthenticatesTCPTransport(t *testing.T) { + listener, err := net.Listen("tcp", "127.0.0.1:0") + if err != nil { + t.Fatal(err) + } + defer listener.Close() + + t.Setenv("STRIX_TUI_ADDR", listener.Addr().String()) + t.Setenv("STRIX_TUI_TOKEN", "one-use-token") + t.Setenv("STRIX_TUI_FD", "") + + serverErr := make(chan error, 1) + go func() { + connection, acceptErr := listener.Accept() + if acceptErr != nil { + serverErr <- acceptErr + return + } + defer connection.Close() + token := make([]byte, len("one-use-token")) + if _, readErr := io.ReadFull(connection, token); readErr != nil { + serverErr <- readErr + return + } + if string(token) != "one-use-token" { + serverErr <- os.ErrPermission + return + } + raw, marshalErr := json.Marshal(protocol.Envelope{ + Version: protocol.Version, + Type: "hello", + Payload: json.RawMessage(`{}`), + }) + if marshalErr != nil { + serverErr <- marshalErr + return + } + var header [4]byte + binary.BigEndian.PutUint32(header[:], uint32(len(raw))) + if writeErr := writeAll(connection, append(header[:], raw...)); writeErr != nil { + serverErr <- writeErr + return + } + serverErr <- nil + }() + + client, err := ConnectFromEnvironment() + if err != nil { + t.Fatal(err) + } + defer client.Close() + message, err := client.Read() + if err != nil { + t.Fatal(err) + } + if message.Type != "hello" { + t.Fatalf("message type = %q, want hello", message.Type) + } + if err := <-serverErr; err != nil { + t.Fatal(err) + } + if os.Getenv("STRIX_TUI_ADDR") != "" || os.Getenv("STRIX_TUI_TOKEN") != "" { + t.Fatal("TCP transport credentials were not removed from the environment") + } +} + +func TestConnectFromEnvironmentRequiresCompleteTransport(t *testing.T) { + t.Setenv("STRIX_TUI_FD", "") + t.Setenv("STRIX_TUI_ADDR", "127.0.0.1:1") + t.Setenv("STRIX_TUI_TOKEN", "") + + _, err := ConnectFromEnvironment() + if err == nil || !strings.Contains(err.Error(), "STRIX_TUI_ADDR and STRIX_TUI_TOKEN") { + t.Fatalf("error = %v, want missing transport error", err) + } +} + +func TestConnectFromEnvironmentPrefersInheritedDescriptor(t *testing.T) { + t.Setenv("STRIX_TUI_FD", "not-a-number") + t.Setenv("STRIX_TUI_ADDR", "127.0.0.1:1") + t.Setenv("STRIX_TUI_TOKEN", "token") + + _, err := ConnectFromEnvironment() + if err == nil || !strings.Contains(err.Error(), "invalid STRIX_TUI_FD") { + t.Fatalf("error = %v, want inherited descriptor parse error", err) + } +} diff --git a/strix/interface/tui/internal/app/findings_test.go b/strix/interface/tui/internal/app/findings_test.go new file mode 100644 index 00000000..0e865f57 --- /dev/null +++ b/strix/interface/tui/internal/app/findings_test.go @@ -0,0 +1,299 @@ +package app + +import ( + "encoding/json" + "fmt" + "strings" + "testing" + + tea "github.com/charmbracelet/bubbletea" + "github.com/charmbracelet/x/ansi" + "github.com/usestrix/strix/tui/internal/protocol" +) + +func findingsModel(t *testing.T, titles ...string) Model { + t.Helper() + m := New(nil) + m.width, m.height = 130, 30 + m.showSplash = false + m.handleEnvelope(stateEnvelope(t, 1, protocol.Snapshot{ScanState: "running"})) + items := make([]json.RawMessage, 0, len(titles)) + for i, title := range titles { + items = append(items, rawJSON(t, map[string]any{ + "id": string(rune('a' + i)), "title": title, "severity": "high", + })) + } + m.handleEnvelope(protocol.Envelope{Version: protocol.Version, Type: "collection_bootstrap", + Payload: rawJSON(t, protocol.CollectionBootstrap{ + Collection: "vulnerabilities", Revision: 1, Cursor: 0, + NextCursor: len(items), Done: true, Items: items, + })}) + m.resizeViewport() + return m +} + +// The list scrolls by row, not by finding. Stepping a whole entry at a time is +// what made a list of wrapped titles feel paginated. +func TestFindingsScrollByRow(t *testing.T) { + long := "A deliberately long finding title that wraps across several rows in the sidebar" + m := findingsModel(t, long, long, long) + + rows := m.vulnerabilityRows(m.vulnerabilityListWidth()) + if len(rows) <= 3 { + t.Fatalf("titles did not wrap, so this proves nothing: %d rows", len(rows)) + } + total, offset := m.vulnerabilityScrollRows() + if total != len(rows) || offset != 0 { + t.Fatalf("scroll metrics are not in rows: total=%d offset=%d rows=%d", total, offset, len(rows)) + } + + // One step of the offset moves one row, and the first visible line follows it. + first := strings.Split(ansi.Strip(m.vulnerabilitiesView(40, 4)), "\n")[0] + m.vulnOffset = 1 + second := strings.Split(ansi.Strip(m.vulnerabilitiesView(40, 4)), "\n")[0] + if first == second { + t.Fatalf("advancing one row did not move the list: %q", first) + } + // That row still belongs to the first finding, which an item-stepping list + // would have skipped past entirely. + if got := m.vulnerabilityIndexAtRow(0); got != 0 { + t.Fatalf("one row in, the top line belongs to finding %d, want 0", got) + } +} + +// Selecting a finding scrolls the least it can, and never past its own start. +func TestSelectingAFindingBringsItIntoView(t *testing.T) { + long := "A deliberately long finding title that wraps across several rows in the sidebar" + m := findingsModel(t, long, long, long, long) + + m.selectedVuln = 3 + m.ensureVulnerabilityVisible() + + rows := m.vulnerabilityRows(m.vulnerabilityListWidth()) + height := m.vulnerabilityPageSize() + end := min(len(rows), m.vulnOffset+height) + found := false + for _, row := range rows[m.vulnOffset:end] { + if row.index == 3 { + found = true + break + } + } + if !found { + t.Fatalf("the selected finding is not on screen: offset=%d height=%d", m.vulnOffset, height) + } + if m.vulnOffset > len(rows)-height && len(rows) > height { + t.Fatalf("scrolled past the end: offset=%d rows=%d height=%d", m.vulnOffset, len(rows), height) + } +} + +func reportModel(t *testing.T, count int) Model { + t.Helper() + titles := make([]string, 0, count) + for i := range count { + titles = append(titles, fmt.Sprintf("Finding number %d", i+1)) + } + m := findingsModel(t, titles...) + m.openModal(modalVulnerability) + return m +} + +// The open report can be stepped through the list without closing it. +func TestReportStepsBetweenFindings(t *testing.T) { + m := reportModel(t, 3) + + updated, _ := m.updateModal(tea.KeyMsg{Type: tea.KeyRight}) + m = updated.(Model) + if m.selectedVuln != 1 { + t.Fatalf("right moved to %d, want 1", m.selectedVuln) + } + if m.modal != modalVulnerability { + t.Fatal("stepping closed the report") + } + updated, _ = m.updateModal(tea.KeyMsg{Type: tea.KeyLeft}) + m = updated.(Model) + if m.selectedVuln != 0 { + t.Fatalf("left moved to %d, want 0", m.selectedVuln) + } +} + +// The ends do not wrap: rolling from the last report to the first would hide +// that you had reached the end. +func TestReportStepsStopAtTheEnds(t *testing.T) { + m := reportModel(t, 3) + + updated, _ := m.updateModal(tea.KeyMsg{Type: tea.KeyLeft}) + m = updated.(Model) + if m.selectedVuln != 0 { + t.Fatalf("left from the first report moved to %d, want 0", m.selectedVuln) + } + + m.selectedVuln = 2 + updated, _ = m.updateModal(tea.KeyMsg{Type: tea.KeyRight}) + m = updated.(Model) + if m.selectedVuln != 2 { + t.Fatalf("right from the last report moved to %d, want 2", m.selectedVuln) + } +} + +// Each direction is offered only when there is a report that way, and a lone +// finding is offered neither. +func TestReportNavigationHintsFollowAvailability(t *testing.T) { + m := reportModel(t, 3) + for _, testCase := range []struct { + index int + wantPrev, wantNext bool + position string + }{ + {index: 0, wantNext: true, position: "1/3"}, + {index: 1, wantPrev: true, wantNext: true, position: "2/3"}, + {index: 2, wantPrev: true, position: "3/3"}, + } { + m.selectedVuln = testCase.index + view := ansi.Strip(m.modalView()) + if !strings.Contains(view, testCase.position) { + t.Fatalf("report %d does not show %q", testCase.index, testCase.position) + } + if got := strings.Contains(view, reportPrev); got != testCase.wantPrev { + t.Fatalf("report %d prev hint = %v, want %v", testCase.index, got, testCase.wantPrev) + } + if got := strings.Contains(view, reportNext); got != testCase.wantNext { + t.Fatalf("report %d next hint = %v, want %v", testCase.index, got, testCase.wantNext) + } + } + + lone := reportModel(t, 1) + view := ansi.Strip(lone.modalView()) + if strings.Contains(view, reportPrev) || strings.Contains(view, reportNext) || strings.Contains(view, "1/1") { + t.Fatalf("a lone finding offered navigation:\n%s", view) + } +} + +// A new report opens at its top, and the copy state does not carry over. +func TestSteppingResetsTheReportView(t *testing.T) { + m := reportModel(t, 3) + m.vulnerabilityCopied = true + m.vulnViewport.SetYOffset(3) + + m.showVulnerability(1) + + if m.vulnViewport.YOffset != 0 { + t.Fatalf("the next report opened scrolled to %d", m.vulnViewport.YOffset) + } + if m.vulnerabilityCopied { + t.Fatal("the copy state carried over to another report") + } +} + +// Prev and Next are buttons, not just key hints: they can be clicked. +func TestReportStepButtonsAreClickable(t *testing.T) { + m := reportModel(t, 3) + m.selectedVuln = 1 + + click := func(label string) Model { + t.Helper() + view := m.modalView() + left, top, _, _ := m.centeredViewBounds(view) + for row, line := range strings.Split(view, "\n") { + plain := ansi.Strip(line) + index := strings.Index(plain, label) + if index < 0 { + continue + } + updated, _ := m.updateModalMouse(tea.MouseMsg{ + X: left + ansi.StringWidth(plain[:index]) + 1, Y: top + row, + Button: tea.MouseButtonLeft, Action: tea.MouseActionPress, + }) + return updated.(Model) + } + t.Fatalf("%q was not rendered", label) + return m + } + + if got := click(reportNext).selectedVuln; got != 2 { + t.Fatalf("clicking Next selected %d, want 2", got) + } + if got := click(reportPrev).selectedVuln; got != 0 { + t.Fatalf("clicking Prev selected %d, want 0", got) + } + if got := click(reportNext).modal; got != modalVulnerability { + t.Fatalf("clicking Next closed the report: modal=%v", got) + } +} + +// Tab walks the whole row, so the step buttons are reachable from the keyboard +// as well, and Enter presses whichever one is focused. +func TestTabReachesTheStepButtons(t *testing.T) { + m := reportModel(t, 3) + m.selectedVuln = 1 + + if got := m.focusedReportButton(); got != reportDone { + t.Fatalf("the report opened focused on %q, want %q", got, reportDone) + } + seen := map[string]bool{} + for range len(m.reportButtons()) { + updated, _ := m.updateModal(tea.KeyMsg{Type: tea.KeyTab}) + m = updated.(Model) + seen[m.focusedReportButton()] = true + } + for _, want := range []string{reportPrev, reportNext, reportCopy, reportDone} { + if !seen[want] { + t.Fatalf("tab never reached %q: %v", want, seen) + } + } + + // Enter on a focused step button steps. + m.reportFocus = reportNext + updated, _ := m.updateModal(tea.KeyMsg{Type: tea.KeyEnter}) + if got := updated.(Model).selectedVuln; got != 2 { + t.Fatalf("enter on Next selected %d, want 2", got) + } +} + +// Stepping to an end drops that button from the row; focus must not be stranded +// on it. +func TestFocusFallsBackWhenAStepButtonDisappears(t *testing.T) { + m := reportModel(t, 2) + m.selectedVuln = 0 + m.reportFocus = reportNext + + updated, _ := m.updateModal(tea.KeyMsg{Type: tea.KeyEnter}) + m = updated.(Model) + + if m.selectedVuln != 1 { + t.Fatalf("enter on Next selected %d, want 1", m.selectedVuln) + } + // Next is gone at the last report, so the focus cannot still be on it. + if got := m.focusedReportButton(); got == reportNext { + t.Fatalf("focus stayed on a button that is no longer shown: %q", got) + } + if got := m.focusedReportButton(); got != reportDone { + t.Fatalf("focus fell back to %q, want %q", got, reportDone) + } +} + +// The list must be laid out at one width. Rendering at one and hit-testing at +// another gives two different row counts for the same title, and then a click +// resolves to the wrong finding and the scrollbar reports the wrong length. +func TestFindingsUseOneWidthForRenderAndInteraction(t *testing.T) { + // This title wraps to one row at 21 columns and two at 20, which is exactly + // the pair of widths the two paths used to disagree on. + m := findingsModel(t, "ffffff dddd a a a a", "eeeee eeeee a a a a", "header dddd a a a a") + + width := m.vulnerabilityListWidth() + rows := m.vulnerabilityRows(width) + rendered := strings.Split(ansi.Strip(m.vulnerabilitiesView(width, len(rows))), "\n") + + if len(rendered) != len(rows) { + t.Fatalf("rendered %d rows, interaction counts %d", len(rendered), len(rows)) + } + for row := range rendered { + if got := m.vulnerabilityIndexAtRow(row); got != rows[row].index { + t.Fatalf("row %d shows finding %d but a click resolves to %d", + row, rows[row].index, got) + } + } + if total, _ := m.vulnerabilityScrollRows(); total != len(rendered) { + t.Fatalf("the scrollbar reports %d rows, %d are rendered", total, len(rendered)) + } +} diff --git a/strix/interface/tui/internal/app/frame_bench_test.go b/strix/interface/tui/internal/app/frame_bench_test.go new file mode 100644 index 00000000..404a71dd --- /dev/null +++ b/strix/interface/tui/internal/app/frame_bench_test.go @@ -0,0 +1,98 @@ +package app + +import ( + "bytes" + "encoding/base64" + "fmt" + "image" + "image/color" + "image/png" + "testing" + + "github.com/usestrix/strix/tui/internal/protocol" + "github.com/usestrix/strix/tui/internal/render" +) + +func benchImageDataURI(b *testing.B, w, h int) string { + b.Helper() + img := image.NewRGBA(image.Rect(0, 0, w, h)) + for y := range h { + for x := range w { + img.Set(x, y, color.RGBA{R: uint8(x), G: uint8(y), B: 0x40, A: 0xff}) + } + } + var buf bytes.Buffer + if err := png.Encode(&buf, img); err != nil { + b.Fatal(err) + } + return "data:image/png;base64," + base64.StdEncoding.EncodeToString(buf.Bytes()) +} + +// BenchmarkChatContentWithImages measures a frame render for a trace holding +// many inline images, the case that made the TUI unresponsive. +func BenchmarkChatContentWithImages(b *testing.B) { + supported := render.KittyGraphicsSupported + render.KittyGraphicsSupported = func() bool { return true } + b.Cleanup(func() { render.KittyGraphicsSupported = supported }) + + model := New(nil) + model.width, model.height = 130, 40 + model.showSplash = false + model.ready = true + events := make([]protocol.Event, 0, 20) + for i := range 20 { + events = append(events, protocol.Event{ + ID: fmt.Sprintf("%d", i), AgentID: "one", Type: "tool", + Data: map[string]any{ + "tool_name": "view_image", + "args": map[string]any{"path": fmt.Sprintf("/tmp/shot-%d.png", i)}, + "result": benchImageDataURI(b, 2000+i, 1400), + "status": "completed", + }, + }) + } + model.snapshot = protocol.Snapshot{ + Agents: []protocol.Agent{{ID: "one", Name: "Agent", Status: "running"}}, + Events: events, + } + model.resizeViewport() + + b.ResetTimer() + for b.Loop() { + _ = model.View() + } +} + +func BenchmarkFrameWithImagesAfterUpdate(b *testing.B) { + supported := render.KittyGraphicsSupported + render.KittyGraphicsSupported = func() bool { return true } + b.Cleanup(func() { render.KittyGraphicsSupported = supported }) + + model := New(nil) + model.width, model.height = 130, 40 + model.showSplash = false + model.ready = true + events := make([]protocol.Event, 0, 20) + for i := range 20 { + events = append(events, protocol.Event{ + ID: fmt.Sprintf("%d", i), AgentID: "one", Type: "tool", + Data: map[string]any{ + "tool_name": "view_image", + "args": map[string]any{"path": fmt.Sprintf("/tmp/shot-%d.png", i)}, + "result": benchImageDataURI(b, 2000+i, 1400), + "status": "completed", + }, + }) + } + model.snapshot = protocol.Snapshot{ + Agents: []protocol.Agent{{ID: "one", Name: "Agent", Status: "running"}}, + Events: events, + } + model.resizeViewport() + + b.ResetTimer() + for b.Loop() { + model.refreshViewport() + _ = model.View() + } +} diff --git a/strix/interface/tui/internal/app/input_test.go b/strix/interface/tui/internal/app/input_test.go new file mode 100644 index 00000000..c7f74828 --- /dev/null +++ b/strix/interface/tui/internal/app/input_test.go @@ -0,0 +1,216 @@ +package app + +import ( + "strings" + "testing" + + tea "github.com/charmbracelet/bubbletea" + "github.com/charmbracelet/lipgloss" + "github.com/charmbracelet/x/ansi" + "github.com/usestrix/strix/tui/internal/protocol" +) + +func inputModel(t *testing.T) Model { + t.Helper() + model := New(nil) + model.showSplash = false + model.ready = true + model.width, model.height = 130, 40 + model.resizeViewport() + return model +} + +func TestInputGrowsWithContentUpToCap(t *testing.T) { + model := inputModel(t) + // The live composer opens at a single row, out of the trace's way. + if got := model.input.Height(); got != 1 { + t.Fatalf("empty composer height = %d, want 1", got) + } + model.input.SetValue(strings.Repeat("line\n", 4) + "line") + model.resizeViewport() + if got := model.input.Height(); got != 5 { + t.Fatalf("5-line composer height = %d, want 5", got) + } + model.input.SetValue(strings.Repeat("line\n", 19) + "line") + model.resizeViewport() + if got := model.input.Height(); got != maxInputLines { + t.Fatalf("20-line composer height = %d, want %d", got, maxInputLines) + } +} + +// The launch composer opens with room to breathe; the live one stays a single +// row until there is something to show, as it always has. +func TestComposerOpeningHeightPerMode(t *testing.T) { + live := inputModel(t) + if got := live.input.Height(); got != 1 { + t.Fatalf("live composer opens at %d rows, want 1", got) + } + + setup := inputModel(t) + setup.snapshot.SetupMode = true + setup.resizeViewport() + if got := setup.input.Height(); got != minInputLines { + t.Fatalf("launch composer opens at %d rows, want %d", got, minInputLines) + } +} + +// A prompt with no newline in it still has to grow the composer once it wraps. +func TestInputGrowsWithSoftWrappedLine(t *testing.T) { + for _, setup := range []bool{false, true} { + model := inputModel(t) + model.snapshot.SetupMode = setup + model.resizeViewport() + floor, _ := model.composerBounds() + if got := model.input.Height(); got != floor { + t.Fatalf("setup=%v: empty composer height = %d, want floor %d", setup, got, floor) + } + width := model.input.Width() + model.input.SetValue(strings.Repeat("x", width*5-1)) + model.resizeViewport() + // Five rows of text; the textarea adds a trailing row when the last one + // is full, so the cursor stays visible. + if got := model.input.Height(); got < 5 || got > 6 { + t.Fatalf("setup=%v: wrapped composer height = %d, want 5 or 6", setup, got) + } + model.input.SetValue(strings.Repeat("x", width*maxInputLines*2)) + model.resizeViewport() + if got := model.input.Height(); got != maxInputLines { + t.Fatalf("setup=%v: overlong composer height = %d, want %d", setup, got, maxInputLines) + } + } +} + +// The composer never takes more than a third of a short terminal. +func TestInputHeightCappedOnShortTerminal(t *testing.T) { + model := inputModel(t) + model.width, model.height = 130, 15 + model.input.SetValue(strings.Repeat("line\n", 10) + "line") + model.resizeViewport() + if got := model.input.Height(); got != 5 { + t.Fatalf("composer height on a 15-row terminal = %d, want 5", got) + } +} + +// The rendered frame must be exactly the terminal size at every step of +// typing. A composer that renders one cell too wide gets re-wrapped into an +// extra row, which pushes the frame past the bottom of the terminal and makes +// the screen jump at wrap points. +func TestFrameFitsTerminalWhileTyping(t *testing.T) { + sizes := [][2]int{{130, 40}, {100, 30}, {80, 24}} + for _, setup := range []bool{false, true} { + for _, size := range sizes { + model := New(nil) + model.showSplash, model.ready, model.focus = false, true, focusInput + model.width, model.height = size[0], size[1] + model.snapshot = protocol.Snapshot{SetupMode: setup, Model: "anthropic/claude-sonnet-4-5"} + if !setup { + model.snapshot.Agents = []protocol.Agent{{ID: "a1", Name: "recon", Status: "running"}} + } + model.resizeViewport() + for i, r := range strings.Repeat("alpha bravo charlie delta echo foxtrot ", 6) { + updated, _ := model.Update(tea.KeyMsg{Type: tea.KeyRunes, Runes: []rune{r}}) + model = updated.(Model) + rows := strings.Split(model.View(), "\n") + if len(rows) != size[1] { + t.Fatalf("setup=%v %v: after %d chars the frame is %d rows, want %d", + setup, size, i+1, len(rows), size[1]) + } + for row, line := range rows { + if width := lipgloss.Width(line); width != size[0] { + t.Fatalf("setup=%v %v: after %d chars row %d is %d cells, want %d", + setup, size, i+1, row, width, size[0]) + } + } + } + } + } +} + +// The launch column is anchored: growing the composer must not walk the +// wordmark and the prompt up the screen. +func TestLaunchColumnHoldsStillWhileComposerGrows(t *testing.T) { + model := New(nil) + model.showSplash, model.ready, model.focus = false, true, focusInput + model.width, model.height = 130, 40 + model.snapshot = protocol.Snapshot{SetupMode: true} + model.resizeViewport() + composerRow := func() int { + for row, line := range strings.Split(ansi.Strip(model.View()), "\n") { + if strings.Contains(line, "╭") { + return row + } + } + return -1 + } + want := composerRow() + for i, r := range strings.Repeat("alpha bravo charlie delta echo ", 12) { + updated, _ := model.Update(tea.KeyMsg{Type: tea.KeyRunes, Runes: []rune{r}}) + model = updated.(Model) + if got := composerRow(); got != want { + t.Fatalf("after %d chars the composer moved to row %d, want %d (height %d)", + i+1, got, want, model.input.Height()) + } + } + if model.input.Height() < 5 { + t.Fatalf("composer only grew to %d rows; the test is not exercising growth", model.input.Height()) + } +} + +func TestCtrlJInsertsNewline(t *testing.T) { + model := inputModel(t) + model.input.SetValue("hello") + updated, _ := model.Update(tea.KeyMsg{Type: tea.KeyCtrlJ}) + model = updated.(Model) + if got := model.input.Value(); got != "hello\n" { + t.Fatalf("value after ctrl+j = %q, want %q", got, "hello\n") + } +} + +func TestEnterSubmitsTrimmedMultilineMessage(t *testing.T) { + model := inputModel(t) + model.input.SetValue("first\nsecond ") + updated, _ := model.Update(tea.KeyMsg{Type: tea.KeyEnter}) + model = updated.(Model) + if got := model.input.Value(); got != "" { + t.Fatalf("composer not cleared after submit: %q", got) + } + if got := model.input.Height(); got != 1 { + t.Fatalf("composer height after submit = %d, want 1", got) + } +} + +func TestDragSelectionInInputCopiesText(t *testing.T) { + model := inputModel(t) + copied := "" + original := writeClipboard + writeClipboard = func(text string) error { + copied = text + return nil + } + defer func() { writeClipboard = original }() + + model.input.SetValue("copy me please") + model.resizeViewport() + top := model.inputTop() + + updated, _ := model.updateMouse(tea.MouseMsg{ + X: 4, Y: top + 1, Button: tea.MouseButtonLeft, Action: tea.MouseActionPress, + }) + model = updated.(Model) + if !model.selection.dragging || model.selection.region != regionInput { + t.Fatalf("press in the composer did not start an input selection: %+v", model.selection) + } + updated, _ = model.updateMouse(tea.MouseMsg{X: 10, Y: top + 1, Action: tea.MouseActionMotion}) + model = updated.(Model) + updated, cmd := model.updateMouse(tea.MouseMsg{Action: tea.MouseActionRelease}) + model = updated.(Model) + if cmd == nil { + t.Fatal("input selection release produced no copy command") + } + if msg, ok := cmd().(selectionCopiedMsg); !ok || msg.err != nil { + t.Fatalf("unexpected copy result: %#v", cmd()) + } + if copied != "copy me" { + t.Fatalf("copied %q, want %q", copied, "copy me") + } +} diff --git a/strix/interface/tui/internal/app/model.go b/strix/interface/tui/internal/app/model.go new file mode 100644 index 00000000..2cacb8eb --- /dev/null +++ b/strix/interface/tui/internal/app/model.go @@ -0,0 +1,410 @@ +package app + +import ( + "fmt" + "strings" + "time" + + "github.com/atotto/clipboard" + "github.com/charmbracelet/bubbles/key" + "github.com/charmbracelet/bubbles/textarea" + "github.com/charmbracelet/bubbles/viewport" + tea "github.com/charmbracelet/bubbletea" + "github.com/charmbracelet/lipgloss" + "github.com/charmbracelet/x/ansi" + "github.com/usestrix/strix/tui/internal/protocol" +) + +type wireMsg protocol.Envelope +type wireErrMsg struct{ err error } +type sentMsg struct { + requestID string + command string + collection string + err error +} +type splashTickMsg time.Time +type sweepTickMsg time.Time +type vulnerabilityCopiedMsg struct{ err error } + +var writeClipboard = clipboard.WriteAll + +type collectionAssembly struct { + kind string + revision int + baseRevision int + cursor int + agents []protocol.Agent + events []protocol.Event + findings []map[string]any + operations []protocol.CollectionOperation + ids map[string]bool +} + +// appVersion is the package version string shown on the splash and stats panel. +// It is set by main from the STRIX_VERSION env var (see go_tui.py), matching +// Python's get_package_version() which reads the installed "strix-agent" version +// and falls back to "dev". +var appVersion = "dev" + +// SetVersion overrides the displayed version; empty values are ignored so the +// "dev" fallback survives when the launcher does not provide one. +func SetVersion(v string) { + if strings.TrimSpace(v) != "" { + appVersion = strings.TrimSpace(v) + } +} + +type modalMode int + +const ( + modalNone modalMode = iota + modalHelp + modalQuit + modalStop + modalConfirmMount + modalVulnerability +) + +type focusMode int + +const ( + focusInput focusMode = iota + focusChat + focusAgents + focusVulnerabilities +) + +type scrollbarTarget int + +const ( + scrollbarNone scrollbarTarget = iota + scrollbarTrace + scrollbarAgents + scrollbarFindings +) + +type Model struct { + client *Client + width, height int + snapshot protocol.Snapshot + input textarea.Model + viewport viewport.Model + viewportContent string + vulnViewport viewport.Model + modal modalMode + focus focusMode + options []string + filtered []string + cursor int + collapsedAgents map[string]bool + expandedEvents map[string]bool + blockCache map[string]renderedBlock + eventSpans []eventSpan + setupLog []string + pendingPrompt string + errorText string + fatalError error + selectedAgent int + selectedVuln int + agentOffset int + vulnOffset int + modalChoice int + reportFocus string + ready bool + quitting bool + showSplash bool + splashStarted time.Time + splashFrame int + sweepFrame int + budgetPauseNotified bool + followOutput bool + selection selectionState + toast string + toastID int + draggingScrollbar scrollbarTarget + stateRevision int + collectionRevisions map[string]int + collectionAssemblies map[string]*collectionAssembly + resyncRequested map[string]bool + resyncRequests map[string]string + seenMessages map[string]bool + vulnerabilityCopied bool + vulnerabilityCopyError string +} + +var ( + green = lipgloss.Color("#22c55e") + brightGreen = lipgloss.Color("#4ade80") + blue = lipgloss.Color("#3b82f6") + lightBlue = lipgloss.Color("#60a5fa") + red = lipgloss.Color("#ef4444") + orange = lipgloss.Color("#ea580c") + amber = lipgloss.Color("#d97706") + white = lipgloss.Color("#fafaf9") + brightWhite = lipgloss.Color("#ffffff") + textColor = lipgloss.Color("#d4d4d4") + dim = lipgloss.Color("#737373") + mid = lipgloss.Color("#a3a3a3") + dark = lipgloss.Color("#333333") + black = lipgloss.Color("#000000") +) + +// Agent tree colors: a uniform label, dim guides, and a filled block cursor. +const ( + treeLabel = lipgloss.Color("#e7e5e4") + treeGuide = lipgloss.Color("#4f4f4f") + treeCursorFg = lipgloss.Color("#ddedf9") + treeCursorBg = lipgloss.Color("#0178d4") +) + +// Scrollbar thumbs. The track stays blank so a scrollable panel does not gain a +// visible rule down its edge, and the thumb brightens while it is dragged, which +// is the feedback Textual gave through scrollbar-color-active. +// +// One resting color for every panel, rather than the three the stylesheet named. +// The chat pane's was #1a1a1a on black, which is invisible - the bar could not be +// found, let alone grabbed (#1005). +const ( + thumbResting = lipgloss.Color("#3f3f46") + thumbActive = lipgloss.Color("#9ca3af") +) + +// Composer placeholders. The launch screen falls back to the short prompt when +// the column is too narrow to show the full one without clipping it. +const ( + setupPlaceholder = "Describe what to test, or name a target" + setupPlaceholderShort = "What should Strix test?" + chatPlaceholder = "Send a message" +) + +// The composer opens at minInputLines rows for breathing room and grows with +// its content up to maxInputLines. +const ( + minInputLines = 3 + maxInputLines = 8 +) + +// newChatInput builds the multi-line chat composer. Enter submits (handled by +// the update loop before the textarea sees it); Shift/Alt+Enter and Ctrl+J +// insert a newline. +func newChatInput() textarea.Model { + input := textarea.New() + input.ShowLineNumbers = false + input.CharLimit = 4096 + input.MaxHeight = maxInputLines + input.SetHeight(1) + input.KeyMap.InsertNewline = key.NewBinding( + key.WithKeys("shift+enter", "alt+enter", "ctrl+j"), + key.WithHelp("shift+enter", "insert newline"), + ) + plain := lipgloss.NewStyle() + text := lipgloss.NewStyle().Foreground(textColor) + placeholder := lipgloss.NewStyle().Foreground(lipgloss.Color("#525252")) + for _, style := range []*textarea.Style{&input.FocusedStyle, &input.BlurredStyle} { + style.Base = plain + style.CursorLine = text + style.EndOfBuffer = plain + style.Placeholder = placeholder + style.Text = text + } + input.FocusedStyle.Prompt = lipgloss.NewStyle().Bold(true).Foreground(green) + input.BlurredStyle.Prompt = lipgloss.NewStyle().Foreground(dim) + input.SetPromptFunc(2, func(lineIdx int) string { + if lineIdx == 0 { + return "> " + } + return " " + }) + input.Cursor.Style = lipgloss.NewStyle().Foreground(green) + return input +} + +// composerBounds returns the floor and ceiling row counts for the composer at +// the current terminal height. A short terminal shrinks the ceiling so a long +// prompt cannot crowd out everything above it. +// +// Only the launch screen opens taller than a single row: there the composer is +// the whole screen and wants breathing room, while during a scan it sits under +// the trace and stays out of the way until there is something to show. +func (m Model) composerBounds() (floor, ceiling int) { + ceiling = maxInputLines + if m.height > 0 { + ceiling = max(minInputLines, min(maxInputLines, m.height/3)) + } + floor = 1 + if m.snapshot.SetupMode { + floor = min(minInputLines, ceiling) + } + return floor, ceiling +} + +// syncInputHeight grows or shrinks the composer with its content, between the +// floor and ceiling. +func (m *Model) syncInputHeight() { + floor, ceiling := m.composerBounds() + m.input.SetHeight(max(floor, min(composerHeight(m.input), ceiling))) +} + +// composerHeight is how many rows the composer needs to show all of its +// content, capped at maxInputLines. Soft-wrapped rows count: a single long +// line still grows the box. LineCount only counts hard newlines, and the +// wrapped height the textarea does report covers just the line the cursor is +// on, so a scratch copy measures each line with the composer's own wrapping. +func composerHeight(input textarea.Model) int { + probe, rows := input, 0 + for _, line := range strings.Split(input.Value(), "\n") { + // A line narrower than the text column cannot wrap, which is the case + // for nearly every keystroke; only measure the ones that might. + if ansi.StringWidth(line) < input.Width() { + rows++ + } else { + probe.SetValue(line) + rows += probe.LineInfo().Height + } + if rows >= maxInputLines { + return maxInputLines + } + } + return max(1, rows) +} + +func New(client *Client) Model { + input := newChatInput() + input.Placeholder = setupPlaceholder + input.Focus() + return Model{ + client: client, input: input, viewport: viewport.New(80, 20), vulnViewport: viewport.New(80, 20), + collapsedAgents: map[string]bool{}, expandedEvents: map[string]bool{}, blockCache: map[string]renderedBlock{}, showSplash: true, splashStarted: time.Now(), followOutput: true, + collectionRevisions: map[string]int{}, collectionAssemblies: map[string]*collectionAssembly{}, resyncRequested: map[string]bool{}, resyncRequests: map[string]string{}, + seenMessages: map[string]bool{}, + } +} + +func (m Model) Init() tea.Cmd { return tea.Batch(readWire(m.client), splashTick(), sweepTick()) } + +// splashTick drives the splash "Starting Strix Agent" shimmer at Python's 0.1s cadence. +func splashTick() tea.Cmd { + return tea.Tick(100*time.Millisecond, func(t time.Time) tea.Msg { return splashTickMsg(t) }) +} + +// sweepTick drives the running-status sweep animation at Python's 0.06s cadence. +func sweepTick() tea.Cmd { + return tea.Tick(60*time.Millisecond, func(t time.Time) tea.Msg { return sweepTickMsg(t) }) +} + +func readWire(client *Client) tea.Cmd { + return func() tea.Msg { + envelope, err := client.Read() + if err != nil { + return wireErrMsg{err} + } + return wireMsg(envelope) + } +} + +func send(client *Client, command string, payload any) tea.Cmd { + return func() tea.Msg { + requestID, err := client.Send(command, payload) + collection := "" + if values, ok := payload.(map[string]any); ok { + collection, _ = values["collection"].(string) + } + return sentMsg{requestID: requestID, command: command, collection: collection, err: err} + } +} + +func (m Model) Update(msg tea.Msg) (tea.Model, tea.Cmd) { + var cmds []tea.Cmd + switch msg := msg.(type) { + case splashTickMsg: + m.splashFrame++ + if m.showSplash && time.Since(m.splashStarted) >= 4500*time.Millisecond { + m.showSplash = false + } + return m, splashTick() + case sweepTickMsg: + m.sweepFrame++ + return m, sweepTick() + case tea.WindowSizeMsg: + m.width, m.height = msg.Width, msg.Height + m.resizeViewport() + m.resizeVulnerabilityViewport() + m.ensureAgentVisible() + m.ensureVulnerabilityVisible() + case wireErrMsg: + if !m.quitting { + m.errorText = "Backend disconnected: " + msg.err.Error() + m.fatalError = fmt.Errorf("backend disconnected: %w", msg.err) + } + return m, tea.Quit + case wireMsg: + envelope := protocol.Envelope(msg) + if envelope.Version != protocol.Version { + m.errorText = fmt.Sprintf("Protocol mismatch: backend=%d client=%d", envelope.Version, protocol.Version) + m.fatalError = fmt.Errorf("protocol mismatch: backend=%d client=%d", envelope.Version, protocol.Version) + return m, tea.Quit + } + if cmd := m.handleEnvelope(envelope); cmd != nil { + cmds = append(cmds, cmd) + } + cmds = append(cmds, readWire(m.client)) + case sentMsg: + if msg.err != nil { + m.errorText = msg.err.Error() + if msg.command == "collection.resync" && msg.collection != "" { + m.resyncRequested[msg.collection] = false + } + } else if msg.command == "collection.resync" && msg.requestID != "" && msg.collection != "" { + m.resyncRequests[msg.requestID] = msg.collection + } + case selectionCopiedMsg: + text := "Copied to clipboard" + if msg.err != nil { + text = "Copy failed: " + msg.err.Error() + } + return m, m.showToast(text) + case toastExpiredMsg: + if msg.id == m.toastID { + m.toast = "" + if !m.selection.dragging { + m.selection.active = false + } + } + return m, nil + case vulnerabilityCopiedMsg: + m.vulnerabilityCopied = msg.err == nil + m.vulnerabilityCopyError = "" + if msg.err != nil { + m.vulnerabilityCopyError = msg.err.Error() + } + return m, nil + case tea.KeyMsg: + if m.showSplash { + switch msg.String() { + case "ctrl+c", "ctrl+q", "q", "esc": + m.quitting = true + return m, tea.Batch(send(m.client, "app.quit", map[string]any{}), tea.Quit) + } + m.showSplash = false + return m, nil + } + if m.modal != modalNone { + return m.updateModal(msg) + } + return m.updateMain(msg) + case tea.MouseMsg: + if m.showSplash || !m.ready { + return m, nil + } + return m.updateMouse(msg) + } + var cmd tea.Cmd + if m.modal == modalNone { + m.input, cmd = m.input.Update(msg) + } + cmds = append(cmds, cmd) + return m, tea.Batch(cmds...) +} + +func (m Model) FatalError() error { return m.fatalError } diff --git a/strix/interface/tui/internal/app/model_test.go b/strix/interface/tui/internal/app/model_test.go new file mode 100644 index 00000000..2b9f0dfb --- /dev/null +++ b/strix/interface/tui/internal/app/model_test.go @@ -0,0 +1,1289 @@ +package app + +import ( + "bytes" + "encoding/binary" + "encoding/json" + "fmt" + "strings" + "testing" + + tea "github.com/charmbracelet/bubbletea" + "github.com/charmbracelet/lipgloss" + "github.com/charmbracelet/x/ansi" + "github.com/usestrix/strix/tui/internal/protocol" +) + +type recordingConn struct{ bytes.Buffer } + +func (c *recordingConn) Close() error { return nil } + +func commandFromCmd(t *testing.T, cmd tea.Cmd, connection *recordingConn) protocol.Envelope { + t.Helper() + if cmd == nil { + t.Fatal("expected command") + } + msg := cmd() + if sent, ok := msg.(sentMsg); !ok || sent.err != nil { + t.Fatalf("command failed: %#v", msg) + } + raw := connection.Bytes() + if len(raw) < 4 { + t.Fatalf("short command frame: %d bytes", len(raw)) + } + size := int(binary.BigEndian.Uint32(raw[:4])) + if len(raw) != size+4 { + t.Fatalf("command frame size = %d, want %d", len(raw), size+4) + } + var envelope protocol.Envelope + if err := json.Unmarshal(raw[4:], &envelope); err != nil { + t.Fatal(err) + } + return envelope +} + +func newCommandTestModel(t *testing.T) (Model, *recordingConn) { + t.Helper() + connection := &recordingConn{} + return New(&Client{conn: connection}), connection +} + +func handleCommandResult(t *testing.T, model *Model, command string, result any) tea.Cmd { + t.Helper() + resultPayload, err := json.Marshal(result) + if err != nil { + t.Fatal(err) + } + payload, err := json.Marshal(protocol.CommandResult{OK: true, Command: command, Result: resultPayload}) + if err != nil { + t.Fatal(err) + } + if model.client == nil { + model.client = newClient(&recordingConn{}) + } + if model.client.pending == nil { + model.client.pending = map[string]string{} + model.client.pendingByKey = map[string]string{} + model.client.requestKeyByID = map[string]string{} + } + requestID := fmt.Sprintf("test-%d", len(model.client.pending)+1) + model.client.pending[requestID] = command + model.client.pendingByKey[command] = requestID + model.client.requestKeyByID[requestID] = command + return model.handleEnvelope(protocol.Envelope{Version: protocol.Version, Type: "command_result", RequestID: requestID, Payload: payload}) +} + +func stateEnvelope(t *testing.T, revision int, state protocol.Snapshot) protocol.Envelope { + t.Helper() + payload, err := json.Marshal(protocol.StateUpdate{Revision: revision, State: state}) + if err != nil { + t.Fatal(err) + } + return protocol.Envelope{Version: protocol.Version, Type: "state", Payload: payload} +} + +func rawJSON(t *testing.T, value any) json.RawMessage { + t.Helper() + raw, err := json.Marshal(value) + if err != nil { + t.Fatal(err) + } + return raw +} + +func bootstrapEnvelope(t *testing.T, collection string, revision int, items ...any) protocol.Envelope { + t.Helper() + rawItems := make([]json.RawMessage, 0, len(items)) + for _, item := range items { + rawItems = append(rawItems, rawJSON(t, item)) + } + payload := protocol.CollectionBootstrap{ + Collection: collection, Revision: revision, Cursor: 0, NextCursor: len(rawItems), Done: true, Items: rawItems, + } + return protocol.Envelope{Version: protocol.Version, Type: "collection_bootstrap", Payload: rawJSON(t, payload)} +} + +func TestBackendDisconnectBecomesFatalUnlessUserIsQuitting(t *testing.T) { + model := New(nil) + updated, cmd := model.Update(wireErrMsg{err: fmt.Errorf("socket closed")}) + result := updated.(Model) + if cmd == nil || result.FatalError() == nil { + t.Fatalf("backend disconnect was not fatal: cmd=%v error=%v", cmd, result.FatalError()) + } + + model = New(nil) + model.quitting = true + updated, _ = model.Update(wireErrMsg{err: fmt.Errorf("socket closed")}) + if quitting := updated.(Model); quitting.FatalError() != nil { + t.Fatalf("intentional quit became fatal: %v", quitting.FatalError()) + } +} + +func TestCollectionBootstrapChunksAndVersionedDelta(t *testing.T) { + model := New(nil) + first := protocol.Event{ID: "event-1", Version: 0, Type: "chat", AgentID: "agent", Data: map[string]any{"content": "one"}} + second := protocol.Event{ID: "event-2", Version: 0, Type: "chat", AgentID: "agent", Data: map[string]any{"content": "two"}} + + firstChunk := protocol.CollectionBootstrap{ + Collection: "events", Revision: 1, Cursor: 0, NextCursor: 1, Items: []json.RawMessage{rawJSON(t, first)}, + } + model.handleEnvelope(protocol.Envelope{Version: protocol.Version, Type: "collection_bootstrap", Payload: rawJSON(t, firstChunk)}) + if len(model.snapshot.Events) != 0 { + t.Fatal("partial bootstrap mutated installed events") + } + lastChunk := protocol.CollectionBootstrap{ + Collection: "events", Revision: 1, Cursor: 1, NextCursor: 2, Done: true, Items: []json.RawMessage{rawJSON(t, second)}, + } + model.handleEnvelope(protocol.Envelope{Version: protocol.Version, Type: "collection_bootstrap", Payload: rawJSON(t, lastChunk)}) + if len(model.snapshot.Events) != 2 || model.collectionRevisions["events"] != 1 { + t.Fatalf("bootstrap was not installed: %#v revisions=%#v", model.snapshot.Events, model.collectionRevisions) + } + + first.Version = 1 + first.Data["content"] = "updated" + delta := protocol.CollectionDelta{ + Collection: "events", BaseRevision: 1, Revision: 2, Cursor: 0, NextCursor: 1, Done: true, + Operations: []protocol.CollectionOperation{{Op: "upsert", Item: rawJSON(t, first)}}, + } + model.handleEnvelope(protocol.Envelope{Version: protocol.Version, Type: "collection_delta", Payload: rawJSON(t, delta)}) + if model.snapshot.Events[0].Version != 1 || model.snapshot.Events[0].Data["content"] != "updated" || model.collectionRevisions["events"] != 2 { + t.Fatalf("delta was not applied: %#v", model.snapshot.Events[0]) + } + + deleteDelta := protocol.CollectionDelta{ + Collection: "events", BaseRevision: 2, Revision: 3, Cursor: 0, NextCursor: 1, Done: true, + Operations: []protocol.CollectionOperation{{Op: "delete", ID: "event-2"}}, + } + model.handleEnvelope(protocol.Envelope{Version: protocol.Version, Type: "collection_delta", Payload: rawJSON(t, deleteDelta)}) + if len(model.snapshot.Events) != 1 || model.snapshot.Events[0].ID != "event-1" || model.collectionRevisions["events"] != 3 { + t.Fatalf("delete delta was not applied: %#v", model.snapshot.Events) + } +} + +func TestCollectionMismatchRequestsOneResync(t *testing.T) { + connection := &recordingConn{} + model := New(newClient(connection)) + model.collectionRevisions["events"] = 4 + bad := protocol.CollectionDelta{ + Collection: "events", BaseRevision: 2, Revision: 3, Cursor: 0, NextCursor: 0, Done: true, + } + + cmd := model.handleEnvelope(protocol.Envelope{Version: protocol.Version, Type: "collection_delta", Payload: rawJSON(t, bad)}) + if cmd == nil { + t.Fatal("revision mismatch did not request a resync") + } + message := cmd() + if sent, ok := message.(sentMsg); !ok || sent.err != nil || sent.command != "collection.resync" { + t.Fatalf("resync send = %#v", message) + } + if retry := model.handleEnvelope(protocol.Envelope{Version: protocol.Version, Type: "collection_delta", Payload: rawJSON(t, bad)}); retry != nil { + t.Fatal("same mismatch submitted more than one resync") + } + if model.collectionRevisions["events"] != 4 { + t.Fatal("mismatched delta mutated collection revision") + } +} + +func TestAgentsCollectionPreservesSelectedIDAcrossUpsertsAndDeletes(t *testing.T) { + model := New(nil) + model.handleEnvelope(bootstrapEnvelope(t, "agents", 1, + protocol.Agent{ID: "root", Name: "Root", Status: "running"}, + protocol.Agent{ID: "selected", Name: "Selected", Status: "running"}, + protocol.Agent{ID: "other", Name: "Other", Status: "waiting"}, + )) + model.selectedAgent = 1 + + updated := protocol.Agent{ID: "selected", Name: "Selected updated", Status: "budget_paused"} + delta := protocol.CollectionDelta{ + Collection: "agents", BaseRevision: 1, Revision: 2, Cursor: 0, NextCursor: 2, Done: true, + Operations: []protocol.CollectionOperation{ + {Op: "delete", ID: "root"}, + {Op: "upsert", Item: rawJSON(t, updated)}, + }, + } + model.handleEnvelope(protocol.Envelope{Version: protocol.Version, Type: "collection_delta", Payload: rawJSON(t, delta)}) + if got := model.snapshot.Agents[model.selectedAgent].ID; got != "selected" { + t.Fatalf("selected agent changed to %q after delta", got) + } + if model.snapshot.Agents[model.selectedAgent].Status != "budget_paused" { + t.Fatalf("agent upsert was not applied: %#v", model.snapshot.Agents[model.selectedAgent]) + } + + deleteSelected := protocol.CollectionDelta{ + Collection: "agents", BaseRevision: 2, Revision: 3, Cursor: 0, NextCursor: 1, Done: true, + Operations: []protocol.CollectionOperation{{Op: "delete", ID: "selected"}}, + } + model.handleEnvelope(protocol.Envelope{Version: protocol.Version, Type: "collection_delta", Payload: rawJSON(t, deleteSelected)}) + if len(model.snapshot.Agents) != 1 || model.snapshot.Agents[model.selectedAgent].ID != "other" { + t.Fatalf("selected-agent delete did not fall back safely: %#v", model.snapshot.Agents) + } +} + +// Typing a slash must not surface a command list; the start screen takes prompts +// and targets only. +func TestSetupOffersNoSlashCommands(t *testing.T) { + model := New(nil) + model.width, model.height = 100, 50 + model.showSplash = false + model.handleEnvelope(stateEnvelope(t, 1, protocol.Snapshot{SetupMode: true, ScanState: "setup"})) + + model.input.SetValue("/") + model.resizeViewport() + view := ansi.Strip(model.View()) + for _, gone := range []string{"/target", "/start", "/clear", "/prompt", "/quit", "/help"} { + if strings.Contains(view, gone) { + t.Fatalf("a slash command menu still appears for %q: %s", gone, view) + } + } +} + +func TestSetupUsesDedicatedStartScreen(t *testing.T) { + model := New(nil) + model.width, model.height = 130, 34 + model.showSplash = false + state := protocol.Snapshot{ + SetupMode: true, + ScanState: "setup", + Model: "gpt-5.4", + Targets: []string{"/workspace/source", "https://example.com"}, + Instruction: "focus on access control", + ScanMode: "quick", + MaxBudgetUSD: floatPointer(12.5), + MaxTurns: 275, + ScopeMode: "diff", + DiffBase: "origin/main", + Agents: []protocol.Agent{{ID: "hidden", Name: "SETUP_SHOULD_HIDE_AGENT", Status: "running"}}, + } + model.handleEnvelope(stateEnvelope(t, 1, state)) + + view := model.View() + for _, want := range []string{ + "gpt-5.4", + "/workspace/source", + "https://example.com", + } { + if !strings.Contains(view, want) { + t.Fatalf("start screen is missing %q: %s", want, view) + } + } + if strings.Contains(view, "SETUP_SHOULD_HIDE_AGENT") { + t.Fatalf("live scan sidebar appeared on the start screen: %s", view) + } +} + +func floatPointer(value float64) *float64 { return &value } + +func TestStartedSnapshotTransitionsToLiveView(t *testing.T) { + model := New(nil) + model.width, model.height = 130, 34 + model.showSplash = false + model.handleEnvelope(stateEnvelope(t, 1, protocol.Snapshot{SetupMode: true, ScanState: "setup"})) + if view := model.View(); !strings.Contains(view, setupPlaceholder) { + t.Fatalf("setup snapshot did not show the start screen: %s", view) + } + + runningState := protocol.Snapshot{ + SetupMode: false, + ScanStarted: true, + ScanState: "running", + } + model.handleEnvelope(stateEnvelope(t, 2, runningState)) + model.handleEnvelope(bootstrapEnvelope(t, "agents", 1, protocol.Agent{ID: "one", Name: "LIVE_AGENT", Status: "running"})) + view := model.View() + if !strings.Contains(view, "LIVE_AGENT") || !strings.Contains(view, "Send a message") || strings.Contains(view, "Configure your pentest") { + t.Fatalf("started snapshot did not switch to the live view: %s", view) + } + if model.input.Placeholder != "Send a message" { + t.Fatalf("live input placeholder was not updated: %q", model.input.Placeholder) + } +} + +func TestSetupStartScreenFitsNarrowTerminal(t *testing.T) { + model := New(nil) + model.width, model.height = 40, 18 + model.showSplash = false + model.handleEnvelope(stateEnvelope(t, 1, protocol.Snapshot{SetupMode: true, ScanState: "setup"})) + model.input.SetValue("/") + model.resizeViewport() + + view := ansi.Strip(model.viewInner()) + // A narrow terminal falls back to the plain wordmark, but the launch screen + // never gives up its identity entirely. + topRow := ansi.Strip(strings.SplitN(wordmark(), "\n", 2)[0]) + if !strings.Contains(view, topRow) && !strings.Contains(view, "STRIX") { + t.Fatalf("narrow start screen logo is missing: %s", view) + } + lines := strings.Split(view, "\n") + if len(lines) > model.height { + t.Fatalf("start screen height %d exceeds terminal height %d", len(lines), model.height) + } + for _, line := range lines { + if width := lipgloss.Width(line); width > model.width { + t.Fatalf("start screen line width %d exceeds terminal width %d: %q", width, model.width, ansi.Strip(line)) + } + } +} + +// A leading slash is ordinary prompt text now: there are no commands to match, +// so it must reach the scan as written rather than being rejected. +func TestLeadingSlashIsPromptTextNotACommand(t *testing.T) { + connection := &recordingConn{} + model := New(&Client{conn: connection}) + model.snapshot = protocol.Snapshot{SetupMode: true} + model.focus = focusInput + model.input.SetValue("/etc/passwd is world readable, check it") + + updated, cmd := model.updateMain(tea.KeyMsg{Type: tea.KeyEnter}) + result := updated.(Model) + if cmd == nil { + t.Fatal("enter did not submit") + } + types := commandTypes(drainCommands(t, cmd, connection)) + if !contains(types, "setup.start") { + t.Fatalf("a slash-leading prompt did not launch a scan: %v", types) + } + // The path is read as a target and the sentence as the instruction. + if !contains(types, "setup.add_target") || !contains(types, "setup.set_instruction") { + t.Fatalf("slash-leading prompt was not split into target and instruction: %v", types) + } + for _, line := range result.setupLog { + if strings.Contains(ansi.Strip(line), "Unknown command") { + t.Fatalf("a slash-leading prompt was treated as a command: %#v", result.setupLog) + } + } +} + +// The composer is cleared on submit and the prompt is not echoed into the log. +func TestSubmittedPromptIsNotEchoedInOutput(t *testing.T) { + model := New(nil) + model.snapshot.SetupMode = true + updated, _ := model.submitSetupPrompt("secret instruction") + result := updated.(Model) + if content := result.setupContent(); strings.Contains(content, "secret instruction") { + t.Fatalf("submitted prompt leaked into output: %s", content) + } +} + +func TestStateMessagesRenderOnce(t *testing.T) { + model := New(nil) + message := protocol.Message{ID: "setup-1", Text: "Replace the rejected key", Level: "warning"} + model.handleEnvelope(stateEnvelope(t, 1, protocol.Snapshot{SetupMode: true, Messages: []protocol.Message{message}})) + model.handleEnvelope(stateEnvelope(t, 2, protocol.Snapshot{SetupMode: true, Messages: []protocol.Message{message}})) + if len(model.setupLog) != 1 || !strings.Contains(ansi.Strip(model.setupLog[0]), message.Text) { + t.Fatalf("setup message was not rendered exactly once: %#v", model.setupLog) + } +} + +func TestMouseActivatesQuitPromptButtons(t *testing.T) { + model := New(nil) + model.width, model.height = 100, 30 + model.modal = modalQuit + view := model.modalView() + left, top, _, _ := model.centeredViewBounds(view) + + buttonPosition := func(label string) (int, int) { + t.Helper() + for row, line := range strings.Split(view, "\n") { + plain := ansi.Strip(line) + if index := strings.Index(plain, label); index >= 0 { + return left + ansi.StringWidth(plain[:index]), top + row + } + } + t.Fatalf("button %q not found", label) + return 0, 0 + } + + x, y := buttonPosition("No") + updated, cmd := model.updateMouse(tea.MouseMsg{X: x, Y: y, Button: tea.MouseButtonLeft, Action: tea.MouseActionPress}) + result := updated.(Model) + if result.modal != modalNone || result.quitting || cmd != nil { + t.Fatalf("No did not dismiss quit prompt: modal=%v quitting=%v cmd=%v", result.modal, result.quitting, cmd) + } + + model.modal = modalQuit + view = model.modalView() + left, top, _, _ = model.centeredViewBounds(view) + x, y = buttonPosition("Yes") + updated, cmd = model.updateMouse(tea.MouseMsg{X: x, Y: y, Button: tea.MouseButtonLeft, Action: tea.MouseActionPress}) + result = updated.(Model) + if !result.quitting || cmd == nil { + t.Fatalf("Yes did not confirm quit: quitting=%v cmd=%v", result.quitting, cmd) + } +} + +func TestModalKeepsBackgroundVisible(t *testing.T) { + model := New(nil) + model.width, model.height = 130, 30 + model.showSplash = false + model.ready = true + model.snapshot = protocol.Snapshot{Agents: []protocol.Agent{{ID: "one", Name: "UNIQUE_AGENT", Status: "running"}}} + model.resizeViewport() + model.modal = modalHelp + view := model.View() + if !strings.Contains(view, "UNIQUE_AGENT") { + t.Fatalf("modal overlay hid the background agent tree") + } + if !strings.Contains(view, "Strix Help") { + t.Fatalf("modal content missing") + } +} + +func TestChatWrapsWithinChatWidth(t *testing.T) { + model := New(nil) + model.width, model.height = 130, 30 + model.showSplash = false + model.ready = true + long := strings.Repeat("word ", 200) + model.snapshot = protocol.Snapshot{ + Agents: []protocol.Agent{{ID: "one", Name: "Agent", Status: "running"}}, + Events: []protocol.Event{{ID: "1", AgentID: "one", Type: "chat", Data: map[string]any{"role": "assistant", "content": long}}}, + } + model.resizeViewport() + for _, line := range strings.Split(model.chatContent(), "\n") { + if lipgloss.Width(line) > model.viewport.Width { + t.Fatalf("chat line width %d exceeds viewport width %d", lipgloss.Width(line), model.viewport.Width) + } + } +} + +func TestSnapshotRendersSelectedAgentEventsOnly(t *testing.T) { + model := New(nil) + model.width, model.height = 100, 30 + model.showSplash = false + model.ready = true + model.snapshot = protocol.Snapshot{ + SetupMode: false, + Agents: []protocol.Agent{{ID: "one", Name: "Agent One", Status: "running"}, {ID: "two", Name: "Agent Two", Status: "waiting"}}, + Events: []protocol.Event{ + {ID: "1", AgentID: "one", Type: "chat", Data: map[string]any{"role": "assistant", "content": "first"}}, + {ID: "2", AgentID: "two", Type: "chat", Data: map[string]any{"role": "assistant", "content": "second"}}, + }, + } + model.refreshViewport() + view := model.View() + if !strings.Contains(view, "first") || strings.Contains(view, "second") { + t.Fatalf("incorrect selected-agent events: %s", view) + } +} + +func TestVulnerabilityDetailScrollsWithoutHidingFooter(t *testing.T) { + model := New(nil) + model.width, model.height = 130, 40 + model.snapshot.Vulnerabilities = []map[string]any{{ + "title": "Long finding", + "severity": "high", + "description": strings.Repeat("detail line\n", 100), + }} + model.openModal(modalVulnerability) + + view := model.modalView() + if !strings.Contains(view, "Done") { + t.Fatalf("finding footer is not visible before scrolling: %s", view) + } + _, wantHeight := model.vulnerabilityDialogSize() + if got := len(strings.Split(view, "\n")); got != wantHeight { + t.Fatalf("finding dialog height = %d, want %d", got, wantHeight) + } + + updated, _ := model.updateModal(tea.KeyMsg{Type: tea.KeyPgDown}) + model = updated.(Model) + if model.modal != modalVulnerability || model.vulnViewport.YOffset == 0 { + t.Fatalf("page down dismissed or did not scroll finding: modal=%v offset=%d", model.modal, model.vulnViewport.YOffset) + } + if view = model.modalView(); !strings.Contains(view, "Done") { + t.Fatalf("finding footer disappeared after scrolling: %s", view) + } + + before := model.vulnViewport.YOffset + modalLeft, modalTop, _, _ := model.centeredViewBounds(model.modalView()) + updated, _ = model.updateModalMouse(tea.MouseMsg{X: modalLeft + 4, Y: modalTop + 3, Button: tea.MouseButtonWheelDown}) + model = updated.(Model) + if model.vulnViewport.YOffset <= before { + t.Fatalf("mouse wheel did not scroll finding: before=%d after=%d", before, model.vulnViewport.YOffset) + } + updated, _ = model.updateModal(tea.KeyMsg{Type: tea.KeyEsc}) + if updated.(Model).modal != modalNone { + t.Fatal("escape did not close finding detail") + } +} + +func TestVulnerabilityCopySupportsKeyboardAndMouse(t *testing.T) { + originalWriteClipboard := writeClipboard + t.Cleanup(func() { writeClipboard = originalWriteClipboard }) + var copied []string + writeClipboard = func(value string) error { + copied = append(copied, value) + return nil + } + + newModel := func() Model { + model := New(nil) + model.width, model.height = 130, 40 + model.snapshot.Vulnerabilities = []map[string]any{{ + "title": "Copy me", "severity": "high", "description": "Finding detail", + }} + model.openModal(modalVulnerability) + return model + } + + model := newModel() + // Tab moves between the buttons; the arrows step between reports. + updated, _ := model.updateModal(tea.KeyMsg{Type: tea.KeyTab}) + model = updated.(Model) + updated, cmd := model.updateModal(tea.KeyMsg{Type: tea.KeyEnter}) + model = updated.(Model) + if cmd == nil || model.modal != modalVulnerability { + t.Fatalf("keyboard Copy did not keep the detail open: modal=%v cmd=%v", model.modal, cmd) + } + updated, _ = model.Update(cmd()) + model = updated.(Model) + if len(copied) != 1 || !strings.Contains(copied[0], "Copy me") || !strings.Contains(copied[0], "Finding detail") { + t.Fatalf("keyboard Copy wrote unexpected report: %#v", copied) + } + if !model.vulnerabilityCopied || !strings.Contains(ansi.Strip(model.modalView()), "Copied!") { + t.Fatal("successful keyboard Copy was not reflected in the dialog") + } + + model = newModel() + view := model.modalView() + left, top, _, _ := model.centeredViewBounds(view) + copyX, copyY := -1, -1 + for row, line := range strings.Split(view, "\n") { + plain := ansi.Strip(line) + if index := strings.Index(plain, "Copy"); index >= 0 { + copyX, copyY = left+ansi.StringWidth(plain[:index]), top+row + } + } + if copyX < 0 { + t.Fatal("Copy button was not rendered") + } + updated, cmd = model.updateModalMouse(tea.MouseMsg{ + X: copyX, Y: copyY, Button: tea.MouseButtonLeft, Action: tea.MouseActionPress, + }) + model = updated.(Model) + if cmd == nil || model.reportFocus != reportCopy { + t.Fatalf("mouse Copy was not activated: focus=%q cmd=%v", model.reportFocus, cmd) + } + cmd() + if len(copied) != 2 { + t.Fatalf("mouse Copy calls = %d, want 2", len(copied)) + } +} + +func TestVulnerabilitySelectionStaysVisible(t *testing.T) { + model := New(nil) + model.width, model.height = 130, 30 + model.focus = focusVulnerabilities + for i := 0; i < 20; i++ { + model.snapshot.Vulnerabilities = append(model.snapshot.Vulnerabilities, map[string]any{ + "title": fmt.Sprintf("Finding %02d", i), + }) + } + for range 15 { + updated, _ := model.updateMain(tea.KeyMsg{Type: tea.KeyDown}) + model = updated.(Model) + } + + view := ansi.Strip(model.vulnerabilitiesView(30, 10)) + if !strings.Contains(view, "Finding 15") || strings.Contains(view, "Finding 00") { + t.Fatalf("selected finding was not kept in the visible window: %s", view) + } +} + +func TestVulnerabilityListSupportsWheelAndPageNavigation(t *testing.T) { + model := New(nil) + model.width, model.height = 130, 30 + for i := 0; i < 20; i++ { + model.snapshot.Vulnerabilities = append(model.snapshot.Vulnerabilities, map[string]any{ + "title": fmt.Sprintf("Finding %02d", i), + }) + } + _, _, chatWidth, _ := model.layout() + _, _, agentHeight := model.sidebarHeights() + pageItems := model.vulnerabilityPageItems() + + updated, _ := model.updateMouse(tea.MouseMsg{ + X: chatWidth + 2, Y: model.viewerHeight() + agentHeight + 1, Button: tea.MouseButtonWheelDown, + }) + model = updated.(Model) + if model.focus != focusVulnerabilities || model.vulnOffset != 3 || model.selectedVuln != 3 { + t.Fatalf("wheel scroll did not focus and advance list: focus=%v offset=%d selected=%d", model.focus, model.vulnOffset, model.selectedVuln) + } + + updated, _ = model.updateMain(tea.KeyMsg{Type: tea.KeyPgDown}) + model = updated.(Model) + if model.selectedVuln != 3+pageItems { + t.Fatalf("page down selected %d", model.selectedVuln) + } + updated, _ = model.updateMain(tea.KeyMsg{Type: tea.KeyEnd}) + model = updated.(Model) + if model.selectedVuln != 19 { + t.Fatalf("end selected %d, want 19", model.selectedVuln) + } + view := ansi.Strip(model.vulnerabilitiesView(30, model.vulnerabilityPageSize())) + if !strings.Contains(view, "Finding 19") || strings.Contains(view, "Finding 00") { + t.Fatalf("end did not scroll the final finding into view: %s", view) + } +} + +func TestAgentTreeWheelScrollSurvivesSnapshot(t *testing.T) { + model := New(nil) + model.width, model.height = 130, 30 + model.ready = true + for i := 0; i < 40; i++ { + model.snapshot.Agents = append(model.snapshot.Agents, protocol.Agent{ + ID: fmt.Sprintf("agent-%02d", i), Name: fmt.Sprintf("Agent %02d", i), Status: "running", + }) + } + _, _, chatWidth, _ := model.layout() + + updated, _ := model.updateMouse(tea.MouseMsg{ + X: chatWidth + 2, Y: model.viewerHeight() + 2, Button: tea.MouseButtonWheelDown, + }) + model = updated.(Model) + if model.focus != focusAgents || model.agentOffset != 3 || model.selectedAgent != 3 { + t.Fatalf("wheel scroll did not advance tree: focus=%v offset=%d selected=%d", model.focus, model.agentOffset, model.selectedAgent) + } + + model.handleEnvelope(stateEnvelope(t, 1, model.snapshot)) + if model.agentOffset != 3 || model.selectedAgent != 3 { + t.Fatalf("snapshot reset manual tree scroll: offset=%d selected=%d", model.agentOffset, model.selectedAgent) + } +} + +func TestVulnerabilityDetailFitsNarrowTerminal(t *testing.T) { + model := New(nil) + model.width, model.height = 32, 15 + model.snapshot.Vulnerabilities = []map[string]any{{ + "title": "Narrow finding", + "description": strings.Repeat("long detail ", 50), + }} + model.openModal(modalVulnerability) + view := model.modalView() + + if !strings.Contains(view, "Done") { + t.Fatalf("finding footer is missing in narrow terminal: %s", view) + } + if got := len(strings.Split(view, "\n")); got > model.height { + t.Fatalf("finding dialog height %d exceeds terminal height %d", got, model.height) + } + for _, line := range strings.Split(view, "\n") { + if got := lipgloss.Width(line); got > model.width { + t.Fatalf("finding dialog width %d exceeds terminal width %d", got, model.width) + } + } +} + +func TestAgentTreeUsesDepthFirstOrderAndStableSelectionPosition(t *testing.T) { + parentRoot := "root" + parentA := "a" + model := New(nil) + model.snapshot.Agents = []protocol.Agent{ + {ID: "root", Name: "Root", Status: "running"}, + {ID: "a", ParentID: &parentRoot, Name: "Agent A", Status: "running"}, + {ID: "b", ParentID: &parentRoot, Name: "Agent B", Status: "running"}, + {ID: "a-child", ParentID: &parentA, Name: "Agent A Child", Status: "running"}, + } + + entries := agentTreeEntries(model.snapshot.Agents, nil) + var order []string + for _, entry := range entries { + order = append(order, model.snapshot.Agents[entry.index].ID) + } + if got, want := strings.Join(order, ","), "root,a,a-child,b"; got != want { + t.Fatalf("agent tree order = %q, want %q", got, want) + } + if view := ansi.Strip(model.agentsView(50, 10)); !strings.Contains(view, "▼") { + t.Fatalf("expanded agent does not show its toggle: %s", view) + } + // A leaf carries no toggle at all, so its icon sits where a parent's + // toggle would be. + for _, line := range strings.Split(ansi.Strip(model.agentsView(50, 10)), "\n") { + if strings.Contains(line, "Agent B") && !strings.HasSuffix(line, "└─ ⚪ Agent B") { + t.Fatalf("leaf row reserved toggle space: %q", line) + } + } + + model.selectedAgent = 1 + selectedView := ansi.Strip(model.agentsView(50, 10)) + model.selectedAgent = 2 + unselectedView := ansi.Strip(model.agentsView(50, 10)) + lineFor := func(view, label string) string { + t.Helper() + for _, line := range strings.Split(view, "\n") { + if strings.Contains(line, label) { + return line + } + } + t.Fatalf("agent row %q not found in %s", label, view) + return "" + } + if selected, unselected := strings.Index(lineFor(selectedView, "Agent A"), "Agent A"), strings.Index(lineFor(unselectedView, "Agent A"), "Agent A"); selected != unselected { + t.Fatalf("selection moved agent label from column %d to %d", unselected, selected) + } + + // The cursor is a filled block behind the label; no row carries a gutter + // accent, which would indent every node past the panel padding. + if strings.ContainsAny(selectedView, "┃") { + t.Fatalf("agent rows drew a gutter accent: %s", selectedView) + } + + model.focus = focusAgents + model.selectedAgent = 1 + updated, _ := model.updateMain(tea.KeyMsg{Type: tea.KeyDown}) + result := updated.(Model) + if got := result.snapshot.Agents[result.selectedAgent].ID; got != "a-child" { + t.Fatalf("down selected %q, want depth-first child", got) + } + + updated, _ = model.updateMain(tea.KeyMsg{Type: tea.KeyEnter}) + result = updated.(Model) + collapsed := agentTreeEntries(result.snapshot.Agents, result.collapsedAgents) + for _, entry := range collapsed { + if result.snapshot.Agents[entry.index].ID == "a-child" { + t.Fatal("collapsed parent still rendered its child") + } + } + if view := ansi.Strip(result.agentsView(50, 10)); !strings.Contains(view, "▶") { + t.Fatalf("collapsed agent does not show its toggle: %s", view) + } +} + +func TestAgentClickUsesRenderedWindowAfterResize(t *testing.T) { + model := New(nil) + model.width, model.height = 130, 20 + for i := range 20 { + model.snapshot.Agents = append(model.snapshot.Agents, protocol.Agent{ + ID: fmt.Sprintf("agent-%02d", i), Name: fmt.Sprintf("Agent %02d", i), Status: "running", + }) + } + model.selectedAgent = 15 + model.ensureAgentVisible() + if model.agentOffset == 0 { + t.Fatal("test setup did not scroll the agent tree") + } + + model.height = 60 + model.ensureAgentVisible() + _, _, chatWidth, _ := model.layout() + updated, _ := model.updateMouse(tea.MouseMsg{X: chatWidth + 1, Y: model.viewerHeight() + 2, Button: tea.MouseButtonLeft, Action: tea.MouseActionPress}) + result := updated.(Model) + if result.selectedAgent != 0 { + t.Fatalf("click selected snapshot index %d instead of first rendered agent", result.selectedAgent) + } +} + +func TestFindingTitlesWrapAndViewerCTAIsClickable(t *testing.T) { + model := New(nil) + model.width, model.height = 130, 30 + model.snapshot.Vulnerabilities = []map[string]any{{ + "title": "A finding title that is intentionally long enough to wrap onto multiple lines", + }} + + view := ansi.Strip(model.vulnerabilitiesView(model.vulnerabilityListWidth(), 10)) + if strings.Count(view, "\n") < 1 || strings.Contains(view, "…") { + t.Fatalf("finding title was not wrapped: %s", view) + } + if cta := ansi.Strip(model.viewerView(40)); !strings.Contains(cta, "Watch live in browser") { + t.Fatalf("viewer CTA is missing: %s", cta) + } + + _, _, chatWidth, _ := model.layout() + _, cmd := model.updateMouse(tea.MouseMsg{ + X: chatWidth + 2, Y: 1, Button: tea.MouseButtonLeft, Action: tea.MouseActionPress, + }) + if cmd == nil { + t.Fatal("clicking viewer CTA did not send viewer.open") + } +} + +func TestRunningViewerShowsCompleteWrappedURL(t *testing.T) { + model := New(nil) + model.width, model.height = 130, 30 + url := "http://127.0.0.1:43123/?token=abcdefghijklmnopqrstuvwxyz0123456789" + model.snapshot.ViewerStatus = "running" + model.snapshot.ViewerURL = &url + + view := ansi.Strip(model.viewerView(18)) + if !strings.Contains(view, "Viewer running") { + t.Fatalf("viewer status is missing: %s", view) + } + urlLines := strings.Split(strings.SplitN(view, "\n", 2)[1], "\n") + for i := range urlLines { + urlLines[i] = strings.TrimRight(urlLines[i], " ") + } + if got := strings.Join(urlLines, ""); got != url { + t.Fatalf("wrapped viewer URL = %q, want %q", got, url) + } + if want := strings.Count(model.viewerView(model.viewerContentWidth()), "\n") + 3; model.viewerHeight() != want { + t.Fatalf("viewer height = %d, want %d", model.viewerHeight(), want) + } +} + +func TestVerticalScrollbarThumbTracksScrollOffset(t *testing.T) { + top := strings.Split(ansi.Strip(verticalScrollbar(6, 24, 6, 0, thumbResting)), "\n") + bottom := strings.Split(ansi.Strip(verticalScrollbar(6, 24, 6, 18, thumbResting)), "\n") + + // The track is blank, so only the thumb is drawn. + if top[0] != "█" || top[5] != " " { + t.Fatalf("top scrollbar is incorrect: %#v", top) + } + if bottom[0] != " " || bottom[5] != "█" { + t.Fatalf("bottom scrollbar is incorrect: %#v", bottom) + } + if full := verticalScrollbar(4, 4, 4, 0, thumbResting); full != "" { + t.Fatalf("non-overflowing scrollbar should be hidden: %q", full) + } + withoutBar := ansi.Strip(withVerticalScrollbar("content", 12, 2, 2, 2, 0, thumbResting)) + if strings.ContainsAny(withoutBar, "█") { + t.Fatalf("non-overflowing panel rendered a scrollbar: %q", withoutBar) + } +} + +// The bar takes exactly one column, so a scrolling panel keeps the rest. +func TestVerticalScrollbarOccupiesOneColumn(t *testing.T) { + rows := strings.Split(withVerticalScrollbar("content", 12, 2, 24, 2, 0, thumbResting), "\n") + for _, row := range rows { + if width := ansi.StringWidth(row); width != 12 { + t.Fatalf("scrolling panel row width = %d, want 12", width) + } + } + if !strings.Contains(ansi.Strip(rows[0]), "█") { + t.Fatalf("thumb missing from the first row: %q", rows[0]) + } +} + +func TestPanelPaddingResetsLeakingLineBackground(t *testing.T) { + leaky := "\x1b[48;2;82;82;82mstyled" + body := fixedPanelBody(leaky, 12, 1) + want := "styled\x1b[0m" + blackBG + if !strings.Contains(body, want) { + t.Fatalf("panel padding did not reset the source background: %q", body) + } + if width := ansi.StringWidth(body); width != 12 { + t.Fatalf("fixed panel body width = %d, want 12", width) + } +} + +func TestMainTraceTreeAndFindingsRenderScrollbars(t *testing.T) { + model := New(nil) + model.width, model.height = 150, 35 + model.ready = true + for i := 0; i < 40; i++ { + model.snapshot.Agents = append(model.snapshot.Agents, protocol.Agent{ + ID: fmt.Sprintf("agent-%02d", i), Name: fmt.Sprintf("Agent %02d", i), Status: "running", + }) + } + for i := 0; i < 20; i++ { + model.snapshot.Vulnerabilities = append(model.snapshot.Vulnerabilities, map[string]any{ + "title": fmt.Sprintf("Finding %02d", i), + }) + } + model.resizeViewport() + model.viewportContent = strings.Repeat("trace line\n", 100) + model.viewport.SetContent(model.viewportContent) + model.viewport.SetYOffset(10) + + view := ansi.Strip(model.mainView()) + if count := strings.Count(view, "█"); count < 3 { + t.Fatalf("expected scroll thumbs in trace, tree, and findings; found %d\n%s", count, view) + } +} + +func TestMainScrollbarsSupportClickAndDrag(t *testing.T) { + model := New(nil) + model.width, model.height = 150, 35 + model.ready = true + for i := 0; i < 40; i++ { + model.snapshot.Agents = append(model.snapshot.Agents, protocol.Agent{ + ID: fmt.Sprintf("agent-%02d", i), Name: fmt.Sprintf("Agent %02d", i), Status: "running", + }) + } + for i := 0; i < 20; i++ { + model.snapshot.Vulnerabilities = append(model.snapshot.Vulnerabilities, map[string]any{ + "title": fmt.Sprintf("Finding %02d", i), + }) + } + model.resizeViewport() + model.viewportContent = strings.Repeat("trace line\n", 100) + model.viewport.SetContent(model.viewportContent) + showSidebar, _, chatWidth, chatHeight := model.layout() + viewerHeight := model.viewerHeight() + _, vulnHeight, agentHeight := model.sidebarHeights() + if !showSidebar { + t.Fatal("test requires sidebar") + } + + updated, _ := model.updateMouse(tea.MouseMsg{ + X: chatWidth - 2, Y: chatHeight - 2, Button: tea.MouseButtonLeft, Action: tea.MouseActionPress, + }) + model = updated.(Model) + if model.draggingScrollbar != scrollbarTrace || model.viewport.YOffset == 0 { + t.Fatalf("trace scrollbar click failed: drag=%v offset=%d", model.draggingScrollbar, model.viewport.YOffset) + } + updated, _ = model.updateMouse(tea.MouseMsg{X: chatWidth - 2, Y: 1, Action: tea.MouseActionMotion}) + model = updated.(Model) + if model.viewport.YOffset != 0 { + t.Fatalf("trace scrollbar drag did not reach top: %d", model.viewport.YOffset) + } + updated, _ = model.updateMouse(tea.MouseMsg{Action: tea.MouseActionRelease}) + model = updated.(Model) + if model.draggingScrollbar != scrollbarNone { + t.Fatal("trace scrollbar remained captured after release") + } + + updated, _ = model.updateMouse(tea.MouseMsg{ + X: model.width - 3, Y: viewerHeight + agentHeight - 3, + Button: tea.MouseButtonLeft, Action: tea.MouseActionPress, + }) + model = updated.(Model) + if model.draggingScrollbar != scrollbarAgents || model.agentOffset == 0 { + t.Fatalf("agent scrollbar click failed: drag=%v offset=%d", model.draggingScrollbar, model.agentOffset) + } + updated, _ = model.updateMouse(tea.MouseMsg{Action: tea.MouseActionRelease}) + model = updated.(Model) + + updated, _ = model.updateMouse(tea.MouseMsg{ + X: model.width - 3, Y: viewerHeight + agentHeight + vulnHeight - 2, + Button: tea.MouseButtonLeft, Action: tea.MouseActionPress, + }) + model = updated.(Model) + if model.draggingScrollbar != scrollbarFindings || model.vulnOffset == 0 { + t.Fatalf("findings scrollbar click failed: drag=%v offset=%d", model.draggingScrollbar, model.vulnOffset) + } +} + +func TestTerminalSnapshotWithoutAgentsDoesNotKeepLoading(t *testing.T) { + tests := []struct { + state string + error string + want string + }{ + {state: "failed", error: "authentication rejected", want: "Scan failed"}, + {state: "stopped", want: "Scan stopped"}, + {state: "completed", want: "Scan completed"}, + {state: "preparing", want: "Preparing scan..."}, + } + + for _, tt := range tests { + t.Run(tt.state, func(t *testing.T) { + model := New(nil) + model.viewport.Width, model.viewport.Height = 80, 20 + model.snapshot.ScanState = tt.state + if tt.error != "" { + model.snapshot.Error = &tt.error + } + + content := model.chatContent() + if !strings.Contains(content, tt.want) || strings.Contains(content, "Loading...") { + t.Fatalf("terminal state rendered incorrectly: %s", content) + } + if tt.error != "" && !strings.Contains(content, tt.error) { + t.Fatalf("failure detail was not rendered: %s", content) + } + }) + } +} + +func TestCrashedAndBudgetPausedAgentStatusParity(t *testing.T) { + model := New(nil) + model.width = 100 + model.snapshot.Agents = []protocol.Agent{ + {ID: "crashed", Name: "Crashed agent", Status: "crashed", ErrorMessage: "provider failed"}, + {ID: "paused", Name: "Paused agent", Status: "budget_paused"}, + } + + tree := ansi.Strip(model.agentsView(50, 10)) + if !strings.Contains(tree, "🔴 Crashed agent") || !strings.Contains(tree, "⏸ Paused agent") { + t.Fatalf("agent status icons do not match Textual: %s", tree) + } + crashed := ansi.Strip(model.statusView(100)) + if !strings.Contains(crashed, "provider failed") || !strings.Contains(crashed, "Send message to resume") { + t.Fatalf("crashed status lacks recovery guidance: %s", crashed) + } + model.selectedAgent = 1 + paused := ansi.Strip(model.statusView(100)) + if !strings.Contains(paused, "Budget limit reached") || !strings.Contains(paused, "Send a message to continue") || !strings.Contains(paused, "ctrl-q") { + t.Fatalf("budget-paused status lacks Textual guidance: %s", paused) + } +} + +func TestStopDialogAndCommandAreLimitedToActiveAgents(t *testing.T) { + tests := []struct { + status string + active bool + }{ + {status: "running", active: true}, + {status: "waiting", active: true}, + {status: "budget_paused", active: true}, + {status: "completed"}, + {status: "failed"}, + {status: "crashed"}, + {status: "stopped"}, + } + for _, tt := range tests { + t.Run(tt.status, func(t *testing.T) { + model := New(nil) + model.snapshot.Agents = []protocol.Agent{{ID: "agent", Name: "Agent", Status: tt.status}} + updated, _ := model.updateMain(tea.KeyMsg{Type: tea.KeyEsc}) + result := updated.(Model) + if got := result.modal == modalStop; got != tt.active { + t.Fatalf("stop dialog shown=%v, want %v", got, tt.active) + } + }) + } + + model, connection := newCommandTestModel(t) + model.snapshot.Agents = []protocol.Agent{{ID: "agent", Name: "Agent", Status: "running"}} + model.modal, model.modalChoice = modalStop, 0 + model.snapshot.Agents[0].Status = "completed" + updated, cmd := model.updateModal(tea.KeyMsg{Type: tea.KeyEnter}) + if cmd != nil || updated.(Model).modal != modalNone || connection.Len() != 0 { + t.Fatal("terminal status submitted a stale agent.stop command") + } +} + +func TestBudgetPauseShowsOneWarningToastUntilResumed(t *testing.T) { + model := New(nil) + model.snapshot.Agents = []protocol.Agent{{ID: "root", Name: "Strix", Status: "budget_paused"}} + if cmd := model.notifyBudgetPause(); cmd == nil { + t.Fatal("expected a toast command on first budget pause") + } + if !strings.Contains(model.toast, "Budget limit reached") { + t.Fatalf("toast %q missing budget warning", model.toast) + } + if cmd := model.notifyBudgetPause(); cmd != nil { + t.Fatal("budget toast should fire once per pause") + } + model.snapshot.Agents[0].Status = "running" + if cmd := model.notifyBudgetPause(); cmd != nil { + t.Fatal("no toast expected while running") + } + model.snapshot.Agents[0].Status = "budget_paused" + if cmd := model.notifyBudgetPause(); cmd == nil { + t.Fatal("expected the toast to re-arm after resuming") + } +} + +func TestStatsViewShowsSubscription(t *testing.T) { + model := New(nil) + model.snapshot.Model = "gpt-5" + model.snapshot.Subscription = true + model.snapshot.Usage = map[string]any{"total_tokens": float64(1200), "cost": 3.5} + stats := ansi.Strip(model.statsView()) + if !strings.Contains(stats, "ChatGPT subscription") { + t.Fatalf("stats missing subscription line: %q", stats) + } + if strings.Contains(stats, "$") { + t.Fatalf("subscription runs must not show a cost: %q", stats) + } +} + +func TestVulnerabilityMarkdownReport(t *testing.T) { + report := vulnerabilityMarkdownReport(map[string]any{ + "title": "SQLi in login", + "severity": "high", + "cvss": 8.1, + "description": "Injectable parameter.", + "poc_script_code": "```python\nprint('x')\n```", + "remediation_steps": "Use bound parameters.", + }) + for _, want := range []string{ + "# SQLi in login", "**Severity:** HIGH", "**CVSS:** 8.1", + "## Description", "```python\nprint('x')\n```", "## Remediation", + } { + if !strings.Contains(report, want) { + t.Fatalf("report missing %q:\n%s", want, report) + } + } +} + +func TestChatContentCachesBlocksUntilEventChanges(t *testing.T) { + model := New(nil) + model.width, model.height = 120, 30 + model.showSplash = false + model.ready = true + event := protocol.Event{ + ID: "1", AgentID: "one", Type: "tool", Version: 1, + Data: map[string]any{ + "tool_name": "exec_command", + "args": map[string]any{"cmd": "ls -la"}, + "result": "one\ntwo", + "status": "completed", + }, + } + model.snapshot = protocol.Snapshot{ + Agents: []protocol.Agent{{ID: "one", Name: "Agent", Status: "running"}}, + Events: []protocol.Event{event}, + } + model.resizeViewport() + first := model.chatContent() + if model.chatContent() != first { + t.Fatal("cached render changed without an event change") + } + + updated := event + updated.Version = 2 + updated.Data = map[string]any{ + "tool_name": "exec_command", + "args": map[string]any{"cmd": "whoami"}, + "result": "root", + "status": "completed", + } + model.snapshot.Events = []protocol.Event{updated} + next := model.chatContent() + if !strings.Contains(ansi.Strip(next), "whoami") { + t.Fatalf("new event version was served from cache: %q", ansi.Strip(next)) + } +} + +func TestChatContentRerendersOnWidthAndExpansionChange(t *testing.T) { + model := New(nil) + model.width, model.height = 120, 30 + model.showSplash = false + model.ready = true + model.snapshot = protocol.Snapshot{ + Agents: []protocol.Agent{{ID: "one", Name: "Agent", Status: "running"}}, + Events: []protocol.Event{{ + ID: "1", AgentID: "one", Type: "tool", Version: 1, + Data: map[string]any{ + "tool_name": "exec_command", + "args": map[string]any{"cmd": "seq 40"}, + "result": strings.Repeat("output line\n", 40), + "status": "completed", + }, + }}, + } + model.resizeViewport() + collapsed := model.chatContent() + model.expandedEvents["1"] = true + expanded := model.chatContent() + if strings.Count(expanded, "\n") <= strings.Count(collapsed, "\n") { + t.Fatal("expanding an event was served from cache") + } + model.width = 80 + model.resizeViewport() + narrow := model.chatContent() + for _, line := range strings.Split(narrow, "\n") { + if lipgloss.Width(line) > model.viewport.Width { + t.Fatalf("stale wrapped width after resize: %d > %d", lipgloss.Width(line), model.viewport.Width) + } + } +} + +// A model or backend failure can be a wrapped exception hundreds of columns +// wide and several lines long. The status row is one line of the chat column, so +// an oversized one widens the whole column - JoinHorizontal pads every row to the +// widest - which pushed the sidebar off screen and wrapped the frame. +func TestLongErrorDoesNotBreakTheFrame(t *testing.T) { + model := New(nil) + model.width, model.height = 120, 24 + model.showSplash = false + model.handleEnvelope(stateEnvelope(t, 1, protocol.Snapshot{ScanState: "running"})) + bootstrap := protocol.CollectionBootstrap{ + Collection: "agents", Revision: 1, Cursor: 0, NextCursor: 1, Done: true, + Items: []json.RawMessage{rawJSON(t, protocol.Agent{ID: "a0", Name: "Strix", Status: "running"})}, + } + model.handleEnvelope(protocol.Envelope{ + Version: protocol.Version, Type: "collection_bootstrap", Payload: rawJSON(t, bootstrap), + }) + model.errorText = "litellm.APIConnectionError: OpenrouterException - Connection error " + + "while calling https://openrouter.ai/api/v1/chat/completions: HTTPSConnectionPool" + + "(host='openrouter.ai', port=443): Max retries exceeded\nTraceback (most recent " + + "call last):\n File \"/x/y.py\", line 42, in send\n raise err" + model.resizeViewport() + + lines := strings.Split(model.View(), "\n") + if len(lines) > model.height { + t.Fatalf("frame is %d rows in a %d-row terminal", len(lines), model.height) + } + for i, line := range lines { + if width := ansi.StringWidth(line); width > model.width { + t.Fatalf("row %d is %d columns in a %d-column terminal", i, width, model.width) + } + } + // The sidebar has to survive: its panels are the right edge of the frame. + if !strings.Contains(ansi.Strip(model.View()), "Strix") { + t.Fatal("the agent tree was pushed out of the frame") + } +} + +func TestStatusMessageFlattensAndKeepsItsHint(t *testing.T) { + row := ansi.Strip(statusMessage("boom\nsecond line\twith tabs", red, " · Send message to resume", 60)) + + if strings.Contains(row, "\n") || strings.Contains(row, "\t") { + t.Fatalf("status row is not a single line: %q", row) + } + if !strings.HasSuffix(row, " · Send message to resume") { + t.Fatalf("the hint was lost: %q", row) + } + if !strings.Contains(row, "boom second line with tabs") { + t.Fatalf("the message was mangled: %q", row) + } + // A message far too long for the row keeps the hint readable. + long := ansi.Strip(statusMessage(strings.Repeat("x", 500), red, " · Send message to resume", 60)) + if width := ansi.StringWidth(long); width > 60 { + t.Fatalf("status message is %d columns, want at most 60", width) + } + if !strings.HasSuffix(long, " · Send message to resume") { + t.Fatalf("the hint was clipped away: %q", long) + } +} + +// The status row must be exactly as wide as the column it sits in, at every +// terminal size. A narrow terminal cannot fit the quit hint alongside any status +// text, and keeping it anyway made the row wider than the terminal. +func TestStatusRowIsExactlyItsWidth(t *testing.T) { + quitHint := lipgloss.NewStyle().Foreground(white).Render("ctrl-q") + + lipgloss.NewStyle().Foreground(dim).Render(" quit") + longMessage := lipgloss.NewStyle().Foreground(red).Render(strings.Repeat("boom ", 40)) + + for width := 1; width <= 60; width++ { + for _, testCase := range []struct { + name string + left, right string + }{ + {"empty", "", ""}, + {"hint only", "", quitHint}, + {"long message and hint", longMessage, quitHint}, + {"long message alone", longMessage, ""}, + } { + row := composeStatusRow(testCase.left, testCase.right, width) + if got := ansi.StringWidth(row); got != width { + t.Fatalf("%s at width %d rendered %d columns: %q", + testCase.name, width, got, ansi.Strip(row)) + } + if strings.Contains(row, "\n") { + t.Fatalf("%s at width %d spans rows", testCase.name, width) + } + } + } + if row := composeStatusRow("x", "y", 0); row != "" { + t.Fatalf("a zero-width row should be empty, got %q", row) + } +} + +// A running scan in a narrow terminal must not wrap the frame. +func TestNarrowTerminalKeepsTheFrameIntact(t *testing.T) { + for _, width := range []int{8, 10, 13, 14, 20, 40} { + model := New(nil) + model.width, model.height = width, 20 + model.showSplash = false + model.handleEnvelope(stateEnvelope(t, 1, protocol.Snapshot{ScanState: "running"})) + bootstrap := protocol.CollectionBootstrap{ + Collection: "agents", Revision: 1, Cursor: 0, NextCursor: 1, Done: true, + Items: []json.RawMessage{rawJSON(t, protocol.Agent{ID: "a0", Name: "Strix", Status: "running"})}, + } + model.handleEnvelope(protocol.Envelope{ + Version: protocol.Version, Type: "collection_bootstrap", Payload: rawJSON(t, bootstrap), + }) + model.errorText = strings.Repeat("connection failed ", 20) + model.resizeViewport() + + for i, line := range strings.Split(model.View(), "\n") { + if got := ansi.StringWidth(line); got > width { + t.Fatalf("at width %d row %d is %d columns", width, i, got) + } + } + } +} diff --git a/strix/interface/tui/internal/app/selection.go b/strix/interface/tui/internal/app/selection.go new file mode 100644 index 00000000..8aa542e3 --- /dev/null +++ b/strix/interface/tui/internal/app/selection.go @@ -0,0 +1,284 @@ +package app + +// In-app text selection for the chat trace, in the tmux copy-mode style: +// drag with the left mouse button to highlight text, and the plain-text +// selection lands on the clipboard when the button is released. Coordinates +// are anchored to content lines, so an active selection survives scrolling. + +import ( + "strings" + "time" + + tea "github.com/charmbracelet/bubbletea" + "github.com/charmbracelet/x/ansi" +) + +type selectionCopiedMsg struct{ err error } + +type toastExpiredMsg struct{ id int } + +// toastDuration matches the old Textual notify("Copied to clipboard", timeout=2). +const toastDuration = 2 * time.Second + +// showToast displays a transient notification and schedules its dismissal; +// the copy highlight is cleared together with the toast. +func (m *Model) showToast(text string) tea.Cmd { + return m.showToastFor(text, toastDuration) +} + +func (m *Model) showToastFor(text string, duration time.Duration) tea.Cmd { + m.toastID++ + m.toast = text + id := m.toastID + return tea.Tick(duration, func(time.Time) tea.Msg { return toastExpiredMsg{id: id} }) +} + +type selectionRegion int + +const ( + regionChat selectionRegion = iota + regionInput +) + +type selectionState struct { + active bool + dragging bool + region selectionRegion + // Content-line coordinates: anchor is where the drag started, head is + // where the pointer currently is. + anchorLine, anchorCol int + headLine, headCol int +} + +// bounds returns the selection in reading order: (fromLine, fromCol) to +// (toLine, toCol), with toCol exclusive. +func (s selectionState) bounds() (fromLine, fromCol, toLine, toCol int) { + if s.anchorLine < s.headLine || (s.anchorLine == s.headLine && s.anchorCol <= s.headCol) { + return s.anchorLine, s.anchorCol, s.headLine, s.headCol + 1 + } + return s.headLine, s.headCol, s.anchorLine, s.anchorCol + 1 +} + +// styleSelected uses reverse video directly so the highlight renders on any +// terminal profile. +func styleSelected(text string) string { + return "\x1b[7m" + text + "\x1b[27m" +} + +// chatContentCell maps main-view screen coordinates to a content cell inside +// the chat trace, honoring the pane border and the scroll offset. +func (m Model) chatContentCell(x, y int) (line, col int, ok bool) { + _, _, chatWidth, chatHeight := m.layout() + traceHeight := chatHeight - 2 + if x < 1 || x > chatWidth-2 || y < 1 || y > traceHeight { + return 0, 0, false + } + return m.viewport.YOffset + y - 1, x - 1, true +} + +// inputPromptWidth is the composer prompt ("> " / " ") column width; input +// selection coordinates are relative to the text after it. +const inputPromptWidth = 2 + +// inputTop returns the screen row of the composer's top border in the main view. +func (m Model) inputTop() int { + _, _, _, chatHeight := m.layout() + statusH := 0 + if m.statusVisible() { + statusH = 1 + } + return chatHeight + statusH +} + +// inputContentCell maps main-view screen coordinates to a text cell inside +// the composer, honoring the border, padding, and prompt columns. +func (m Model) inputContentCell(x, y int) (line, col int, ok bool) { + _, _, chatWidth, _ := m.layout() + top := m.inputTop() + textLeft := 2 + inputPromptWidth // border + padding, then the prompt + if x < textLeft || x > chatWidth-2 || y <= top || y > top+m.input.Height() { + return 0, 0, false + } + return y - top - 1, x - textLeft, true +} + +func (m *Model) beginSelection(region selectionRegion, line, col int) { + m.selection = selectionState{ + active: true, dragging: true, region: region, + anchorLine: line, anchorCol: col, + headLine: line, headCol: col, + } + m.toast = "" +} + +func (m *Model) extendSelection(line, col int) { + m.selection.headLine = max(0, line) + m.selection.headCol = max(0, col) +} + +// finishSelection ends the drag and copies the highlighted text; a plain +// click (no movement) clears any previous highlight and, in the chat trace, +// toggles the clicked tool's collapsed state. +func (m *Model) finishSelection() tea.Cmd { + m.selection.dragging = false + if m.selection.anchorLine == m.selection.headLine && m.selection.anchorCol == m.selection.headCol { + region := m.selection.region + line := m.selection.anchorLine + m.selection.active = false + if region == regionChat { + m.toggleEventAtLine(line) + } + return nil + } + text := m.selectedText() + if text == "" { + m.selection.active = false + return nil + } + if m.selection.region == regionChat { + if cleaned := cleanCopiedText(text); strings.TrimSpace(cleaned) != "" { + text = cleaned + } + } + return func() tea.Msg { + return selectionCopiedMsg{err: writeClipboard(text)} + } +} + +// iconPrefixes and decorativeLines port StrixTUIApp._ICON_PREFIXES and +// _DECORATIVE_LINES: UI ornaments dropped from copied chat text. +// kittyPlaceholderRune marks kitty graphics placeholder cells, which carry no +// copyable text. +const kittyPlaceholderRune = 0x10eeee + +var iconPrefixes = []string{ + "🐞 ", "🌐 ", "📋 ", "🧠 ", "◆ ", "◇ ", "◈ ", "→ ", "○ ", "● ", "✓ ", "✗ ", + "⚠ ", "▍ ", "▍", "┃ ", "• ", ">_ ", " ", "<~> ", "[ ] ", "[~] ", "[•] ", +} + +var decorativeLines = map[string]bool{ + "● In progress...": true, + "✓ Done": true, + "✗ Failed": true, + "✗ Error": true, + "○ Unknown": true, +} + +// cleanCopiedText ports _clean_copied_text: drop decorative status lines and +// horizontal rules, and strip leading UI icons while keeping indentation. +func cleanCopiedText(text string) string { + var cleaned []string + for _, line := range strings.Split(text, "\n") { + stripped := strings.TrimLeft(line, " \t") + if decorativeLines[stripped] { + continue + } + if stripped != "" && strings.Trim(stripped, "─") == "" { + continue + } + if strings.ContainsRune(stripped, kittyPlaceholderRune) { + continue + } + out := line + for _, prefix := range iconPrefixes { + if strings.HasPrefix(stripped, prefix) { + leading := line[:len(line)-len(stripped)] + out = leading + stripped[len(prefix):] + break + } + } + cleaned = append(cleaned, out) + } + return strings.Join(cleaned, "\n") +} + +// toggleEventAtLine expands or collapses the tool event rendered at the given +// chat content line. +func (m *Model) toggleEventAtLine(line int) { + for _, span := range m.eventSpans { + if line >= span.start && line <= span.end { + m.expandedEvents[span.eventID] = !m.expandedEvents[span.eventID] + m.refreshViewport() + return + } + } +} + +func (m Model) selectedText() string { + fromLine, fromCol, toLine, toCol := m.selection.bounds() + source := m.viewportContent + if m.selection.region == regionInput { + source = m.inputText() + } + lines := strings.Split(source, "\n") + var out []string + for i := max(0, fromLine); i <= min(toLine, len(lines)-1); i++ { + left, right := 0, ansi.StringWidth(lines[i]) + if i == fromLine { + left = fromCol + } + if i == toLine { + right = min(right, toCol) + } + out = append(out, strings.TrimRight(ansi.Strip(ansi.Cut(lines[i], left, right)), " ")) + } + return strings.TrimRight(strings.Join(out, "\n"), "\n") +} + +// inputText returns the composer's visible rows without the prompt columns, +// as the source for input-region selection. +func (m Model) inputText() string { + rows := strings.Split(m.input.View(), "\n") + for i, row := range rows { + rows[i] = ansi.Cut(row, inputPromptWidth, ansi.StringWidth(row)) + } + return strings.Join(rows, "\n") +} + +// highlightInputSelection re-styles the selected cells of the rendered +// composer, shifting columns past the prompt. +func (m Model) highlightInputSelection(view string) string { + if !m.selection.active || m.selection.region != regionInput { + return view + } + return highlightRows(view, 0, m.selection, inputPromptWidth) +} + +// highlightSelection re-styles the selected cells of the visible trace chunk. +// visible holds the rows starting at content line offset. +func (m Model) highlightSelection(visible string, offset int) string { + if !m.selection.active || m.selection.region != regionChat { + return visible + } + return highlightRows(visible, offset, m.selection, 0) +} + +// highlightRows applies reverse video to the selected cells; shift moves the +// selection columns right (for rows with a fixed prefix like the prompt). +func highlightRows(visible string, offset int, selection selectionState, shift int) string { + fromLine, fromCol, toLine, toCol := selection.bounds() + fromCol += shift + toCol += shift + rows := strings.Split(visible, "\n") + for i, row := range rows { + line := offset + i + if line < fromLine || line > toLine { + continue + } + width := ansi.StringWidth(row) + left, right := shift, width + if line == fromLine { + left = min(fromCol, width) + } + if line == toLine { + right = min(toCol, width) + } + if right <= left { + continue + } + rows[i] = ansi.Cut(row, 0, left) + + styleSelected(ansi.Strip(ansi.Cut(row, left, right))) + + ansi.Cut(row, right, width) + } + return strings.Join(rows, "\n") +} diff --git a/strix/interface/tui/internal/app/selection_test.go b/strix/interface/tui/internal/app/selection_test.go new file mode 100644 index 00000000..23f5160a --- /dev/null +++ b/strix/interface/tui/internal/app/selection_test.go @@ -0,0 +1,185 @@ +package app + +import ( + "strings" + "testing" + + tea "github.com/charmbracelet/bubbletea" + + "github.com/usestrix/strix/tui/internal/protocol" +) + +func selectionModel(t *testing.T) Model { + t.Helper() + model := New(nil) + model.showSplash = false + model.ready = true + model.width, model.height = 130, 40 + model.snapshot.Agents = append( + model.snapshot.Agents, + protocol.Agent{ID: "root", Name: "Strix", Status: "running"}, + ) + model.resizeViewport() + model.viewportContent = strings.Join([]string{ + " first line of the trace", + " second line of the trace", + " third line of the trace", + }, "\n") + model.viewport.SetContent(model.viewportContent) + return model +} + +func TestDragSelectionCopiesPlainText(t *testing.T) { + model := selectionModel(t) + copied := "" + original := writeClipboard + writeClipboard = func(text string) error { + copied = text + return nil + } + defer func() { writeClipboard = original }() + + updated, _ := model.updateMouse(tea.MouseMsg{ + X: 2, Y: 1, Button: tea.MouseButtonLeft, Action: tea.MouseActionPress, + }) + model = updated.(Model) + if !model.selection.dragging { + t.Fatal("press in the trace did not start a selection") + } + updated, _ = model.updateMouse(tea.MouseMsg{X: 7, Y: 2, Action: tea.MouseActionMotion}) + model = updated.(Model) + updated, cmd := model.updateMouse(tea.MouseMsg{Action: tea.MouseActionRelease}) + model = updated.(Model) + if cmd == nil { + t.Fatal("selection release produced no copy command") + } + msg := cmd() + if copyMsg, ok := msg.(selectionCopiedMsg); !ok || copyMsg.err != nil { + t.Fatalf("unexpected copy result: %#v", msg) + } + want := "first line of the trace\n second" + if copied != want { + t.Fatalf("copied %q, want %q", copied, want) + } + if model.selection.dragging || !model.selection.active { + t.Fatalf("selection state after release: %+v", model.selection) + } + + updated, tick := model.Update(msg) + model = updated.(Model) + if model.toast != "Copied to clipboard" { + t.Fatalf("toast %q after copy", model.toast) + } + if !strings.Contains(model.View(), "Copied to clipboard") { + t.Fatal("toast is not rendered") + } + if tick == nil { + t.Fatal("toast was not scheduled to expire") + } + updated, _ = model.Update(toastExpiredMsg{id: model.toastID}) + model = updated.(Model) + if model.toast != "" || model.selection.active { + t.Fatalf("toast expiry left toast=%q selection=%+v", model.toast, model.selection) + } +} + +func TestPlainClickClearsSelectionWithoutCopying(t *testing.T) { + model := selectionModel(t) + original := writeClipboard + writeClipboard = func(string) error { + t.Fatal("plain click must not copy") + return nil + } + defer func() { writeClipboard = original }() + + updated, _ := model.updateMouse(tea.MouseMsg{ + X: 2, Y: 1, Button: tea.MouseButtonLeft, Action: tea.MouseActionPress, + }) + model = updated.(Model) + updated, cmd := model.updateMouse(tea.MouseMsg{Action: tea.MouseActionRelease}) + model = updated.(Model) + if cmd != nil { + t.Fatal("plain click produced a command") + } + if model.selection.active { + t.Fatal("plain click left an active selection") + } +} + +func TestHighlightSelectionRestylesSelectedCells(t *testing.T) { + model := selectionModel(t) + model.selection = selectionState{ + active: true, + anchorLine: 0, anchorCol: 1, + headLine: 0, headCol: 5, + } + + visible := model.highlightSelection(model.viewportContent, 0) + lines := strings.Split(visible, "\n") + if !strings.Contains(lines[0], "\x1b[") { + t.Fatalf("selected line was not restyled: %q", lines[0]) + } + if strings.Contains(lines[1], "\x1b[") || strings.Contains(lines[2], "\x1b[") { + t.Fatal("unselected lines were restyled") + } +} + +func TestSelectedTextSpansReversedDrag(t *testing.T) { + model := selectionModel(t) + model.selection = selectionState{ + active: true, + anchorLine: 2, anchorCol: 6, + headLine: 1, headCol: 1, + } + + want := "second line of the trace\n third" + if got := model.selectedText(); got != want { + t.Fatalf("selected text %q, want %q", got, want) + } +} + +func TestCleanCopiedTextStripsDecorations(t *testing.T) { + in := "✓ Done\n 🐞 SQL injection found\n────────\n>_ curl -s http://x\nplain line" + want := " SQL injection found\ncurl -s http://x\nplain line" + if got := cleanCopiedText(in); got != want { + t.Fatalf("cleaned %q, want %q", got, want) + } +} + +func TestClickTogglesToolExpansion(t *testing.T) { + model := New(nil) + model.showSplash = false + model.ready = true + model.width, model.height = 130, 40 + model.snapshot.Agents = []protocol.Agent{{ID: "root", Name: "Strix", Status: "running"}} + var output []string + for i := 0; i < 20; i++ { + output = append(output, "output line") + } + model.snapshot.Events = []protocol.Event{{ + ID: "ev-1", Type: "tool", AgentID: "root", Timestamp: "1", + Data: map[string]any{ + "tool_name": "exec_command", + "status": "completed", + "args": map[string]any{"cmd": "seq 20"}, + "result": strings.Join(output, "\n"), + }, + }} + model.resizeViewport() + + if !strings.Contains(model.viewportContent, "click to expand") { + t.Fatalf("long tool output should start collapsed:\n%s", model.viewportContent) + } + if len(model.eventSpans) != 1 || model.eventSpans[0].eventID != "ev-1" { + t.Fatalf("expected one expandable span, got %+v", model.eventSpans) + } + + model.toggleEventAtLine(model.eventSpans[0].start) + if !strings.Contains(model.viewportContent, "click to collapse") { + t.Fatalf("click should expand the tool:\n%s", model.viewportContent) + } + model.toggleEventAtLine(model.eventSpans[0].start) + if !strings.Contains(model.viewportContent, "click to expand") { + t.Fatal("second click should collapse again") + } +} diff --git a/strix/interface/tui/internal/app/setup.go b/strix/interface/tui/internal/app/setup.go new file mode 100644 index 00000000..4a6c4b18 --- /dev/null +++ b/strix/interface/tui/internal/app/setup.go @@ -0,0 +1,525 @@ +package app + +import ( + "fmt" + "net" + "regexp" + "strings" + "sync" + + tea "github.com/charmbracelet/bubbletea" + "github.com/charmbracelet/lipgloss" + "github.com/usestrix/strix/tui/internal/render" +) + +func (m Model) submit(value string) (tea.Model, tea.Cmd) { + if m.snapshot.SetupMode { + return m.submitSetupPrompt(value) + } + if len(m.snapshot.Agents) == 0 { + m.errorText = "No agent is available" + return m, nil + } + if m.selectedAgent >= len(m.snapshot.Agents) { + m.selectedAgent = 0 + } + return m, send(m.client, "agent.send_message", map[string]any{"agent_id": m.snapshot.Agents[m.selectedAgent].ID, "message": value}) +} + +// submitSetupPrompt handles free text the way a coding agent's prompt does: +// anything that looks like a target is added, the rest becomes the scan +// instruction, and the prompt alone is enough to launch. With no target, the +// backend scans the current working directory. +func (m *Model) submitSetupPrompt(value string) (tea.Model, tea.Cmd) { + var commands []tea.Cmd + fields := strings.Fields(value) + targets := 0 + for _, field := range fields { + token := strings.Trim(field, ",;") + if !looksLikeTarget(token) || m.hasTarget(token) { + continue + } + targets++ + commands = append(commands, send(m.client, "setup.add_target", map[string]any{"target": token})) + } + if len(fields) > targets { + commands = append(commands, send(m.client, "setup.set_instruction", map[string]any{"instruction": value})) + } + // With a target, verify the model connection before the scan commits to it. + // A bare prompt launches optimistically, like a coding agent, and mounts the + // working directory - the backend asks about that from the live view, so the + // prompt is held here in case it is declined. + verify := targets > 0 || len(m.snapshot.Targets) > 0 + payload := map[string]any{"verify": verify} + if verify { + m.setupMsg("Verifying model connection...", render.Col(amber)) + } else { + m.pendingPrompt = value + payload["mount_working_dir"] = true + } + commands = append(commands, send(m.client, "setup.start", payload)) + // Ordered, not batched: setup.start leaves setup mode, so it must be the + // last command to reach the backend. Batched sends race, and once the + // preflight is skipped setup.start wins, making the target and instruction + // commands land after the guard closes and fail with a red error. + return *m, tea.Sequence(commands...) +} + +// answerMountConfirmation replies to the working-directory mount the backend is +// waiting on. Declining returns to the start screen, so the prompt goes back in +// the composer to be edited or given a target instead. +func (m *Model) answerMountConfirmation(approved bool) tea.Cmd { + if !approved && m.pendingPrompt != "" { + m.input.SetValue(m.pendingPrompt) + m.resizeViewport() + } + m.pendingPrompt = "" + return send(m.client, "setup.confirm_mount", map[string]any{"approved": approved}) +} + +func (m Model) hasTarget(candidate string) bool { + for _, target := range m.snapshot.Targets { + if target == candidate { + return true + } + } + return false +} + +// looksLikeTarget reports whether a whitespace-delimited token names something +// scannable: a URL, repo, filesystem path, domain, or IP address. +func looksLikeTarget(token string) bool { + if token == "" { + return false + } + if strings.Contains(token, "://") || strings.HasSuffix(token, ".git") { + return true + } + if strings.HasPrefix(token, "/") || strings.HasPrefix(token, "./") || strings.HasPrefix(token, "~/") || strings.HasPrefix(token, "../") { + return true + } + if ip := net.ParseIP(token); ip != nil { + return true + } + host := token + if at := strings.LastIndex(host, "@"); at >= 0 { + host = host[at+1:] + } + host = strings.SplitN(host, "/", 2)[0] + host = strings.SplitN(host, ":", 2)[0] + if !domainPattern.MatchString(host) { + return false + } + tld := host[strings.LastIndex(host, ".")+1:] + return len(tld) >= 2 && !isNumeric(tld) +} + +var domainPattern = regexp.MustCompile(`^([a-zA-Z0-9]([a-zA-Z0-9-]*[a-zA-Z0-9])?\.)+[a-zA-Z0-9]{2,}$`) + +func isNumeric(value string) bool { + for _, char := range value { + if char < '0' || char > '9' { + return false + } + } + return true +} + +// statusVisible mirrors #agent_status_display: shown only when an agent is +// selected during a scan; hidden (display:none) in setup mode. +func (m Model) statusVisible() bool { + return !m.snapshot.SetupMode && len(m.snapshot.Agents) > 0 +} + +func (m Model) layout() (showSidebar bool, sidebarWidth, chatWidth, chatHeight int) { + showSidebar = m.width >= 120 + if showSidebar { + sidebarWidth = max(24, m.width/5) + chatWidth = m.width - sidebarWidth - 1 + } else { + chatWidth = m.width + } + statusH := 0 + if m.statusVisible() { + statusH = 1 + } + chatHeight = max(4, m.height-statusH-(m.input.Height()+2)) + return +} + +// resizeViewport refits the composer and the scrollback to the terminal. The +// composer is sized width first: how far its content wraps, and so how tall it +// needs to be, depends on the width it is given. +func (m *Model) resizeViewport() { + if m.snapshot.SetupMode { + contentWidth := setupColumnWidth(m.width) + // The composer's border and padding each take a column per side. + m.input.SetWidth(max(3, contentWidth-4)) + // A clipped placeholder reads as an unfinished sentence, so a narrow + // composer gets the short prompt instead. + m.input.Placeholder = setupPlaceholder + if contentWidth-6 < lipgloss.Width(setupPlaceholder) { + m.input.Placeholder = setupPlaceholderShort + } + m.syncInputHeight() + m.viewport.Width = max(10, contentWidth) + m.viewport.Height = max(1, setupLogRows(m.setupLog)) + m.refreshViewport() + return + } + _, _, chatWidth, _ := m.layout() + // The accent bar and its padding each take a column. + m.input.SetWidth(max(3, chatWidth-3)) + m.syncInputHeight() + _, _, _, chatHeight := m.layout() + // Reserve two columns inside the border for the scrollbar gap and track. + m.viewport.Width = max(10, chatWidth-4) + m.viewport.Height = max(3, chatHeight-2) + m.refreshViewport() +} + +func (m *Model) refreshViewport() { + wasBottom := m.viewport.AtBottom() + content := m.setupContent() + if !m.snapshot.SetupMode { + content = m.chatContent() + } + m.viewportContent = content + m.viewport.SetContent(content) + if m.followOutput && wasBottom { + m.viewport.GotoBottom() + } +} + +func (m Model) setupContent() string { + var b strings.Builder + for _, line := range m.setupLog { + b.WriteString(line + "\n") + } + return strings.TrimSuffix(b.String(), "\n") +} + +// setupLogAppend records a chronological line in the setup scrollback. A line +// that is already there moves to the end instead of being repeated: retrying a +// launch that cannot succeed yet - no model configured, no target - would +// otherwise push the same pair of lines until they were all the log held. +func (m *Model) setupLogAppend(line string) { + for i, existing := range m.setupLog { + if existing == line { + m.setupLog = append(m.setupLog[:i], m.setupLog[i+1:]...) + break + } + } + m.setupLog = append(m.setupLog, line) +} + +// setupMsg appends a styled feedback line (success green, error red, notice dim). +// The log budgets rows by entry, so a message is flattened to one line first: a +// wrapped exception would otherwise render as several rows and push the launch +// column past the bottom of the terminal. +func (m *Model) setupMsg(text string, style lipgloss.Style) { + m.setupLogAppend(style.Render(flattenStatus(text))) +} + +// setupLogRows is how many feedback lines the launch column shows before the +// fit starts trimming them. It is a launch pad, not a scrollback. +func setupLogRows(log []string) int { return min(len(log), 6) } + +// Logo treatments, largest last. The launch column steps down through them as +// the terminal runs out of room. +const ( + logoNone = iota + logoCompact + logoFull +) + +// setupColumnWidth is the width of the centered launch column. It widens to +// the banner rather than lose it, as long as the terminal can still spare a +// margin either side. +func setupColumnWidth(terminal int) int { + width := min(72, max(24, terminal-8)) + if terminal >= wordmarkWidth()+2 { + width = max(width, wordmarkWidth()) + } + return width +} + +// setupFit records how much of the launch column survives at the current +// terminal size: the wordmark treatment, whether the tagline is shown, and how +// many feedback-log rows fit. +type setupFit struct { + width int + logo int + tagline bool + logRows int +} + +// setupFit picks the richest layout that still fits the terminal. Sections are +// surrendered in the order of shrink below - never the composer, which is the +// only thing on this screen the user has to reach. +func (m Model) setupFit() setupFit { + fit := setupFit{ + width: setupColumnWidth(m.width), + logo: logoFull, + tagline: true, + logRows: setupLogRows(m.setupLog), + } + if m.width < wordmarkWidth()+2 { + fit.logo = logoCompact + } + if m.height < 18 { + fit.logo, fit.tagline = min(fit.logo, logoCompact), false + } + shrink := []func(*setupFit) bool{ + func(f *setupFit) bool { return trimTo(&f.logRows, 3) }, + func(f *setupFit) bool { return clearFlag(&f.tagline) }, + func(f *setupFit) bool { return trimTo(&f.logRows, 0) }, + func(f *setupFit) bool { return trimTo(&f.logo, logoCompact) }, + func(f *setupFit) bool { return trimTo(&f.logo, logoNone) }, + } + for step := 0; step < len(shrink) && lipgloss.Height(m.setupBody(fit)) > m.height; { + if !shrink[step](&fit) { + step++ + } + } + return fit +} + +func trimTo(value *int, floor int) bool { + if *value <= floor { + return false + } + *value-- + return true +} + +func clearFlag(flag *bool) bool { + if !*flag { + return false + } + *flag = false + return true +} + +func (m Model) setupView() string { + fit := m.setupFit() + rows := strings.Split(m.setupBody(fit), "\n") + if len(rows) > m.height { + rows = rows[:max(0, m.height)] + } + // Anchor the column on its resting height rather than its current one, so a + // growing composer and new feedback both push downward. + // Centering on the live height walks the whole page up under the cursor, + // one row at a time, as the prompt wraps. + top := (m.height - m.setupRestingHeight(fit, len(rows))) / 2 + top = min(max(top, 0), max(0, m.height-len(rows))) + left := max(0, (m.width-fit.width)/2) + frame := make([]string, m.height) + for row := range frame { + line := "" + if index := row - top; index >= 0 && index < len(rows) { + line = strings.Repeat(" ", left) + rows[index] + } + frame[row] = padToWidth(line, m.width) + } + return strings.Join(frame, "\n") +} + +// setupRestingHeight is the column's height with the composer at its opening +// size and the transient sections closed: the layout the screen sits at when +// idle. Anchoring on this keeps the column still as the composer grows. +func (m Model) setupRestingHeight(fit setupFit, height int) int { + floor, _ := m.composerBounds() + height -= max(0, m.input.Height()-floor) + if fit.logRows > 0 && len(m.setupLog) > 0 { + height -= fit.logRows + 1 + } + return height +} + +// setupBody stacks the launch column: wordmark, composer with its scan summary, +// the target list, feedback and the key hints. Sections +// are separated by a blank line; the composer and its summary read as one unit. +func (m Model) setupBody(fit setupFit) string { + parts := make([]string, 0, 6) + if header := m.setupHeaderView(fit); header != "" { + parts = append(parts, header) + } + parts = append(parts, m.setupComposer(fit.width)) + if log := m.setupLogView(fit); log != "" { + parts = append(parts, log) + } + parts = append(parts, m.setupHintsView(fit.width)) + // Every row is padded to the column width: lipgloss.Place centers each line + // on its own, which would otherwise stagger the short rows. + rows := strings.Split(strings.Join(parts, "\n\n"), "\n") + for index, row := range rows { + rows[index] = padToWidth(row, fit.width) + } + return strings.Join(rows, "\n") +} + +// setupHeaderView centers the wordmark over the tagline. +func (m Model) setupHeaderView(fit setupFit) string { + center := lipgloss.NewStyle().Width(fit.width).Align(lipgloss.Center) + var rows []string + switch fit.logo { + case logoFull: + // The banner is tall enough to want air under it. + rows = append(rows, center.Render(wordmark())) + if fit.tagline { + rows = append(rows, "") + } + case logoCompact: + rows = append(rows, center.Render(lipgloss.NewStyle().Bold(true).Foreground(brightGreen).Render("STRIX"))) + } + if fit.tagline { + rows = append(rows, center.Render(render.Dim().Render("Open-source AI hackers for your apps"))) + } + return strings.Join(rows, "\n") +} + +// banner is the Strix wordmark: block letters with a bevelled edge. +const banner = ` ███████╗████████╗██████╗ ██╗██╗ ██╗ + ██╔════╝╚══██╔══╝██╔══██╗██║╚██╗██╔╝ + ███████╗ ██║ ██████╔╝██║ ╚███╔╝ + ╚════██║ ██║ ██╔══██╗██║ ██╔██╗ + ███████║ ██║ ██║ ██║██║██╔╝ ██╗ + ╚══════╝ ╚═╝ ╚═╝ ╚═╝╚═╝╚═╝ ╚═╝` + +// wordmark renders the banner in solid brand green. Every row is padded out to +// the full block so centering cannot ripple the letterforms out of alignment. +var wordmarkOnce = sync.OnceValue(func() string { + green := lipgloss.NewStyle().Foreground(green) + lines := strings.Split(banner, "\n") + rows := make([]string, len(lines)) + for index, line := range lines { + rows[index] = green.Render(line + strings.Repeat(" ", wordmarkWidth()-lipgloss.Width(line))) + } + return strings.Join(rows, "\n") +}) + +func wordmark() string { return wordmarkOnce() } + +// wordmarkWidth is the cell width of the widest banner row. +var wordmarkWidth = sync.OnceValue(func() int { + block := 0 + for _, line := range strings.Split(banner, "\n") { + block = max(block, lipgloss.Width(line)) + } + return block +}) + +// setupComposer draws the prompt as a rounded panel that lights up green while +// it holds focus. The scan meta and targets live inside the panel, flush under +// the input, so everything shares one left edge - the way opencode aligns its +// home prompt. +func (m Model) setupComposer(width int) string { + border := dark + if m.focus == focusInput { + border = green + } + // Width covers the padding but not the border, so a box of the given total + // width sets width-2 here and hands the interior the width-4 that is left. + inner := max(1, width-4) + body := m.highlightInputSelection(m.input.View()) + body += "\n\n" + m.setupSummaryView(inner) + if targets := m.setupTargetsView(inner); targets != "" { + body += "\n" + targets + } + return lipgloss.NewStyle().Width(max(1, width-2)).Padding(0, 1). + Border(lipgloss.RoundedBorder()).BorderForeground(border). + Render(body) +} + +// setupSummaryView is the quiet meta line inside the panel: what the scan will +// run as, or what is still missing before it can run. +func (m Model) setupSummaryView(width int) string { + chips := []string{} + if model := strings.TrimSpace(m.snapshot.Model); model != "" { + name, provider := model, "" + if slash := strings.LastIndex(model, "/"); slash >= 0 { + provider, name = model[:slash], model[slash+1:] + } + chip := render.Col(green).Render("● ") + render.Col(white).Render(name) + if provider != "" { + chips = append(chips, chip, render.Dim().Render(provider)) + } else { + chips = append(chips, chip) + } + } else { + chips = append(chips, render.Col(amber).Render("○ no model")+ + render.Dim().Render(" · set STRIX_LLM or configure one in your config")) + } + if m.snapshot.MaxBudgetUSD != nil { + chips = append(chips, render.Dim().Render(fmt.Sprintf("$%.2f budget", *m.snapshot.MaxBudgetUSD))) + } + return truncate(strings.Join(chips, render.Dim().Render(" · ")), max(1, width)) +} + +// setupTargetsView lists what the scan is pointed at, once anything is queued. +func (m Model) setupTargetsView(width int) string { + if len(m.snapshot.Targets) == 0 { + return "" + } + const visible = 4 + total := max(m.snapshot.TargetCount, len(m.snapshot.Targets)) + rows := []string{render.Bold(green).Render("Targets") + render.Dim().Render(fmt.Sprintf(" %d", total))} + for _, target := range m.snapshot.Targets[:min(visible, len(m.snapshot.Targets))] { + rows = append(rows, render.Col(dim).Render("▸ ")+render.Col(white).Render(truncate(target, max(1, width-2)))) + } + if hidden := total - visible; hidden > 0 { + rows = append(rows, render.Dim().Render(fmt.Sprintf("+%d more", hidden))) + } + return strings.Join(rows, "\n") +} + +// setupLogView shows the tail of the feedback log. The launch screen is a +// launch pad, not a scrollback, so only the most recent lines are kept. +func (m Model) setupLogView(fit setupFit) string { + if fit.logRows <= 0 || len(m.setupLog) == 0 { + return "" + } + tail := m.setupLog[max(0, len(m.setupLog)-fit.logRows):] + rows := make([]string, 0, len(tail)) + for _, line := range tail { + // Align with the panel interior [2, width-2]. + rows = append(rows, " "+truncate(line, max(1, fit.width-4))) + } + return strings.Join(rows, "\n") +} + +// setupHintsView is the closing key hint row, aligned to the panel's inner +// edges: keys flush under the input, the version at the far right. +func (m Model) setupHintsView(width int) string { + // The panel's interior spans [2, width-2]; match it so the row reads as a + // footer under the input rather than a stray line. + const pad = " " + inner := max(1, width-4) + key := lipgloss.NewStyle().Foreground(white).Render + label := render.Dim().Render + hint := func(k, text string) string { return key(k) + label(" "+text) } + left := hint("enter", "launch scan") + label(" ") + hint("ctrl+c", "quit") + if lipgloss.Width(left) > inner { + left = hint("enter", "launch scan") + } + right := label("v" + appVersion) + gap := inner - lipgloss.Width(left) - lipgloss.Width(right) + if gap < 2 { + return pad + left + } + return pad + left + strings.Repeat(" ", gap) + right +} + +// syncMountPrompt raises or clears the working-directory prompt to match the +// backend, which asks for it from the live view once a target-less scan is +// waiting on the answer. Following the snapshot rather than the keystroke keeps +// the prompt right across redraws and reconnects. +func (m *Model) syncMountPrompt() { + switch { + case m.snapshot.PendingMount != "" && m.modal != modalConfirmMount: + m.openModal(modalConfirmMount) + case m.snapshot.PendingMount == "" && m.modal == modalConfirmMount: + m.closeModal() + } +} diff --git a/strix/interface/tui/internal/app/setup_log_test.go b/strix/interface/tui/internal/app/setup_log_test.go new file mode 100644 index 00000000..603fbe1b --- /dev/null +++ b/strix/interface/tui/internal/app/setup_log_test.go @@ -0,0 +1,117 @@ +package app + +import ( + "encoding/json" + "strings" + "testing" + + "github.com/charmbracelet/lipgloss" + "github.com/muesli/termenv" + "github.com/usestrix/strix/tui/internal/protocol" + "github.com/usestrix/strix/tui/internal/render" +) + +// Retrying a launch that cannot succeed yet must not fill the log with copies of +// the same two lines. +func TestSetupLogCollapsesRepeatedAttempts(t *testing.T) { + m := New(nil) + m.snapshot.SetupMode = true + for range 4 { + m.setupMsg("Verifying model connection...", render.Col(amber)) + m.setupMsg("No model configured. Set STRIX_LLM first.", render.Col(red)) + } + if got := len(m.setupLog); got != 2 { + t.Fatalf("setup log holds %d lines after 4 identical attempts, want 2: %#v", got, m.setupLog) + } + // The newest line stays last so the log still reads chronologically. + if !strings.Contains(m.setupLog[1], "No model configured") { + t.Fatalf("most recent line is not last: %#v", m.setupLog) + } + m.setupMsg("\u2713 Added target: https://example.com", render.Col(green)) + if got := len(m.setupLog); got != 3 { + t.Fatalf("a distinct line did not append: %#v", m.setupLog) + } +} + +// The same collapse must hold for the path a real misconfiguration takes: a +// failing setup.start arriving as a command_result. +func TestRepeatedSetupStartFailureLogsOnce(t *testing.T) { + model, _ := newCommandTestModel(t) + model.snapshot.SetupMode = true + model.client.pending = map[string]string{} + model.client.pendingByKey = map[string]string{} + model.client.requestKeyByID = map[string]string{} + for i := range 3 { + requestID := "req-" + string(rune('a'+i)) + model.client.pending[requestID] = "setup.start" + model.client.pendingByKey["setup.start"] = requestID + model.client.requestKeyByID[requestID] = "setup.start" + payload, err := json.Marshal(protocol.CommandResult{ + OK: false, + Command: "setup.start", + Error: &protocol.CommandError{ + Code: "invalid_state", + Message: "No model configured. Set STRIX_LLM first.", + }, + }) + if err != nil { + t.Fatal(err) + } + model.handleEnvelope(protocol.Envelope{ + Version: protocol.Version, Type: "command_result", RequestID: requestID, Payload: payload, + }) + } + if got := len(model.setupLog); got != 1 { + t.Fatalf("three identical launch failures logged %d lines, want 1: %#v", got, model.setupLog) + } +} + +// Every Tab-reachable panel shows focus with the same green border. +func TestFocusedPanelsCarryTheGreenBorder(t *testing.T) { + // The profile is global; restore it so later tests still render unstyled. + previous := lipgloss.ColorProfile() + t.Cleanup(func() { lipgloss.SetColorProfile(previous) }) + lipgloss.SetColorProfile(termenv.TrueColor) + borderColorsOf := func(focus focusMode) string { + m := New(nil) + m.width, m.height = 130, 30 + m.showSplash = false + m.snapshot.ScanState = "running" + m.snapshot.Agents = []protocol.Agent{{ID: "a0", Name: "Strix", Status: "running"}} + m.snapshot.Vulnerabilities = []map[string]any{{"title": "XSS", "severity": "high"}} + m.focus = focus + m.resizeViewport() + return m.sidebarView(26, m.height) + } + idle := borderColorsOf(focusInput) + if strings.Contains(idle, "34;197;94") { + t.Fatal("an unfocused sidebar panel drew a green border") + } + for _, focus := range []focusMode{focusAgents, focusVulnerabilities} { + if !strings.Contains(borderColorsOf(focus), "34;197;94") { + t.Fatalf("focus %v did not draw a green border", focus) + } + } +} + +// A wrapped exception is several lines. The log budgets rows by entry, so it has +// to become one row or the launch column grows past the terminal. +func TestSetupLogKeepsMultiLineErrorsToOneRow(t *testing.T) { + model := New(nil) + model.width, model.height = 100, 26 + model.showSplash = false + model.handleEnvelope(stateEnvelope(t, 1, protocol.Snapshot{SetupMode: true, ScanState: "setup"})) + model.setupMsg("boom\nTraceback (most recent call last):\n File \"x.py\", line 1\n raise", render.Col(red)) + model.resizeViewport() + + if entries := len(model.setupLog); entries != 1 { + t.Fatalf("one message became %d log entries", entries) + } + if strings.Contains(model.setupLog[0], "\n") { + t.Fatalf("log entry spans rows: %q", model.setupLog[0]) + } + lines := strings.Split(model.View(), "\n") + if len(lines) > model.height { + t.Fatalf("start screen is %d rows in a %d-row terminal", len(lines), model.height) + } +} diff --git a/strix/interface/tui/internal/app/setup_prompt_test.go b/strix/interface/tui/internal/app/setup_prompt_test.go new file mode 100644 index 00000000..a18f8234 --- /dev/null +++ b/strix/interface/tui/internal/app/setup_prompt_test.go @@ -0,0 +1,292 @@ +package app + +import ( + "encoding/binary" + "encoding/json" + "reflect" + "strings" + "testing" + + tea "github.com/charmbracelet/bubbletea" + "github.com/charmbracelet/x/ansi" + "github.com/usestrix/strix/tui/internal/protocol" +) + +// lastIndex returns the index of the last command of the given type, or -1. +func lastIndex(types []string, want string) int { + last := -1 + for i, value := range types { + if value == want { + last = i + } + } + return last +} + +// firstIndex returns the index of the first command of the given type, or -1. +func firstIndex(types []string, want string) int { + for i, value := range types { + if value == want { + return i + } + } + return -1 +} + +// drainCommands runs a (possibly batched) command and decodes every protocol +// frame the sends wrote to the connection, in order. +func drainCommands(t *testing.T, cmd tea.Cmd, connection *recordingConn) []protocol.Envelope { + t.Helper() + if cmd == nil { + return nil + } + var run func(tea.Cmd) + run = func(c tea.Cmd) { + if c == nil { + return + } + msg := c() + switch typed := msg.(type) { + case tea.BatchMsg: + for _, sub := range typed { + run(sub) + } + case sentMsg: + if typed.err != nil { + t.Fatalf("command failed: %#v", typed) + } + default: + // tea.Sequence yields an unexported sequenceMsg ([]tea.Cmd); run its + // commands in order, which is the ordering the sequence guarantees. + if value := reflect.ValueOf(msg); value.Kind() == reflect.Slice { + for i := 0; i < value.Len(); i++ { + if sub, ok := value.Index(i).Interface().(tea.Cmd); ok { + run(sub) + } + } + } + } + } + run(cmd) + + var envelopes []protocol.Envelope + raw := connection.Bytes() + for len(raw) >= 4 { + size := int(binary.BigEndian.Uint32(raw[:4])) + if len(raw) < size+4 { + t.Fatalf("truncated command frame") + } + var envelope protocol.Envelope + if err := json.Unmarshal(raw[4:size+4], &envelope); err != nil { + t.Fatal(err) + } + envelopes = append(envelopes, envelope) + raw = raw[size+4:] + } + return envelopes +} + +func commandTypes(envelopes []protocol.Envelope) []string { + types := make([]string, len(envelopes)) + for i, envelope := range envelopes { + types[i] = envelope.Type + } + return types +} + +// startVerify returns the verify flag on the setup.start command, and whether +// a setup.start command was present at all. +func startVerify(t *testing.T, envelopes []protocol.Envelope) (verify, found bool) { + t.Helper() + for _, envelope := range envelopes { + if envelope.Type != "setup.start" { + continue + } + var payload struct { + Verify bool `json:"verify"` + } + if err := json.Unmarshal(envelope.Payload, &payload); err != nil { + t.Fatal(err) + } + return payload.Verify, true + } + return false, false +} + +func contains(values []string, want string) bool { + for _, value := range values { + if value == want { + return true + } + } + return false +} + +// startPayloadFlag reports a boolean field on the setup.start command. +func startPayloadFlag(t *testing.T, envelopes []protocol.Envelope, field string) (value, found bool) { + t.Helper() + for _, envelope := range envelopes { + if envelope.Type != "setup.start" { + continue + } + var payload map[string]any + if err := json.Unmarshal(envelope.Payload, &payload); err != nil { + t.Fatal(err) + } + flag, ok := payload[field].(bool) + return flag, ok + } + return false, false +} + +// A bare prompt launches straight away, asking to mount the working directory +// rather than adding it as a target. The prompt is held in case it is declined. +func TestSetupPromptWithoutTargetLaunchesAndRequestsMount(t *testing.T) { + connection := &recordingConn{} + model := New(&Client{conn: connection}) + model.snapshot = protocol.Snapshot{SetupMode: true, WorkingDir: "/Users/me/code/api"} + + updated, cmd := model.submit("find auth bugs in the login flow") + model = updated.(Model) + envelopes := drainCommands(t, cmd, connection) + types := commandTypes(envelopes) + + if !contains(types, "setup.set_instruction") || !contains(types, "setup.start") { + t.Fatalf("bare prompt did not launch: %v", types) + } + if contains(types, "setup.add_target") { + t.Fatalf("the working directory must not be added as a target: %v", types) + } + if mount, found := startPayloadFlag(t, envelopes, "mount_working_dir"); !found || !mount { + t.Fatalf("mount was not requested: mount_working_dir=%v found=%v", mount, found) + } + // A bare prompt launches optimistically: no model preflight. + if verify, found := startVerify(t, envelopes); !found || verify { + t.Fatalf("bare prompt should launch with verify=false, got verify=%v found=%v", verify, found) + } + // setup.start leaves setup mode, so it must be the last command sent. + if start, instr := firstIndex(types, "setup.start"), lastIndex(types, "setup.set_instruction"); start < instr { + t.Fatalf("setup.start (%d) must come after setup.set_instruction (%d): %v", start, instr, types) + } + if model.pendingPrompt != "find auth bugs in the login flow" { + t.Fatalf("prompt was not held in case the mount is declined: %q", model.pendingPrompt) + } + // The confirmation is not raised locally; the backend asks for it. + if model.modal != modalNone { + t.Fatalf("submit should not open a dialog itself: modal=%v", model.modal) + } +} + +// The backend asks from the live view, so the prompt follows the snapshot. +func TestPendingMountOpensAndClosesWithTheSnapshot(t *testing.T) { + model := New(nil) + model.width, model.height = 130, 40 + model.ready = true + + model.snapshot.PendingMount = "/Users/me/code/api" + model.syncMountPrompt() + if model.modal != modalConfirmMount { + t.Fatalf("pending mount did not raise the prompt: modal=%v", model.modal) + } + if model.modalChoice != 1 { + t.Fatalf("a consent prompt should default to declining, got %d", model.modalChoice) + } + // It names the directory the backend is waiting on, and stays compact. + view := ansi.Strip(model.mountConfirmView()) + if !strings.Contains(view, "/Users/me/code/api") { + t.Fatalf("prompt does not name the directory: %s", view) + } + if rows := strings.Count(view, "\n") + 1; rows > 6 { + t.Fatalf("corner prompt should stay compact, got %d rows:\n%s", rows, view) + } + + // Once the backend has the answer it clears, which closes the prompt. + model.snapshot.PendingMount = "" + model.syncMountPrompt() + if model.modal != modalNone { + t.Fatalf("prompt stayed open after the pending mount cleared: %v", model.modal) + } +} + +// Answering replies to the backend; declining puts the prompt back to edit. +func TestMountConfirmationAnswers(t *testing.T) { + for _, tc := range []struct { + name string + key tea.KeyMsg + choice int + approved bool + }{ + {"confirm", tea.KeyMsg{Type: tea.KeyEnter}, 0, true}, + {"cancel", tea.KeyMsg{Type: tea.KeyEnter}, 1, false}, + {"escape", tea.KeyMsg{Type: tea.KeyEsc}, 1, false}, + } { + connection := &recordingConn{} + model := New(&Client{conn: connection}) + model.width, model.height = 130, 40 + model.snapshot = protocol.Snapshot{SetupMode: true, WorkingDir: "/Users/me/code/api"} + updated, _ := model.submit("find auth bugs in the login flow") + model = updated.(Model) + connection.Reset() + model.snapshot.PendingMount = "/Users/me/code/api" + model.syncMountPrompt() + model.modalChoice = tc.choice + + updated, cmd := model.updateModal(tc.key) + model = updated.(Model) + envelopes := drainCommands(t, cmd, connection) + + if len(envelopes) != 1 || envelopes[0].Type != "setup.confirm_mount" { + t.Fatalf("%s: expected one setup.confirm_mount, got %v", tc.name, commandTypes(envelopes)) + } + var payload struct { + Approved bool `json:"approved"` + } + if err := json.Unmarshal(envelopes[0].Payload, &payload); err != nil { + t.Fatal(err) + } + if payload.Approved != tc.approved { + t.Fatalf("%s: approved=%v, want %v", tc.name, payload.Approved, tc.approved) + } + // Declining returns to the start screen, so the prompt comes back. + want := "" + if !tc.approved { + want = "find auth bugs in the login flow" + } + if got := model.input.Value(); got != want { + t.Fatalf("%s: composer = %q, want %q", tc.name, got, want) + } + if model.pendingPrompt != "" { + t.Fatalf("%s: held prompt was not cleared: %q", tc.name, model.pendingPrompt) + } + } +} + +// A prompt that names a target adds it and launches. +func TestSetupPromptWithTargetLaunches(t *testing.T) { + connection := &recordingConn{} + model := New(&Client{conn: connection}) + model.snapshot = protocol.Snapshot{SetupMode: true} + + _, cmd := model.submit("https://juice-shop.example.com hit the coupon endpoint") + envelopes := drainCommands(t, cmd, connection) + types := commandTypes(envelopes) + + for _, want := range []string{"setup.add_target", "setup.set_instruction", "setup.start"} { + if !contains(types, want) { + t.Fatalf("missing %s in %v", want, types) + } + } + // A named target keeps the upfront model check. + if verify, found := startVerify(t, envelopes); !found || !verify { + t.Fatalf("targeted prompt should launch with verify=true, got verify=%v found=%v", verify, found) + } + // The target and instruction must reach the backend before setup.start + // closes the setup guard. + start := firstIndex(types, "setup.start") + if target := lastIndex(types, "setup.add_target"); start < target { + t.Fatalf("setup.start (%d) must come after setup.add_target (%d): %v", start, target, types) + } + if instr := lastIndex(types, "setup.set_instruction"); start < instr { + t.Fatalf("setup.start (%d) must come after setup.set_instruction (%d): %v", start, instr, types) + } +} diff --git a/strix/interface/tui/internal/app/update.go b/strix/interface/tui/internal/app/update.go new file mode 100644 index 00000000..2a22c4a9 --- /dev/null +++ b/strix/interface/tui/internal/app/update.go @@ -0,0 +1,647 @@ +package app + +import ( + "strings" + + tea "github.com/charmbracelet/bubbletea" + "github.com/charmbracelet/lipgloss" + "github.com/charmbracelet/x/ansi" +) + +func (m Model) updateMain(key tea.KeyMsg) (tea.Model, tea.Cmd) { + switch key.String() { + case "f1": + m.openModal(modalHelp) + return m, nil + case "ctrl+c", "ctrl+q": + // Nothing to lose on the start screen; quit without confirmation. + if m.snapshot.SetupMode { + m.quitting = true + return m, tea.Batch(send(m.client, "app.quit", map[string]any{}), tea.Quit) + } + m.modalChoice = 1 + m.openModal(modalQuit) + return m, nil + case "ctrl+o": + return m, send(m.client, "viewer.open", map[string]any{}) + case "tab": + m.cycleFocus(1) + return m, nil + case "shift+tab": + m.cycleFocus(-1) + return m, nil + case "esc": + if !m.snapshot.SetupMode && m.selectedAgentCanStop() { + m.modalChoice = 1 + m.openModal(modalStop) + } + return m, nil + case "up", "down": + if m.focus == focusAgents && len(m.snapshot.Agents) > 0 { + delta := 1 + if key.String() == "up" { + delta = -1 + } + entries := agentTreeEntries(m.snapshot.Agents, m.collapsedAgents) + row := selectedAgentRow(entries, m.selectedAgent) + row = max(0, min(len(entries)-1, row+delta)) + m.selectedAgent = entries[row].index + m.ensureAgentVisible() + m.refreshViewport() + return m, nil + } + if m.focus == focusVulnerabilities && len(m.snapshot.Vulnerabilities) > 0 { + delta := 1 + if key.String() == "up" { + delta = -1 + } + m.moveVulnerabilitySelection(delta) + m.ensureVulnerabilityVisible() + return m, nil + } + case "enter", " ": + if m.focus == focusVulnerabilities && len(m.snapshot.Vulnerabilities) > 0 { + if key.String() == "enter" { + m.openModal(modalVulnerability) + return m, nil + } + } + if m.focus == focusAgents { + if m.selectedAgent < len(m.snapshot.Agents) { + agentID := m.snapshot.Agents[m.selectedAgent].ID + if hasAgentChildren(agentID, m.snapshot.Agents) { + if m.collapsedAgents == nil { + m.collapsedAgents = map[string]bool{} + } + m.collapsedAgents[agentID] = !m.collapsedAgents[agentID] + m.ensureAgentVisible() + } + } + return m, nil + } + if key.String() == "enter" && m.focus == focusInput { + value := strings.TrimSpace(m.input.Value()) + m.input.SetValue("") + m.resizeViewport() + if value != "" { + return m.submit(value) + } + return m, nil + } + case "pgup": + if m.focus == focusVulnerabilities && len(m.snapshot.Vulnerabilities) > 0 { + m.moveVulnerabilitySelection(-m.vulnerabilityPageItems()) + m.ensureVulnerabilityVisible() + return m, nil + } + m.focus = focusChat + m.input.Blur() + m.followOutput = false + m.viewport.HalfViewUp() + return m, nil + case "pgdown": + if m.focus == focusVulnerabilities && len(m.snapshot.Vulnerabilities) > 0 { + m.moveVulnerabilitySelection(m.vulnerabilityPageItems()) + m.ensureVulnerabilityVisible() + return m, nil + } + m.focus = focusChat + m.input.Blur() + m.viewport.HalfViewDown() + return m, nil + case "home": + if m.focus == focusVulnerabilities && len(m.snapshot.Vulnerabilities) > 0 { + m.selectedVuln = 0 + m.ensureVulnerabilityVisible() + return m, nil + } + case "end": + if m.focus == focusVulnerabilities && len(m.snapshot.Vulnerabilities) > 0 { + m.selectedVuln = len(m.snapshot.Vulnerabilities) - 1 + m.ensureVulnerabilityVisible() + return m, nil + } + m.viewport.GotoBottom() + m.followOutput = true + return m, nil + } + if m.focus == focusChat { + var cmd tea.Cmd + m.viewport, cmd = m.viewport.Update(key) + return m, cmd + } + var cmd tea.Cmd + m.input, cmd = m.input.Update(key) + // Typing changes how far the composer wraps, so refit it. + m.resizeViewport() + return m, cmd +} + +// updateMouse routes wheel and click events to the pane under the pointer. +func (m Model) updateMouse(msg tea.MouseMsg) (tea.Model, tea.Cmd) { + if m.modal != modalNone { + return m.updateModalMouse(msg) + } + if m.snapshot.SetupMode { + return m.updateSetupMouse(msg) + } + showSidebar, _, chatWidth, chatHeight := m.layout() + viewerHeight := m.viewerHeight() + _, vulnHeight, agentHeight := m.sidebarHeights() + x, y := msg.X, msg.Y + if m.updateMainScrollbarMouse( + msg, showSidebar, chatWidth, chatHeight, viewerHeight, agentHeight, vulnHeight, + ) { + return m, nil + } + if m.selection.dragging { + switch msg.Action { + case tea.MouseActionMotion: + // Clamp to the owning pane so dragging past an edge keeps + // extending the selection. + if m.selection.region == regionInput { + top := m.inputTop() + cx := min(max(x, 2+inputPromptWidth), max(2+inputPromptWidth, chatWidth-2)) + cy := min(max(y, top+1), top+m.input.Height()) + if line, col, ok := m.inputContentCell(cx, cy); ok { + m.extendSelection(line, col) + } + return m, nil + } + traceHeight := chatHeight - 2 + cx := min(max(x, 1), max(1, chatWidth-2)) + cy := min(max(y, 1), max(1, traceHeight)) + if line, col, ok := m.chatContentCell(cx, cy); ok { + m.extendSelection(line, col) + } + return m, nil + case tea.MouseActionRelease: + return m, m.finishSelection() + } + } + switch msg.Button { + case tea.MouseButtonWheelUp: + if showSidebar && x >= chatWidth+1 { + switch { + case y < viewerHeight: + return m, nil + case y < viewerHeight+agentHeight: + m.focus = focusAgents + m.input.Blur() + m.agentOffset = max(0, m.agentOffset-3) + m.keepAgentSelectionInWindow() + m.refreshViewport() + case vulnHeight > 0 && y < viewerHeight+agentHeight+vulnHeight: + m.focus = focusVulnerabilities + m.input.Blur() + m.vulnOffset = max(0, m.vulnOffset-3) + m.keepVulnerabilitySelectionInWindow() + } + return m, nil + } + m.focus = focusChat + m.input.Blur() + m.followOutput = false + m.viewport.LineUp(3) + return m, nil + case tea.MouseButtonWheelDown: + if showSidebar && x >= chatWidth+1 { + switch { + case y < viewerHeight: + return m, nil + case y < viewerHeight+agentHeight: + m.focus = focusAgents + m.input.Blur() + rows := m.agentPageSize() + m.agentOffset = min(max(0, len(agentTreeEntries(m.snapshot.Agents, m.collapsedAgents))-rows), m.agentOffset+3) + m.keepAgentSelectionInWindow() + m.refreshViewport() + case vulnHeight > 0 && y < viewerHeight+agentHeight+vulnHeight: + m.focus = focusVulnerabilities + m.input.Blur() + totalRows, _ := m.vulnerabilityScrollRows() + m.vulnOffset = min(max(0, totalRows-m.vulnerabilityPageSize()), m.vulnOffset+3) + m.keepVulnerabilitySelectionInWindow() + } + return m, nil + } + m.viewport.LineDown(3) + if m.viewport.AtBottom() { + m.followOutput = true + } + return m, nil + } + if msg.Action != tea.MouseActionPress || msg.Button != tea.MouseButtonLeft { + return m, nil + } + statusH := 0 + if m.statusVisible() { + statusH = 1 + } + inputTop := chatHeight + statusH + // Chat column: chat box on top, input box below the (optional) status row. + if x < chatWidth { + switch { + case y >= inputTop: + m.focus = focusInput + m.input.Focus() + if line, col, ok := m.inputContentCell(x, y); ok { + m.beginSelection(regionInput, line, col) + } else { + m.selection.active = false + } + case y < chatHeight: + m.focus = focusChat + m.input.Blur() + if line, col, ok := m.chatContentCell(x, y); ok { + m.beginSelection(regionChat, line, col) + } else { + m.selection.active = false + } + default: + m.selection.active = false + } + return m, nil + } + + if !showSidebar || x < chatWidth+1 { + return m, nil + } + // Sidebar: viewer, agents, vulnerabilities, then stats. + switch { + case y < viewerHeight: + return m, send(m.client, "viewer.open", map[string]any{}) + case y < viewerHeight+agentHeight: + m.focus = focusAgents + m.input.Blur() + // Content starts after the top border (1) and vertical padding (1). + entries := agentTreeEntries(m.snapshot.Agents, m.collapsedAgents) + start := windowStart(m.agentOffset, len(entries), max(1, agentHeight-4)) + localY := y - viewerHeight + if row := start + localY - 2; localY >= 2 && localY < agentHeight-2 && row < len(entries) { + m.selectedAgent = entries[row].index + agentID := m.snapshot.Agents[m.selectedAgent].ID + if hasAgentChildren(agentID, m.snapshot.Agents) { + m.collapsedAgents[agentID] = !m.collapsedAgents[agentID] + m.ensureAgentVisible() + } + m.refreshViewport() + } + case vulnHeight > 0 && y < viewerHeight+agentHeight+vulnHeight: + m.focus = focusVulnerabilities + m.input.Blur() + // Content starts after the top border (1); clicking a row opens its detail. + row := y - viewerHeight - agentHeight - 1 + if idx := m.vulnerabilityIndexAtRow(row); row >= 0 && row < vulnHeight-2 && idx >= 0 { + m.selectedVuln = idx + m.openModal(modalVulnerability) + } + } + return m, nil +} + +func (m *Model) updateMainScrollbarMouse( + msg tea.MouseMsg, + showSidebar bool, + chatWidth, chatHeight, viewerHeight, agentHeight, vulnHeight int, +) bool { + if msg.Action == tea.MouseActionRelease { + if m.draggingScrollbar == scrollbarNone { + return false + } + m.draggingScrollbar = scrollbarNone + return true + } + if msg.Action == tea.MouseActionMotion && m.draggingScrollbar != scrollbarNone { + m.scrollFromMouse(m.draggingScrollbar, msg.Y, chatHeight, viewerHeight, agentHeight) + return true + } + if msg.Action != tea.MouseActionPress || msg.Button != tea.MouseButtonLeft { + return false + } + target := m.scrollbarAt(msg, showSidebar, chatWidth, chatHeight, viewerHeight, agentHeight, vulnHeight) + if target == scrollbarNone { + return false + } + m.draggingScrollbar = target + m.scrollFromMouse(target, msg.Y, chatHeight, viewerHeight, agentHeight) + return true +} + +// scrollbarGrab is how far either side of the bar still counts as grabbing it. A +// one column target is unreasonable to hit with a mouse, and nothing else lives +// in the column beside it. +const scrollbarGrab = 1 + +func nearColumn(x, column int) bool { + return x >= column-scrollbarGrab && x <= column+scrollbarGrab +} + +// scrollbarAt reports which scrollbar, if any, the pointer is over. +func (m Model) scrollbarAt( + msg tea.MouseMsg, + showSidebar bool, + chatWidth, chatHeight, viewerHeight, agentHeight, vulnHeight int, +) scrollbarTarget { + switch { + case nearColumn(msg.X, chatWidth-2) && msg.Y >= 1 && msg.Y < chatHeight-1 && + m.viewport.TotalLineCount() > m.viewport.VisibleLineCount(): + return scrollbarTrace + case showSidebar && nearColumn(msg.X, m.width-3) && msg.Y >= viewerHeight+2 && + msg.Y < viewerHeight+agentHeight-2 && + len(agentTreeEntries(m.snapshot.Agents, m.collapsedAgents)) > m.agentPageSize(): + return scrollbarAgents + case showSidebar && vulnHeight > 0 && nearColumn(msg.X, m.width-3) && + msg.Y >= viewerHeight+agentHeight+1 && + msg.Y < viewerHeight+agentHeight+vulnHeight-1: + totalRows, _ := m.vulnerabilityScrollRows() + if totalRows > m.vulnerabilityPageSize() { + return scrollbarFindings + } + } + return scrollbarNone +} + +func (m *Model) scrollFromMouse( + target scrollbarTarget, + y, chatHeight, viewerHeight, agentHeight int, +) { + switch target { + case scrollbarTrace: + height := max(1, chatHeight-2) + offset := scrollbarOffset(y-1, height, m.viewport.TotalLineCount(), m.viewport.VisibleLineCount()) + m.focus = focusChat + m.input.Blur() + m.viewport.SetYOffset(offset) + m.followOutput = m.viewport.AtBottom() + case scrollbarAgents: + height := m.agentPageSize() + total := len(agentTreeEntries(m.snapshot.Agents, m.collapsedAgents)) + m.focus = focusAgents + m.input.Blur() + m.agentOffset = scrollbarOffset(y-viewerHeight-2, height, total, height) + m.keepAgentSelectionInWindow() + m.refreshViewport() + case scrollbarFindings: + height := m.vulnerabilityPageSize() + totalRows, _ := m.vulnerabilityScrollRows() + m.focus = focusVulnerabilities + m.input.Blur() + // The offset is a row, so dragging moves the list continuously. + m.vulnOffset = scrollbarOffset(y-viewerHeight-agentHeight-1, height, totalRows, height) + m.keepVulnerabilitySelectionInWindow() + } +} + +func scrollbarOffset(row, height, total, visible int) int { + maxOffset := max(0, total-visible) + if height <= 1 || maxOffset == 0 { + return 0 + } + return maxOffset * min(max(0, row), height-1) / (height - 1) +} + +func (m Model) updateSetupMouse(msg tea.MouseMsg) (tea.Model, tea.Cmd) { + switch msg.Button { + case tea.MouseButtonWheelUp: + m.focus = focusChat + m.input.Blur() + m.followOutput = false + m.viewport.LineUp(3) + return m, nil + case tea.MouseButtonWheelDown: + m.viewport.LineDown(3) + if m.viewport.AtBottom() { + m.followOutput = true + } + return m, nil + } + if msg.Action == tea.MouseActionPress && msg.Button == tea.MouseButtonLeft { + m.focus = focusInput + m.input.Focus() + } + return m, nil +} + +// pressReportButton performs a button of the report row, however it was reached. +func (m Model) pressReportButton(button string) (tea.Model, tea.Cmd) { + switch button { + case reportPrev: + m.showVulnerability(m.selectedVuln - 1) + case reportNext: + m.showVulnerability(m.selectedVuln + 1) + case reportCopy: + m.reportFocus = reportCopy + return m, m.startVulnerabilityCopy() + default: + m.closeModal() + } + return m, nil +} + +func (m Model) updateModalMouse(msg tea.MouseMsg) (tea.Model, tea.Cmd) { + if m.modal == modalVulnerability { + view := m.modalView() + left, top, _, _ := m.centeredViewBounds(view) + viewportLeft := left + 4 // border and three-cell dialog padding + viewportTop := top + 3 // border and two-cell dialog padding + insideViewport := msg.X >= viewportLeft && msg.X < viewportLeft+m.vulnViewport.Width+2 && + msg.Y >= viewportTop && msg.Y < viewportTop+m.vulnViewport.Height + switch msg.Button { + case tea.MouseButtonWheelUp: + if insideViewport { + m.vulnViewport.LineUp(3) + } + return m, nil + case tea.MouseButtonWheelDown: + if insideViewport { + m.vulnViewport.LineDown(3) + } + return m, nil + } + } + if msg.Action != tea.MouseActionPress || msg.Button != tea.MouseButtonLeft { + return m, nil + } + view := m.modalView() + switch m.modal { + case modalQuit, modalStop: + if m.centeredLabelHit(view, "Yes", msg.X, msg.Y) { + m.modalChoice = 0 + return m.updateModal(tea.KeyMsg{Type: tea.KeyEnter}) + } + if m.centeredLabelHit(view, "No", msg.X, msg.Y) { + m.modalChoice = 1 + return m.updateModal(tea.KeyMsg{Type: tea.KeyEnter}) + } + case modalVulnerability: + for _, button := range m.reportButtons() { + if button == reportCopy || button == reportDone { + continue + } + if m.centeredLabelHit(view, button, msg.X, msg.Y) { + m.reportFocus = button + return m.pressReportButton(button) + } + } + if m.centeredLabelHit(view, "Copy", msg.X, msg.Y) { + m.reportFocus = reportCopy + cmd := m.startVulnerabilityCopy() + return m, cmd + } + if m.centeredLabelHit(view, "Done", msg.X, msg.Y) { + m.reportFocus = reportDone + m.closeModal() + } + } + return m, nil +} + +func (m Model) centeredViewBounds(view string) (left, top, width, height int) { + width = lipgloss.Width(view) + height = strings.Count(view, "\n") + 1 + left = max(0, (m.width-width)/2) + top = max(0, (m.height-height)/2) + return +} + +func (m Model) centeredLabelHit(view, label string, x, y int) bool { + left, top, _, _ := m.centeredViewBounds(view) + for row, line := range strings.Split(view, "\n") { + plain := ansi.Strip(line) + index := strings.Index(plain, label) + if index < 0 || y != top+row { + continue + } + start := left + ansi.StringWidth(plain[:index]) + return x >= start-1 && x < start+ansi.StringWidth(label)+1 + } + return false +} + +func (m *Model) cycleFocus(delta int) { + available := []focusMode{focusInput, focusChat} + if m.width >= 120 { + available = append(available, focusAgents) + if len(m.snapshot.Vulnerabilities) > 0 { + available = append(available, focusVulnerabilities) + } + } + idx := 0 + for i, focus := range available { + if focus == m.focus { + idx = i + } + } + m.focus = available[clampCycle(idx+delta, len(available))] + if m.focus == focusInput { + m.input.Focus() + } else { + m.input.Blur() + } +} + +func clampCycle(value, length int) int { + if length <= 0 { + return 0 + } + return (value%length + length) % length +} + +func (m Model) updateModal(key tea.KeyMsg) (tea.Model, tea.Cmd) { + if m.modal == modalHelp { + if key.String() != "" { + m.closeModal() + } + return m, nil + } + if m.modal == modalVulnerability { + switch key.String() { + case "esc": + m.closeModal() + // The arrows step between reports directly; tab walks the button row. + case "left": + m.showVulnerability(m.selectedVuln - 1) + case "right": + m.showVulnerability(m.selectedVuln + 1) + case "tab": + m.stepReportFocus(1) + case "shift+tab": + m.stepReportFocus(-1) + case "enter": + return m.pressReportButton(m.focusedReportButton()) + case "c": + m.reportFocus = reportCopy + cmd := m.startVulnerabilityCopy() + return m, cmd + case "up": + m.vulnViewport.LineUp(1) + case "down": + m.vulnViewport.LineDown(1) + case "pgup": + m.vulnViewport.HalfViewUp() + case "pgdown": + m.vulnViewport.HalfViewDown() + case "home": + m.vulnViewport.GotoTop() + case "end": + m.vulnViewport.GotoBottom() + } + return m, nil + } + switch key.String() { + case "esc": + if m.modal == modalConfirmMount { + // The backend is waiting on an answer; escape declines it. + return m, m.answerMountConfirmation(false) + } + m.closeModal() + return m, nil + case "left", "right", "up", "down", "tab": + m.modalChoice = 1 - m.modalChoice + return m, nil + case "enter": + modal, choice := m.modal, m.modalChoice + if modal == modalConfirmMount { + // The snapshot closes this prompt once the backend has the answer. + return m, m.answerMountConfirmation(choice == 0) + } + m.closeModal() + if choice == 1 { + return m, nil + } + if modal == modalQuit { + m.quitting = true + return m, tea.Batch(send(m.client, "app.quit", map[string]any{}), tea.Quit) + } + if modal == modalStop && m.selectedAgentCanStop() { + agent := m.snapshot.Agents[m.selectedAgent] + return m, send(m.client, "agent.stop", map[string]any{"agent_id": agent.ID}) + } + } + return m, nil +} + +func (m *Model) openModal(mode modalMode) { + m.modal = mode + m.input.Blur() + if mode == modalConfirmMount { + // A consent prompt defaults to declining. + m.modalChoice = 1 + } + if mode == modalVulnerability { + m.reportFocus = reportDone + m.modalChoice = 1 + m.vulnerabilityCopied = false + m.vulnerabilityCopyError = "" + m.resizeVulnerabilityViewport() + m.vulnViewport.GotoTop() + } +} + +func (m *Model) closeModal() { + m.modal = modalNone + if m.focus == focusInput { + m.input.Focus() + } +} diff --git a/strix/interface/tui/internal/app/view.go b/strix/interface/tui/internal/app/view.go new file mode 100644 index 00000000..9ac0a55e --- /dev/null +++ b/strix/interface/tui/internal/app/view.go @@ -0,0 +1,824 @@ +package app + +import ( + "encoding/json" + "fmt" + "os" + "sort" + "strconv" + "strings" + + "github.com/charmbracelet/lipgloss" + "github.com/charmbracelet/x/ansi" + "github.com/usestrix/strix/tui/internal/protocol" + "github.com/usestrix/strix/tui/internal/render" +) + +// eventSpan records which content lines of the chat trace belong to an +// expandable tool event, so clicks can toggle its collapsed state. +type eventSpan struct { + start, end int + eventID string +} + +// renderedBlock is a chat block kept across frames: rendering (syntax +// highlighting, image placements, wrapping) is expensive and only changes +// when the event, the chat width, or its expanded state changes. +type renderedBlock struct { + version int + width int + expanded bool + wrapped string + expandable bool + height int +} + +func (m *Model) renderEvent(event protocol.Event, width int) renderedBlock { + expanded := m.expandedEvents[event.ID] + if cached, ok := m.blockCache[event.ID]; ok && + cached.version == event.Version && cached.width == width && cached.expanded == expanded { + return cached + } + var block string + expandable := false + switch event.Type { + case "chat": + block = render.Chat(event.Data) + case "tool": + name := render.StringValue(event.Data["tool_name"]) + block, expandable = render.CollapseTool(render.Tool(event.Data), name, expanded) + } + entry := renderedBlock{version: event.Version, width: width, expanded: expanded, expandable: expandable} + if block != "" { + entry.wrapped = wrapBlock(block, width) + entry.height = strings.Count(entry.wrapped, "\n") + 1 + } + if m.blockCache == nil { + m.blockCache = map[string]renderedBlock{} + } + m.blockCache[event.ID] = entry + return entry +} + +func (m *Model) chatContent() string { + if len(m.snapshot.Agents) == 0 { + switch m.snapshot.ScanState { + case "failed": + message := "Scan failed" + if m.snapshot.Error != nil && strings.TrimSpace(*m.snapshot.Error) != "" { + detail := strings.ReplaceAll(strings.TrimSpace(*m.snapshot.Error), "\n", " ") + message += "\n\n" + ansi.Truncate(detail, max(1, m.viewport.Width-4), "...") + } + return centeredPlaceholder(message, m.viewport.Width, m.viewport.Height) + case "stopped": + return centeredPlaceholder("Scan stopped", m.viewport.Width, m.viewport.Height) + case "completed": + return centeredPlaceholder("Scan completed", m.viewport.Width, m.viewport.Height) + case "preparing": + return centeredPlaceholder("Preparing scan...", m.viewport.Width, m.viewport.Height) + default: + return centeredPlaceholder("Loading...", m.viewport.Width, m.viewport.Height) + } + } + if m.selectedAgent >= len(m.snapshot.Agents) { + return "" + } + agentID := m.snapshot.Agents[m.selectedAgent].ID + events := append([]protocol.Event(nil), m.snapshot.Events...) + // Match _gather_agent_events: sort by (timestamp, id). + sort.SliceStable(events, func(i, j int) bool { + if events[i].Timestamp != events[j].Timestamp { + return events[i].Timestamp < events[j].Timestamp + } + return events[i].ID < events[j].ID + }) + // .chat-content has padding: 0 1 — one column of horizontal padding, so wrap + // to width-2 and indent every line by one cell. + contentWidth := max(1, m.viewport.Width-2) + render.SetImageWidth(contentWidth - 2) + var blocks []string + var spans []eventSpan + line := 0 + for _, event := range events { + if event.AgentID != agentID { + continue + } + entry := m.renderEvent(event, contentWidth) + if entry.wrapped == "" { + continue + } + if len(blocks) > 0 { + line++ // blank separator line between blocks + } + if entry.expandable { + spans = append(spans, eventSpan{start: line, end: line + entry.height - 1, eventID: event.ID}) + } + line += entry.height + blocks = append(blocks, entry.wrapped) + } + m.eventSpans = spans + if len(blocks) == 0 { + return centeredPlaceholder("Starting agent...", m.viewport.Width, m.viewport.Height) + } + return indentLines(strings.Join(blocks, "\n\n"), " ") +} + +// indentLines prefixes every line with the given pad (chat-content padding-left). +func indentLines(s, pad string) string { + lines := strings.Split(s, "\n") + for i, line := range lines { + lines[i] = pad + line + } + return strings.Join(lines, "\n") +} + +func centeredPlaceholder(text string, width, height int) string { + return lipgloss.Place(width, height, lipgloss.Center, lipgloss.Center, lipgloss.NewStyle().Foreground(dim).Italic(true).Render(text)) +} + +// truncate clips to a display-cell width, honoring wide runes and ANSI styling. +func truncate(value string, limit int) string { + if limit <= 0 { + return "" + } + if ansi.StringWidth(value) <= limit { + return value + } + return ansi.Truncate(value, limit, "…") +} + +// wrapBlock hard-wraps each line of a rendered block to the given cell width so +// content never spills past the chat border, matching Textual's word wrapping. +func wrapBlock(value string, width int) string { + if width <= 0 { + return value + } + var out []string + for _, line := range strings.Split(value, "\n") { + if ansi.StringWidth(line) <= width { + out = append(out, line) + continue + } + out = append(out, strings.Split(ansi.Wrap(line, width, " -"), "\n")...) + } + return strings.Join(out, "\n") +} + +// scrollbarThumb brightens the bar being dragged so the grab reads as taking +// hold of it. +func (m Model) scrollbarThumb(target scrollbarTarget) lipgloss.Color { + if m.draggingScrollbar == target { + return thumbActive + } + return thumbResting +} + +func verticalScrollbar(height, total, visible, offset int, thumb lipgloss.Color) string { + if height <= 0 || total <= visible { + return "" + } + visible = min(max(1, visible), max(1, total)) + total = max(visible, total) + thumbHeight := height + thumbStart := 0 + if total > visible { + thumbHeight = max(1, height*visible/total) + maxOffset := total - visible + thumbStart = (height - thumbHeight) * min(max(0, offset), maxOffset) / maxOffset + } + thumbStyle := lipgloss.NewStyle().Foreground(thumb) + bar := make([]string, height) + for row := range bar { + bar[row] = " " + if row >= thumbStart && row < thumbStart+thumbHeight { + bar[row] = thumbStyle.Render("█") + } + } + return strings.Join(bar, "\n") +} + +// withVerticalScrollbar reserves a single column for the bar, and only while the +// panel actually overflows. +func withVerticalScrollbar( + content string, + width, height, total, visible, offset int, + thumb lipgloss.Color, +) string { + if total <= visible { + return fixedPanelBody(content, width, height) + } + body := fixedPanelBody(content, max(1, width-1), height) + bar := verticalScrollbar(height, total, visible, offset, thumb) + return lipgloss.JoinHorizontal(lipgloss.Top, body, bar) +} + +func visibleContent(content string, offset, height int) string { + if height <= 0 || content == "" { + return "" + } + lines := strings.Split(content, "\n") + start := min(max(0, offset), len(lines)) + end := min(len(lines), start+height) + return strings.Join(lines[start:end], "\n") +} + +func fixedPanelBody(content string, width, height int) string { + lines := strings.Split(content, "\n") + body := make([]string, max(0, height)) + for row := range body { + line := "" + if row < len(lines) { + line = ansi.Truncate(lines[row], max(1, width), "") + } + padding := strings.Repeat(" ", max(0, width-ansi.StringWidth(line))) + // End every source style before padding; otherwise inline-code and tool + // backgrounds can paint the empty space through to the panel border. + body[row] = line + "\x1b[0m" + blackBG + padding + } + return strings.Join(body, "\n") +} + +func (m Model) View() string { + view := fillBackground(m.viewInner()) + // Kitty graphics transmissions ride out of band: they carry no visible + // cells, so writing them directly keeps the Bubble Tea frame diff clean. + for _, seq := range render.DrainImageTransmissions() { + _, _ = os.Stdout.WriteString(seq) + } + return view +} + +func (m Model) viewInner() string { + if m.showSplash { + return m.splashView() + } + if !m.ready { + return lipgloss.Place(m.width, m.height, lipgloss.Center, lipgloss.Center, lipgloss.NewStyle().Foreground(dim).Render("Connecting to Strix…"), lipgloss.WithWhitespaceBackground(black)) + } + main := m.mainView() + if m.snapshot.SetupMode { + main = m.setupView() + } + if m.modal == modalConfirmMount { + // A corner prompt, not a dialog: it sits out of the way in the live view + // while the scan waits on the answer. + main = m.cornerOverlay(main, m.modalView()) + } else if m.modal != modalNone { + // Only the vulnerability detail dims its backdrop (#000000 80%); Help, + // Quit and Stop are transparent. + main = m.overlay(main, m.modalView(), m.modal == modalVulnerability) + } + return m.toastOverlay(main) +} + +// cornerOverlay splices a panel in directly above the composer, right-aligned +// with it, leaving the rest of the view visible behind it. +func (m Model) cornerOverlay(view, panel string) string { + if panel == "" { + return view + } + fg := strings.Split(panel, "\n") + bg := strings.Split(view, "\n") + panelWidth := lipgloss.Width(panel) + // Right edge of the chat column, so it lines up with the composer rather + // than covering the sidebar. + _, _, chatWidth, _ := m.layout() + left := max(0, min(chatWidth, m.width)-panelWidth) + // Bottom row sits just above the composer, clearing the status line so the + // scan state and quit hint stay readable. + statusH := 0 + if m.statusVisible() { + statusH = 1 + } + top := max(0, m.inputTop()-statusH-len(fg)) + for row := top; row < min(len(bg), top+len(fg)); row++ { + fgLine := ansi.Truncate(fg[row-top], max(0, m.width-left), "") + rightStart := left + lipgloss.Width(fgLine) + leftPart := padToWidth(ansi.Truncate(bg[row], left, ""), left) + rightPart := "" + if lipgloss.Width(bg[row]) > rightStart { + rightPart = ansi.TruncateLeft(bg[row], rightStart, "") + } + bg[row] = leftPart + fgLine + rightPart + } + return strings.Join(bg, "\n") +} + +// toastOverlay splices a transient notification into the bottom-right corner, +// where Textual's notify() toasts appeared. +func (m Model) toastOverlay(view string) string { + if m.toast == "" { + return view + } + box := lipgloss.NewStyle(). + Border(lipgloss.RoundedBorder()). + BorderForeground(green). + Background(black). + Foreground(textColor). + Padding(0, 1). + Render(m.toast) + fg := strings.Split(box, "\n") + bg := strings.Split(view, "\n") + boxWidth := lipgloss.Width(box) + left := max(0, m.width-boxWidth-2) + top := max(0, m.height-len(fg)-1) + for row := top; row < min(len(bg), top+len(fg)); row++ { + fgLine := fg[row-top] + rightStart := left + boxWidth + leftPart := padToWidth(ansi.Truncate(bg[row], left, ""), left) + rightPart := "" + if lipgloss.Width(bg[row]) > rightStart { + rightPart = ansi.TruncateLeft(bg[row], rightStart, "") + } + bg[row] = leftPart + fgLine + rightPart + } + return strings.Join(bg, "\n") +} + +// blackBG is the SGR that selects a solid black background. +const blackBG = "\x1b[48;2;0;0;0m" + +// fillBackground paints the whole frame black like Textual's Screen background. +// Bubble Tea has no screen compositor, so any cell the view does not explicitly +// color shows the terminal's default background. lipgloss emits a full reset +// (\x1b[0m) at the end of every styled span, which also clears the background, so +// we reassert black after each reset (and at the start). Spans that set their own +// background — inline code, selected rows, buttons — keep it, because their color +// is emitted before the reset. +func fillBackground(view string) string { + if view == "" { + return view + } + return blackBG + strings.ReplaceAll(view, "\x1b[0m", "\x1b[0m"+blackBG) +} + +func (m Model) splashView() string { + shine := "Starting Strix Agent" + chars := []rune(shine) + pos := m.splashFrame % (len(chars) + 8) + var start strings.Builder + for i, char := range chars { + distance := i - pos + if distance < 0 { + distance = -distance + } + // Tiers match SplashScreen._build_start_line_text: + // bright_white / white / #a3a3a3 / #525252. + color := lipgloss.Color("#525252") + bold := false + switch { + case distance <= 1: + color, bold = brightWhite, true + case distance <= 3: + color, bold = white, true + case distance <= 5: + color = lipgloss.Color("#a3a3a3") + } + start.WriteString(lipgloss.NewStyle().Foreground(color).Bold(bold).Render(string(char))) + } + welcome := lipgloss.NewStyle().Bold(true).Foreground(white).Render("Welcome to ") + + lipgloss.NewStyle().Bold(true).Foreground(green).Render("Strix") + + lipgloss.NewStyle().Bold(true).Foreground(white).Render("!") + version := lipgloss.NewStyle().Foreground(white).Faint(true).Render("v" + appVersion) + tagline := lipgloss.NewStyle().Foreground(white).Faint(true).Render("Open-source AI hackers for your apps") + url := lipgloss.NewStyle().Bold(true).Foreground(green).Render("strix.ai") + // The wordmark is shared with the launch screen so the two read as one moment. + content := wordmark() + "\n\n" + + welcome + "\n" + version + "\n" + tagline + "\n\n" + + start.String() + "\n\n" + url + if warn := m.snapshot.ModelWarning; warn != "" { + content += "\n\n" + splashModelWarning(warn) + } + panel := lipgloss.NewStyle().Border(lipgloss.RoundedBorder()).BorderForeground(green).Padding(1, 6).Align(lipgloss.Center).Render(content) + // #splash_screen background is solid black. + return lipgloss.Place(m.width, m.height, lipgloss.Center, lipgloss.Center, panel, + lipgloss.WithWhitespaceBackground(black)) +} + +// splashModelWarning ports SplashScreen._build_model_warning_text. +func splashModelWarning(model string) string { + yellow := lipgloss.Color("#eab308") + return lipgloss.NewStyle().Bold(true).Foreground(yellow).Render("⚠ ") + + lipgloss.NewStyle().Bold(true).Foreground(render.Cyan).Render(model) + + lipgloss.NewStyle().Foreground(yellow).Render(" is not a recommended frontier model - pentest quality could be degraded") +} + +// chatPaneKey identifies everything the bordered trace depends on. +type chatPaneKey struct { + offset int + width, height int + border lipgloss.Color + selection selectionState +} + +// chatPane memoizes the bordered trace: slicing, scrollbar padding and border +// styling all re-measure every visible cell, which is costly when inline image +// placeholders (a base rune plus two combining marks per cell) fill the pane, +// and the trace is unchanged across most frames. +var chatPane struct { + key chatPaneKey + content string + out string +} + +func (m Model) renderChatPane(width, height int, border lipgloss.Color) string { + key := chatPaneKey{offset: m.viewport.YOffset, width: width, height: height, border: border, selection: m.selection} + if chatPane.out != "" && chatPane.key == key && chatPane.content == m.viewportContent { + return chatPane.out + } + trace := withVerticalScrollbar( + m.highlightSelection(visibleContent(m.viewportContent, m.viewport.YOffset, height), m.viewport.YOffset), + width, + height, + m.viewport.TotalLineCount(), + m.viewport.VisibleLineCount(), + m.viewport.YOffset, + m.scrollbarThumb(scrollbarTrace), + ) + out := lipgloss.NewStyle().Width(width).Height(height). + Border(lipgloss.RoundedBorder()).BorderForeground(border).Render(trace) + chatPane.key, chatPane.content, chatPane.out = key, m.viewportContent, out + return out +} + +func (m Model) mainView() string { + showSidebar, sidebarWidth, chatWidth, chatHeight := m.layout() + // Matches tui_styles.tcss: #chat_history border is near-black when idle and + // green on focus. + chatBorder := lipgloss.Color("#0a0a0a") + if m.focus == focusChat { + chatBorder = green + } + traceHeight := chatHeight - 2 + chat := m.renderChatPane(chatWidth-2, traceHeight, chatBorder) + + inputBorder := dark + if m.focus == focusInput { + inputBorder = green + } + input := lipgloss.NewStyle().Width(chatWidth - 2).Height(m.input.Height()). + Border(lipgloss.RoundedBorder()).BorderForeground(inputBorder).PaddingLeft(1). + Render(m.highlightInputSelection(m.input.View())) + + // Chat column: chat history, optional status row, then input — all chat-width. + leftParts := []string{chat} + if m.statusVisible() { + leftParts = append(leftParts, m.statusView(chatWidth)) + } + leftParts = append(leftParts, input) + leftColumn := strings.Join(leftParts, "\n") + + body := leftColumn + if showSidebar { + body = lipgloss.JoinHorizontal(lipgloss.Top, leftColumn, " ", m.sidebarView(sidebarWidth, m.height)) + } + return lipgloss.NewStyle().Background(black).Foreground(textColor).Render(body) +} + +// Every panel that Tab can reach shows focus the way the chat and the composer +// do, with a green border. The stylesheet asked for near-black on the tree +// instead, through a Tree:focus rule that lost to the #agents_tree id selector +// and so never applied - honoring it made the outline vanish on the one panel +// that had just become active. +func (m Model) sidebarView(width, height int) string { + // Stats box height fits its content (auto, max 15); vulns panel max-height 12. + statsBody := m.statsView() + statsHeight, vulnHeight, agentHeight := m.sidebarHeights() + agentBorder := dark + if m.focus == focusAgents { + agentBorder = green + } + // #agents_tree padding: 1 (all sides); interior lines = box - border - v.padding. + agentRows := max(1, agentHeight-4) + agentEntries := agentTreeEntries(m.snapshot.Agents, m.collapsedAgents) + agents := withVerticalScrollbar( + m.agentsView(max(1, width-5), agentRows), + width-4, + agentRows, + len(agentEntries), + agentRows, + m.agentOffset, + m.scrollbarThumb(scrollbarAgents), + ) + parts := []string{ + lipgloss.NewStyle().Width(width-2).Height(m.viewerHeight()-2).Border(lipgloss.RoundedBorder()).BorderForeground(dark).Padding(0, 1).Render(m.viewerView(width - 4)), + lipgloss.NewStyle().Width(width-2).Height(agentHeight-2).Border(lipgloss.RoundedBorder()).BorderForeground(agentBorder).Padding(1, 1).Render(agents), + } + if vulnHeight > 0 { + vulnBorder := dark + if m.focus == focusVulnerabilities { + vulnBorder = green + } + vulnRows := max(1, vulnHeight-2) + totalRows, offsetRows := m.vulnerabilityScrollRows() + findings := withVerticalScrollbar( + m.vulnerabilitiesView(m.vulnerabilityListWidth(), vulnRows), + width-4, + vulnRows, + totalRows, + vulnRows, + offsetRows, + m.scrollbarThumb(scrollbarFindings), + ) + parts = append(parts, lipgloss.NewStyle().Width(width-2).Height(vulnRows).Border(lipgloss.RoundedBorder()).BorderForeground(vulnBorder).Padding(0, 1).Render(findings)) + } + parts = append(parts, lipgloss.NewStyle().Width(width-2).Height(statsHeight-2).Border(lipgloss.RoundedBorder()).BorderForeground(dark).Padding(0, 1).Render(statsBody)) + return strings.Join(parts, "\n") +} + +func (m Model) sidebarHeights() (statsHeight, vulnHeight, agentHeight int) { + // Measure the stats panel the way its box will render it: a long model name + // wraps inside the sidebar, and counting only its newlines would size the + // box short and push the whole frame past the bottom of the terminal. + statsRows := lipgloss.Height(lipgloss.NewStyle().Width(m.viewerContentWidth()).Render(m.statsView())) + statsHeight = min(15, statsRows+2) + if len(m.snapshot.Vulnerabilities) > 0 { + vulnHeight = min(12, len(m.vulnerabilityRows(m.vulnerabilityListWidth()))+2) + } + agentHeight = max(3, m.height-m.viewerHeight()-statsHeight-vulnHeight) + return +} + +func (m Model) viewerHeight() int { + return strings.Count(m.viewerView(m.viewerContentWidth()), "\n") + 3 +} + +func (m Model) viewerContentWidth() int { + _, sidebarWidth, _, _ := m.layout() + if sidebarWidth == 0 { + sidebarWidth = 24 + } + return max(1, sidebarWidth-4) +} + +func (m Model) viewerView(width int) string { + switch m.snapshot.ViewerStatus { + case "running": + status := lipgloss.NewStyle().Foreground(green).Render("● Viewer running") + if m.snapshot.ViewerURL != nil && strings.TrimSpace(*m.snapshot.ViewerURL) != "" { + url := wrapBlock(strings.TrimSpace(*m.snapshot.ViewerURL), width) + return status + "\n" + lipgloss.NewStyle().Foreground(dim).Render(url) + } + return status + case "unavailable": + return truncate(lipgloss.NewStyle().Foreground(amber).Render("Viewer UI not built"), width) + case "failed": + return truncate(lipgloss.NewStyle().Foreground(red).Render("Viewer failed to start"), width) + default: + return truncate(lipgloss.NewStyle().Foreground(textColor).Render("▶ Watch live in browser"), width) + } +} + +func (m Model) statsView() string { + w := lipgloss.NewStyle().Foreground(white) + var b strings.Builder + if model := m.snapshot.Model; model != "" { + b.WriteString(w.Render(model)) + } + if m.snapshot.Subscription { + if b.Len() > 0 { + b.WriteString("\n") + } + b.WriteString(lipgloss.NewStyle().Foreground(green).Render("ChatGPT subscription")) + } + total := numberValue(m.snapshot.Usage["total_tokens"]) + if total > 0 { + if b.Len() > 0 { + b.WriteString("\n") + } + b.WriteString(w.Render(fmt.Sprintf("%s tokens", formatCount(total)))) + if cost := floatValue(m.snapshot.Usage["cost"]); !m.snapshot.Subscription && cost > 0 { + b.WriteString(w.Render(fmt.Sprintf(" · $%.2f", cost))) + } + } + if caido := m.snapshot.CaidoURL; caido != "" { + if b.Len() > 0 { + b.WriteString("\n") + } + b.WriteString(lipgloss.NewStyle().Bold(true).Foreground(white).Render("Caido: ") + w.Render(caido)) + } + if b.Len() > 0 { + b.WriteString("\n") + } + b.WriteString(w.Render("v" + appVersion)) + return b.String() +} + +func numberValue(value any) int64 { + switch v := value.(type) { + case float64: + return int64(v) + case int64: + return v + case int: + return int64(v) + case json.Number: + n, _ := v.Int64() + return n + } + return 0 +} +func floatValue(value any) float64 { + switch v := value.(type) { + case float64: + return v + case int: + return float64(v) + case string: + n, _ := strconv.ParseFloat(v, 64) + return n + } + return 0 +} +func formatCount(value int64) string { + if value >= 1_000_000 { + return fmt.Sprintf("%.1fM", float64(value)/1_000_000) + } + if value >= 1_000 { + return fmt.Sprintf("%.1fK", float64(value)/1_000) + } + return strconv.FormatInt(value, 10) +} + +func (m Model) statusView(width int) string { + // Status text color mirrors #status_text (#a3a3a3); keymap hints use white + // keys and dim actions (keymap_styled). See _get_status_display_content. + left, right := "", "" + if len(m.snapshot.Agents) > 0 && !m.snapshot.SetupMode { + agent := m.snapshot.Agents[m.selectedAgent] + quitHint := lipgloss.NewStyle().Foreground(white).Render("ctrl-q") + lipgloss.NewStyle().Foreground(dim).Render(" ") + lipgloss.NewStyle().Foreground(dim).Render("quit") + switch agent.Status { + case "running": + if m.agentHasEvents(agent.ID) { + left = m.sweepView() + lipgloss.NewStyle().Foreground(white).Render("esc") + lipgloss.NewStyle().Foreground(dim).Render(" ") + lipgloss.NewStyle().Foreground(dim).Render("stop") + } else { + left = m.sweepView() + lipgloss.NewStyle().Foreground(white).Render("Initializing") + } + right = quitHint + case "waiting": + left = lipgloss.NewStyle().Foreground(dim).Render("Send message to resume") + if msg := agent.ErrorMessage; msg != "" { + left = statusMessage(msg, red, " · Send message to resume", width) + } + case "budget_paused": + left = lipgloss.NewStyle().Foreground(amber).Render("Budget limit reached") + + lipgloss.NewStyle().Foreground(dim).Render(" · Send a message to continue") + right = quitHint + case "completed": + left = lipgloss.NewStyle().Foreground(mid).Render("Agent completed") + case "stopped": + left = lipgloss.NewStyle().Foreground(mid).Render("Agent stopped") + case "failed", "crashed": + msg := agent.ErrorMessage + if msg == "" { + msg = "Agent failed" + } + left = statusMessage(msg, red, " · Send message to resume", width) + } + } + if m.errorText != "" { + left = statusMessage(m.errorText, red, "", width-lipgloss.Width(right)) + } + return composeStatusRow(left, right, width) +} + +// composeStatusRow lays the status text and the corner hint on one row exactly +// width columns wide. A wider row would widen the whole chat column, because +// JoinHorizontal pads every row of a block to its widest, which pushes the +// sidebar off screen and wraps the frame. +func composeStatusRow(left, right string, width int) string { + if width <= 0 { + return "" + } + const leading = 1 // the row is indented one column, like the panels above it + // A terminal can be narrower than the hint itself. Drop the hint rather than + // keep it at the cost of the status, which is the part carrying information; + // ctrl-q works whether or not the row has room to say so. + if lipgloss.Width(right) > 0 && width < lipgloss.Width(right)+leading+2 { + right = "" + } + separator := 0 + if lipgloss.Width(right) > 0 { + separator = 1 + } + left = truncate(left, max(0, width-leading-lipgloss.Width(right)-separator)) + padding := max(0, width-leading-lipgloss.Width(left)-lipgloss.Width(right)) + return " " + left + strings.Repeat(" ", padding) + right +} + +// statusMessage fits a message and its trailing hint on the one status row. A +// model or backend error can be a wrapped exception several lines long, so it is +// flattened to a single line and clipped, leaving the hint readable. +func statusMessage(message string, color lipgloss.Color, hint string, width int) string { + styledHint := lipgloss.NewStyle().Foreground(dim).Render(hint) + room := max(1, width-2-lipgloss.Width(styledHint)) + flat := truncate(flattenStatus(message), room) + return lipgloss.NewStyle().Foreground(color).Render(flat) + styledHint +} + +// flattenStatus turns a multi-line message into one line, collapsing the runs of +// whitespace that joining its lines leaves behind. +func flattenStatus(message string) string { + message = strings.NewReplacer("\r\n", " ", "\r", " ", "\n", " ", "\t", " ").Replace(message) + return strings.Join(strings.Fields(message), " ") +} + +func (m Model) sweepView() string { + palette := []lipgloss.Color{ + black, lipgloss.Color("#031a09"), lipgloss.Color("#052e16"), lipgloss.Color("#0d4a2a"), + lipgloss.Color("#15803d"), green, brightGreen, lipgloss.Color("#86efac"), + } + const numSquares = 6 + numColors := len(palette) + offset := numColors - 1 + maxPos := (numSquares - 1) + offset + totalRange := maxPos + offset + cycleLength := totalRange * 2 + frameInCycle := m.sweepFrame % cycleLength + wavePos := totalRange - abs(totalRange-frameInCycle) + sweepPos := wavePos - offset + + dotColor := lipgloss.Color("#0a3d1f") + var b strings.Builder + for i := 0; i < numSquares; i++ { + dist := abs(i - sweepPos) + colorIdx := numColors - 1 - dist + if colorIdx <= 0 { + b.WriteString(lipgloss.NewStyle().Foreground(dotColor).Render("·")) + } else { + b.WriteString(lipgloss.NewStyle().Foreground(palette[colorIdx]).Render("▪")) + } + } + b.WriteString(" ") + return b.String() +} + +func abs(x int) int { + if x < 0 { + return -x + } + return x +} + +func titleCase(s string) string { + return strings.Title(strings.ToLower(s)) +} + +// overlay composites a centered dialog on top of the live main view. When +// dimmed is true (vulnerability detail, background: #000000 80%) the backdrop is +// recolored to a dark grey; otherwise it is left untouched to match Textual's +// transparent modal backdrop (background: $background 0%). +func (m Model) overlay(background, foreground string, dimmed bool) string { + bg := strings.Split(background, "\n") + fg := strings.Split(foreground, "\n") + dialogHeight := len(fg) + dialogWidth := lipgloss.Width(foreground) + top := max(0, (m.height-dialogHeight)/2) + left := max(0, (m.width-dialogWidth)/2) + dimStyle := lipgloss.NewStyle().Foreground(lipgloss.Color("#3f3f46")) + for row := 0; row < len(bg); row++ { + if row < top || row >= top+dialogHeight { + if dimmed { + bg[row] = dimStyle.Render(ansi.Strip(bg[row])) + } + continue + } + fgLine := fg[row-top] + rightStart := left + dialogWidth + var leftPart, rightPart string + if dimmed { + bgLine := ansi.Strip(bg[row]) + leftPart = dimStyle.Render(truncateToWidth(bgLine, left)) + if lipgloss.Width(bgLine) > rightStart { + rightPart = dimStyle.Render(ansi.TruncateLeft(bgLine, rightStart, "")) + } + } else { + // Preserve the original styling of the visible backdrop segments. + leftPart = padToWidth(ansi.Truncate(bg[row], left, ""), left) + if lipgloss.Width(bg[row]) > rightStart { + rightPart = ansi.TruncateLeft(bg[row], rightStart, "") + } + } + bg[row] = leftPart + fgLine + rightPart + } + return strings.Join(bg, "\n") +} + +// padToWidth right-pads an ANSI string to an exact display width. +func padToWidth(value string, width int) string { + w := lipgloss.Width(value) + if w >= width { + return value + } + return value + strings.Repeat(" ", width-w) +} + +func truncateToWidth(value string, width int) string { + if width <= 0 { + return "" + } + if lipgloss.Width(value) <= width { + return value + strings.Repeat(" ", width-lipgloss.Width(value)) + } + return ansi.Truncate(value, width, "") +} diff --git a/strix/interface/tui/internal/app/vuln_report.go b/strix/interface/tui/internal/app/vuln_report.go new file mode 100644 index 00000000..2f460926 --- /dev/null +++ b/strix/interface/tui/internal/app/vuln_report.go @@ -0,0 +1,178 @@ +package app + +// Markdown clipboard report for the vulnerability detail dialog, porting +// VulnerabilityDetailScreen._get_markdown_report plus the report-writer fence +// helpers (safe_fence, guess_language_name). + +import ( + "fmt" + "regexp" + "strings" + + "github.com/alecthomas/chroma/v2/lexers" + + "github.com/usestrix/strix/tui/internal/render" +) + +var backtickRun = regexp.MustCompile("`+") + +// safeFence returns a backtick fence that content cannot break out of: one +// backtick longer than the longest run inside it, never fewer than three. +func safeFence(content string) string { + longest := 0 + for _, run := range backtickRun.FindAllString(content, -1) { + longest = max(longest, len(run)) + } + return strings.Repeat("`", max(3, longest+1)) +} + +// guessLanguageName returns a markdown fence tag for code, defaulting to +// "python" when auto-detection is inconclusive (legacy PoC scripts are Python). +func guessLanguageName(code string) string { + lexer := lexers.Analyse(code) + if lexer == nil { + return "python" + } + config := lexer.Config() + if config == nil || len(config.Aliases) == 0 || config.Name == "plaintext" { + return "python" + } + return config.Aliases[0] +} + +func titleCaseWords(text string) string { + words := strings.Fields(text) + for i, word := range words { + words[i] = titleCase(word) + } + return strings.Join(words, " ") +} + +// vulnerabilityMarkdownReport builds the Markdown vulnerability report copied +// to the clipboard, field-for-field with the old Textual screen. +func vulnerabilityMarkdownReport(v map[string]any) string { + var lines []string + + title := render.StringValue(v["title"]) + if title == "" { + title = "Untitled Vulnerability" + } + lines = append(lines, "# "+title, "") + + field := func(label, value string) { + if value != "" { + lines = append(lines, fmt.Sprintf("**%s:** %s", label, value)) + } + } + field("ID", render.StringValue(v["id"])) + field("Severity", strings.ToUpper(render.StringValue(v["severity"]))) + field("Found", render.StringValue(v["timestamp"])) + field("Agent", render.StringValue(v["agent_name"])) + field("Target", render.StringValue(v["target"])) + if dep, ok := v["dependency_metadata"].(map[string]any); ok { + field("Package", render.StringValue(dep["package_name"])) + field("Ecosystem", render.StringValue(dep["package_ecosystem"])) + field("Installed Version", render.StringValue(dep["installed_version"])) + field("Fixed Version", render.StringValue(dep["fixed_version"])) + field("Introduced By", render.StringValue(dep["introduced_by"])) + field("Dependency Chain", render.StringValue(dep["dependency_path"])) + } + field("Endpoint", render.StringValue(v["endpoint"])) + field("Method", render.StringValue(v["method"])) + field("CVE", render.StringValue(v["cve"])) + field("CWE", render.StringValue(v["cwe"])) + field("CVSS", render.StringValue(v["cvss"])) + if fe := render.StringValue(v["fix_effort"]); fe != "" { + field("Fix Effort", titleCaseWords(fe)) + } + if bd, ok := v["cvss_breakdown"].(map[string]any); ok && len(bd) > 0 { + if parts := render.CVSSVectorParts(bd); len(parts) > 0 { + field("CVSS Vector", strings.Join(parts, "/")) + } + } + + description := render.StringValue(v["description"]) + if description == "" { + description = "No description provided." + } + lines = append(lines, "", "## Description", "", description) + + section := func(label, value string) { + if value != "" { + lines = append(lines, "", "## "+label, "", value) + } + } + section("Impact", render.StringValue(v["impact"])) + section("Technical Analysis", render.StringValue(v["technical_analysis"])) + section("Evidence", render.StringValue(v["evidence"])) + + pocDescription := render.StringValue(v["poc_description"]) + pocScript := render.StringValue(v["poc_script_code"]) + if pocDescription != "" || pocScript != "" { + lines = append(lines, "", "## Proof of Concept", "") + if pocDescription != "" { + lines = append(lines, pocDescription, "") + } + if pocScript != "" { + pocLang, pocCode := render.ParseFencedCode(pocScript) + if pocLang == "" { + pocLang = guessLanguageName(pocCode) + } + fence := safeFence(pocCode) + lines = append(lines, fence+pocLang, pocCode, fence) + } + } + + if locations, ok := v["code_locations"].([]any); ok && len(locations) > 0 { + lines = append(lines, "", "## Code Analysis", "") + for i, item := range locations { + loc, ok := item.(map[string]any) + if !ok { + continue + } + file := render.StringValue(loc["file"]) + if file == "" { + file = "unknown" + } + lineRef := "" + if start := render.StringValue(loc["start_line"]); start != "" { + if end := render.StringValue(loc["end_line"]); end != "" && end != start { + lineRef = fmt.Sprintf(" (lines %s-%s)", start, end) + } else { + lineRef = fmt.Sprintf(" (line %s)", start) + } + } + lines = append(lines, fmt.Sprintf("**Location %d:** `%s`%s", i+1, file, lineRef)) + if label := render.StringValue(loc["label"]); label != "" { + lines = append(lines, " "+label) + } + if snippet := render.StringValue(loc["snippet"]); snippet != "" { + fence := safeFence(snippet) + lines = append(lines, fence+"\n"+snippet+"\n"+fence) + } + before := render.StringValue(loc["fix_before"]) + after := render.StringValue(loc["fix_after"]) + if before != "" || after != "" { + lines = append(lines, "**Suggested Fix:**", "```diff") + if before != "" { + for _, l := range strings.Split(before, "\n") { + lines = append(lines, "- "+l) + } + } + if after != "" { + for _, l := range strings.Split(after, "\n") { + lines = append(lines, "+ "+l) + } + } + lines = append(lines, "```") + } + lines = append(lines, "") + } + } + + section("Remediation", render.StringValue(v["remediation_steps"])) + section("Assumptions", render.StringValue(v["assumptions"])) + + lines = append(lines, "") + return strings.Join(lines, "\n") +} diff --git a/strix/interface/tui/internal/app/vulnerabilities.go b/strix/interface/tui/internal/app/vulnerabilities.go new file mode 100644 index 00000000..b8d988bf --- /dev/null +++ b/strix/interface/tui/internal/app/vulnerabilities.go @@ -0,0 +1,536 @@ +package app + +import ( + "fmt" + "strings" + + tea "github.com/charmbracelet/bubbletea" + "github.com/charmbracelet/lipgloss" + "github.com/charmbracelet/x/ansi" + "github.com/usestrix/strix/tui/internal/render" +) + +var panelSeverityColors = map[string]lipgloss.Color{ + "critical": render.SevCrit, "high": render.SevHigh, "medium": render.SevMed, "low": green, "info": blue, +} + +// vulnerabilityRow is one rendered line of the findings list. The list scrolls by +// row rather than by finding, so a long title does not make the panel jump a +// whole entry at a time. +type vulnerabilityRow struct { + index int // the finding this line belongs to + text string // one wrapped line of its title + first bool // the line that carries the number and the severity dot +} + +// vulnerabilityRows lays every finding out as the lines it will occupy. +func (m Model) vulnerabilityRows(width int) []vulnerabilityRow { + // Wrapped lines sit under the title rather than under the severity dot. + body := max(1, width-2) + rows := make([]vulnerabilityRow, 0, len(m.snapshot.Vulnerabilities)) + for i := range m.snapshot.Vulnerabilities { + for line, text := range strings.Split(wrapBlock(m.vulnerabilityTitle(i), body), "\n") { + rows = append(rows, vulnerabilityRow{index: i, text: text, first: line == 0}) + } + } + return rows +} + +func (m Model) vulnerabilitiesView(width, height int) string { + rows := m.vulnerabilityRows(width) + start := min(max(0, m.vulnOffset), max(0, len(rows)-1)) + end := min(len(rows), start+height) + lines := make([]string, 0, max(0, end-start)) + for _, row := range rows[start:end] { + style := lipgloss.NewStyle().Foreground(textColor) + if row.index == m.selectedVuln { + style = style.Bold(true).Foreground(white) + } + prefix := " " + if row.first { + severity := strings.ToLower(render.StringValue(m.snapshot.Vulnerabilities[row.index]["severity"])) + color, ok := panelSeverityColors[severity] + if !ok { + color = blue // matches SEVERITY_COLORS.get(severity, "#3b82f6") + } + prefix = lipgloss.NewStyle().Foreground(color).Render("● ") + } + lines = append(lines, prefix+style.Render(row.text)) + } + return strings.Join(lines, "\n") +} + +// vulnerabilityListWidth is the one width the findings list is laid out at, for +// rendering and for every interaction alike. Wrapping a title at two widths a +// column apart gives two different row counts, and then a click resolves to the +// wrong finding and the scrollbar reports the wrong length. +// +// The panel is sidebarWidth-2 wide with a column of padding either side, and the +// scrollbar takes one more. That last column is reserved whether or not the bar +// is showing, so the layout does not shift as the list grows past the panel. +func (m Model) vulnerabilityListWidth() int { + _, sidebarWidth, _, _ := m.layout() + return max(1, sidebarWidth-5) +} + +func (m Model) vulnerabilityTitle(index int) string { + title := render.StringValue(m.snapshot.Vulnerabilities[index]["title"]) + if title == "" { + title = "Unknown Vulnerability" + } + return title +} + +// vulnerabilityScrollRows reports the list length and position in rows, which is +// what the scrollbar needs to move continuously. +func (m Model) vulnerabilityScrollRows() (total, offset int) { + return len(m.vulnerabilityRows(m.vulnerabilityListWidth())), m.vulnOffset +} + +// vulnerabilityIndexAtRow maps a click on a visible row back to its finding. +func (m Model) vulnerabilityIndexAtRow(row int) int { + rows := m.vulnerabilityRows(m.vulnerabilityListWidth()) + target := m.vulnOffset + row + if target < 0 || target >= len(rows) { + return -1 + } + return rows[target].index +} + +// ensureVulnerabilityVisible scrolls the least it can to bring the selected +// finding into view, keeping the whole entry visible where it fits. +func (m *Model) ensureVulnerabilityVisible() { + rows := m.vulnerabilityRows(m.vulnerabilityListWidth()) + if len(rows) == 0 { + m.vulnOffset = 0 + return + } + height := m.vulnerabilityPageSize() + firstRow, lastRow := -1, -1 + for row, entry := range rows { + if entry.index != m.selectedVuln { + continue + } + if firstRow < 0 { + firstRow = row + } + lastRow = row + } + if firstRow < 0 { + m.vulnOffset = clampVulnerabilityOffset(m.vulnOffset, len(rows), height) + return + } + if firstRow < m.vulnOffset { + m.vulnOffset = firstRow + } else if lastRow >= m.vulnOffset+height { + // Prefer showing the whole entry, but never scroll its start out of view. + m.vulnOffset = min(firstRow, lastRow-height+1) + } + m.vulnOffset = clampVulnerabilityOffset(m.vulnOffset, len(rows), height) +} + +func clampVulnerabilityOffset(offset, total, height int) int { + return min(max(0, offset), max(0, total-height)) +} + +func (m Model) vulnerabilityPageSize() int { + _, vulnHeight, _ := m.sidebarHeights() + return max(1, vulnHeight-2) +} + +// vulnerabilityPageItems is how many findings a page step should move by: the +// number of distinct entries currently on screen. +func (m Model) vulnerabilityPageItems() int { + rows := m.vulnerabilityRows(m.vulnerabilityListWidth()) + height := m.vulnerabilityPageSize() + start := min(max(0, m.vulnOffset), max(0, len(rows))) + end := min(len(rows), start+height) + seen := 0 + previous := -1 + for _, row := range rows[start:end] { + if row.index != previous { + seen++ + previous = row.index + } + } + return max(1, seen) +} + +func (m *Model) moveVulnerabilitySelection(delta int) { + m.selectedVuln = max(0, min(len(m.snapshot.Vulnerabilities)-1, m.selectedVuln+delta)) +} + +// keepVulnerabilitySelectionInWindow pulls the selection to the nearest finding +// still on screen after the list has been scrolled directly. +func (m *Model) keepVulnerabilitySelectionInWindow() { + rows := m.vulnerabilityRows(m.vulnerabilityListWidth()) + if len(rows) == 0 { + return + } + height := m.vulnerabilityPageSize() + start := min(max(0, m.vulnOffset), max(0, len(rows)-1)) + end := min(len(rows), start+height) + visible := rows[start:end] + if len(visible) == 0 { + return + } + for _, row := range visible { + if row.index == m.selectedVuln { + return + } + } + if m.selectedVuln < visible[0].index { + m.selectedVuln = visible[0].index + return + } + m.selectedVuln = visible[len(visible)-1].index +} + +// statsView ports build_tui_stats_text + the version line appended in +// _update_stats_display: model, token/cost line, optional Caido URL, version. +func (m Model) modalView() string { + switch m.modal { + case modalHelp: + title := lipgloss.NewStyle().Bold(true).Foreground(green).Width(34).Align(lipgloss.Center).Render("Strix Help") + body := lipgloss.NewStyle().Foreground(textColor).Render("F1 Help\nCtrl+O Open viewer\nCtrl+Q/C Quit\nESC Stop Agent\nEnter Send / expand node\nCtrl+J Newline in message\nTab Switch panels\n↑/↓ Navigate tree\nDrag Select & copy text\nClick Expand/collapse tool") + content := title + "\n\n" + body + return lipgloss.NewStyle().Width(38).Border(lipgloss.RoundedBorder()).BorderForeground(green).Background(black).Padding(1, 2).Render(content) + case modalQuit: + // #quit_dialog: width 24, border round #333333, title #d4d4d4. + return m.confirmView("Quit Strix?", 24, dark, textColor) + case modalStop: + name := "agent" + if len(m.snapshot.Agents) > 0 { + name = m.snapshot.Agents[m.selectedAgent].Name + } + // #stop_agent_dialog: width 30, border round #a3a3a3, title #a3a3a3. + return m.confirmView("🛑 Stop '"+name+"'?", 30, mid, mid) + case modalConfirmMount: + return m.mountConfirmView() + case modalVulnerability: + if len(m.snapshot.Vulnerabilities) == 0 { + return "" + } + return m.vulnerabilityDetail() + } + return "" +} + +func (m Model) confirmView(title string, width int, border, titleColor lipgloss.Color) string { + return m.confirmDialog(title, "", width, border, titleColor, red, "Yes", "No") +} + +// mountConfirmView asks before a target-less scan mounts the working directory. +// It is a compact prompt docked in the corner of the live view: nothing is +// prepared until it is answered, and the directory is a workspace rather than a +// target, so the prompt is what the scan follows. +func (m Model) mountConfirmView() string { + width := min(52, max(20, m.width-4)) + dir := strings.TrimSpace(m.snapshot.PendingMount) + if dir == "" { + dir = "the current directory" + } + title := render.Bold(amber).Render("△ Mount working directory?") + body := render.Col(white).Render(truncatePath(dir, width-4)) + "\n" + + render.Dim().Render("writable in the sandbox") + return m.cornerPrompt(title, body, width, "Confirm", "Cancel") +} + +// truncatePath keeps the tail of a path visible, which is the part that +// identifies the directory. +func truncatePath(path string, width int) string { + if width <= 1 || lipgloss.Width(path) <= width { + return path + } + return "…" + ansi.TruncateLeft(path, lipgloss.Width(path)-width+1, "") +} + +// cornerPrompt renders a compact two-button prompt for the corner of the live +// view, sized to its content rather than centered like the modal dialogs. +func (m Model) cornerPrompt(title, body string, width int, confirmLabel, cancelLabel string) string { + // Each label keeps its padding whether or not it is focused, so moving the + // choice repaints a background instead of shifting the pair sideways. + button := func(label string, focused bool, fill lipgloss.Color) string { + style := lipgloss.NewStyle().Bold(true) + if focused { + return style.Background(fill).Foreground(brightWhite).Render(" " + label + " ") + } + return style.Foreground(fill).Render(" " + label + " ") + } + yes := button(confirmLabel, m.modalChoice == 0, amber) + no := button(cancelLabel, m.modalChoice != 0, dim) + if m.modalChoice != 0 { + no = button(cancelLabel, true, lipgloss.Color("#3e3e3e")) + } + inner := lipgloss.NewStyle().Width(width - 4) + content := inner.Render(title) + "\n" + inner.Render(body) + "\n" + + inner.Align(lipgloss.Right).Render(yes+" "+no) + return lipgloss.NewStyle().Width(width-2).Border(lipgloss.RoundedBorder()). + BorderForeground(amber).Background(black).Padding(0, 1).Render(content) +} + +// confirmDialog renders a two-button prompt. The focused button fills its +// background; body is optional detail shown between the title and the buttons. +func (m Model) confirmDialog( + title, body string, + width int, + border, titleColor, confirmColor lipgloss.Color, + confirmLabel, cancelLabel string, +) string { + // Two equal columns with a one-cell gutter. The buttons keep their columns + // whichever one is focused, so moving the choice repaints a background + // instead of shifting the row. + contentWidth := width - 4 + inner := lipgloss.NewStyle().Width(contentWidth) + // Two columns share the content width with a one-cell gutter; the label + // carries a space on each side before it is centered in its column. + leftColumn := (contentWidth - 1) / 2 + rightColumn := contentWidth - 1 - leftColumn + button := func(label string, column int, focused bool, fill lipgloss.Color) string { + style := lipgloss.NewStyle().Width(column).Align(lipgloss.Center).Bold(true) + if focused { + return style.Background(fill).Foreground(brightWhite).Render(" " + label + " ") + } + return style.Foreground(fill).Render(" " + label + " ") + } + yes := button(confirmLabel, leftColumn, m.modalChoice == 0, confirmColor) + no := button(cancelLabel, rightColumn, false, dim) + if m.modalChoice != 0 { + no = button(cancelLabel, rightColumn, true, lipgloss.Color("#3e3e3e")) + } + content := inner.Bold(true).Foreground(titleColor).Align(lipgloss.Center).Render(title) + if body != "" { + content += "\n\n" + inner.Render(body) + } + content += "\n\n" + inner.Align(lipgloss.Center).Render(yes+" "+no) + // Width() sets the content box, so the border's two columns come off it to + // keep the dialog the width the design calls for. + return lipgloss.NewStyle().Width(width - 2).Border(lipgloss.RoundedBorder()).BorderForeground(border).Background(black).Padding(1).Render(content) +} + +// vulnerabilityBody ports VulnerabilityDetailScreen._render_vulnerability: +// the exact field order, labels, colors, and dict keys. +func vulnerabilityBody(v map[string]any) string { + fieldStyle := render.Bold(render.Field) + var b strings.Builder + b.WriteString("🐞 " + render.Bold(render.ReportHdr).Render("Vulnerability Report")) + + field := func(label, value string) { + if value != "" { + b.WriteString("\n\n" + fieldStyle.Render(label+": ") + value) + } + } + field("Agent", render.StringValue(v["agent_name"])) + field("Title", render.StringValue(v["title"])) + if sev := render.StringValue(v["severity"]); sev != "" { + b.WriteString("\n\n" + fieldStyle.Render("Severity: ") + + lipgloss.NewStyle().Bold(true).Foreground(render.SeverityColor(sev)).Render(strings.ToUpper(sev))) + } + if score, ok := render.NumericValue(v["cvss"]); ok { + b.WriteString("\n\n" + fieldStyle.Render("CVSS Score: ") + + lipgloss.NewStyle().Bold(true).Foreground(render.CVSSColor(score)).Render(render.StringValue(v["cvss"]))) + } + field("Target", render.StringValue(v["target"])) + if dep, ok := v["dependency_metadata"].(map[string]any); ok { + field("Package", render.StringValue(dep["package_name"])) + field("Ecosystem", render.StringValue(dep["package_ecosystem"])) + field("Installed Version", render.StringValue(dep["installed_version"])) + field("Fixed Version", render.StringValue(dep["fixed_version"])) + field("Introduced By", render.StringValue(dep["introduced_by"])) + field("Dependency Chain", render.StringValue(dep["dependency_path"])) + } + field("Endpoint", render.StringValue(v["endpoint"])) + field("Method", render.StringValue(v["method"])) + field("CVE", render.StringValue(v["cve"])) + field("CWE", render.StringValue(v["cwe"])) + if fe := render.StringValue(v["fix_effort"]); fe != "" { + field("Fix Effort", titleCase(fe)) + } + if bd, ok := v["cvss_breakdown"].(map[string]any); ok && len(bd) > 0 { + if parts := render.CVSSVectorParts(bd); len(parts) > 0 { + b.WriteString("\n\n" + fieldStyle.Render("CVSS Vector: ") + render.Dim().Render(strings.Join(parts, "/"))) + } + } + + section := func(label, value string) { + if value != "" { + b.WriteString("\n\n" + fieldStyle.Render(label) + "\n" + value) + } + } + section("Description", render.StringValue(v["description"])) + section("Impact", render.StringValue(v["impact"])) + section("Technical Analysis", render.StringValue(v["technical_analysis"])) + section("Evidence", render.StringValue(v["evidence"])) + section("PoC Description", render.StringValue(v["poc_description"])) + if poc := render.StringValue(v["poc_script_code"]); poc != "" { + pocLang, pocCode := render.ParseFencedCode(poc) + b.WriteString("\n\n" + fieldStyle.Render("PoC Code") + "\n" + render.HighlightCode(pocCode, pocLang)) + } + section("Remediation", render.StringValue(v["remediation_steps"])) + section("Assumptions", render.StringValue(v["assumptions"])) + return b.String() +} + +func (m Model) vulnerabilityDialogSize() (width, height int) { + return min(m.width, min(110, max(40, m.width*85/100))), min(m.height, min(45, max(10, m.height*85/100))) +} + +func (m *Model) resizeVulnerabilityViewport() { + if m.modal != modalVulnerability || len(m.snapshot.Vulnerabilities) == 0 { + return + } + width, height := m.vulnerabilityDialogSize() + innerWidth := max(1, width-8) // border plus three cells of horizontal padding + m.vulnViewport.Width = max(1, innerWidth-2) // right padding and one-cell scrollbar + m.vulnViewport.Height = max(1, height-9) // padding, one-row grid gutter, and two-row footer + m.vulnViewport.SetContent(wrapBlock(vulnerabilityBody(m.snapshot.Vulnerabilities[m.selectedVuln]), m.vulnViewport.Width)) + m.vulnViewport.SetYOffset(m.vulnViewport.YOffset) +} + +func (m Model) vulnerabilityScrollView() string { + view := m.vulnViewport.View() + if m.vulnViewport.TotalLineCount() <= m.vulnViewport.VisibleLineCount() { + return view + " " + } + height := m.vulnViewport.Height + thumbHeight := max(1, height*m.vulnViewport.VisibleLineCount()/m.vulnViewport.TotalLineCount()) + thumbStart := int(m.vulnViewport.ScrollPercent() * float64(height-thumbHeight)) + bar := make([]string, height) + for row := range bar { + cell := " " + if row >= thumbStart && row < thumbStart+thumbHeight { + cell = lipgloss.NewStyle().Foreground(lipgloss.Color("#404040")).Render("█") + } + bar[row] = cell + } + return lipgloss.JoinHorizontal(lipgloss.Top, view, " ", strings.Join(bar, "\n")) +} + +func (m Model) vulnerabilityDetail() string { + width, height := m.vulnerabilityDialogSize() + inner := max(1, width-8) + // Button row: right-aligned Copy / Done above a top rule (#vuln_detail_buttons). + rule := lipgloss.NewStyle().Foreground(lipgloss.Color("#1a1a1a")).Render(strings.Repeat("─", max(1, inner))) + focused := m.focusedReportButton() + var stepping, acting []string + for _, button := range m.reportButtons() { + rendered := m.reportButton(button, button == focused) + if button == reportPrev || button == reportNext { + stepping = append(stepping, rendered) + continue + } + acting = append(acting, rendered) + } + // Stepping sits on the left behind the position, acting on the right. + right := strings.Join(acting, " ") + left := strings.Join(stepping, " ") + if total := len(m.snapshot.Vulnerabilities); total > 1 { + left = render.Dim().Render(fmt.Sprintf("%d/%d", m.selectedVuln+1, total)) + " " + left + } + room := max(0, inner-lipgloss.Width(right)) + buttonRow := rule + "\n" + + lipgloss.NewStyle().Width(room).Render(truncate(left, room)) + right + content := m.vulnerabilityScrollView() + "\n" + buttonRow + return lipgloss.NewStyle().Width(width-2).Height(height-2).Border(lipgloss.NormalBorder()).BorderForeground(lipgloss.Color("#262626")).Background(lipgloss.Color("#0a0a0a")).Padding(2, 3).Render(content) +} + +// showVulnerability moves the open report to another finding, keeping the list +// behind it in step and starting the new report at its top. +func (m *Model) showVulnerability(index int) { + if index < 0 || index >= len(m.snapshot.Vulnerabilities) || index == m.selectedVuln { + return + } + m.selectedVuln = index + m.ensureVulnerabilityVisible() + // The copy state belongs to the report that was on screen, not this one. + m.vulnerabilityCopied = false + m.vulnerabilityCopyError = "" + m.resizeVulnerabilityViewport() + m.vulnViewport.GotoTop() +} + +// The report's buttons. Prev and Next carry their arrows so a click test cannot +// be fooled by the same word appearing in the body of a finding. +const ( + reportPrev = "‹ Prev" + reportNext = "Next ›" + reportCopy = "Copy" + reportDone = "Done" +) + +// reportButtons is the row as it stands, left to right. Stepping is offered only +// in the directions that have a report. +func (m Model) reportButtons() []string { + previous, next := m.vulnerabilityNeighbors() + buttons := make([]string, 0, 4) + if previous { + buttons = append(buttons, reportPrev) + } + if next { + buttons = append(buttons, reportNext) + } + return append(buttons, reportCopy, reportDone) +} + +// focusedReportButton is the button Enter would press. It falls back to Done when +// the focused one has gone, which happens when stepping to either end drops a +// direction from the row. +func (m Model) focusedReportButton() string { + for _, button := range m.reportButtons() { + if button == m.reportFocus { + return button + } + } + return reportDone +} + +// stepReportFocus moves along the row, wrapping at its ends. +func (m *Model) stepReportFocus(delta int) { + buttons := m.reportButtons() + current := 0 + for i, button := range buttons { + if button == m.focusedReportButton() { + current = i + } + } + m.reportFocus = buttons[clampCycle(current+delta, len(buttons))] +} + +// vulnerabilityNeighbors reports which way the open report can be stepped. The +// ends are not wrapped: a report is one of an ordered list, and rolling from the +// last to the first hides that you reached the end. +func (m Model) vulnerabilityNeighbors() (previous, next bool) { + return m.selectedVuln > 0, m.selectedVuln < len(m.snapshot.Vulnerabilities)-1 +} + +// reportButton renders one button of the report row. Copy reports the outcome of +// the last attempt in its own label. +func (m Model) reportButton(label string, focused bool) string { + if label == reportCopy { + switch { + case m.vulnerabilityCopied: + label = "Copied!" + case m.vulnerabilityCopyError != "": + label = "Copy failed" + } + } + if focused { + return lipgloss.NewStyle().Background(lipgloss.Color("#363636")). + Foreground(brightWhite).Bold(true).Padding(0, 1).Render(label) + } + return lipgloss.NewStyle().Foreground(lipgloss.Color("#525252")).Render(label) +} + +func (m *Model) startVulnerabilityCopy() tea.Cmd { + m.vulnerabilityCopied = false + m.vulnerabilityCopyError = "" + if m.selectedVuln < 0 || m.selectedVuln >= len(m.snapshot.Vulnerabilities) { + return nil + } + report := vulnerabilityMarkdownReport(m.snapshot.Vulnerabilities[m.selectedVuln]) + return func() tea.Msg { + return vulnerabilityCopiedMsg{err: writeClipboard(report)} + } +} + +// titleCase upper-cases the first letter of each word (Python str.title()). diff --git a/strix/interface/tui/internal/app/wire.go b/strix/interface/tui/internal/app/wire.go new file mode 100644 index 00000000..b1bb7337 --- /dev/null +++ b/strix/interface/tui/internal/app/wire.go @@ -0,0 +1,467 @@ +package app + +import ( + "encoding/json" + "strings" + "time" + + tea "github.com/charmbracelet/bubbletea" + "github.com/usestrix/strix/tui/internal/protocol" + "github.com/usestrix/strix/tui/internal/render" +) + +func (m *Model) handleEnvelope(envelope protocol.Envelope) tea.Cmd { + switch envelope.Type { + case "state": + var update protocol.StateUpdate + if err := json.Unmarshal(envelope.Payload, &update); err != nil { + m.errorText = err.Error() + return nil + } + if update.Revision <= m.stateRevision { + return nil + } + selectedAgentID := "" + if m.selectedAgent >= 0 && m.selectedAgent < len(m.snapshot.Agents) { + selectedAgentID = m.snapshot.Agents[m.selectedAgent].ID + } + update.State.Events = m.snapshot.Events + update.State.Vulnerabilities = m.snapshot.Vulnerabilities + update.State.Agents = m.snapshot.Agents + m.consumeMessages(update.State.Messages, update.State.SetupMode) + m.snapshot = update.State + m.stateRevision = update.Revision + if m.snapshot.Error != nil { + m.errorText = *m.snapshot.Error + } + if m.snapshot.SetupMode { + // The start screen is its own landing page; never sit on the + // splash before it. + m.showSplash = false + m.input.Placeholder = setupPlaceholder + } else { + m.input.Placeholder = chatPlaceholder + } + m.selectedAgent = selectedAgentIndex(m.snapshot.Agents, selectedAgentID) + m.selectedVuln = min(m.selectedVuln, max(0, len(m.snapshot.Vulnerabilities)-1)) + if m.modal == modalStop && !m.selectedAgentCanStop() { + m.closeModal() + } + m.syncMountPrompt() + m.ensureAgentVisible() + m.ensureVulnerabilityVisible() + m.ready = true + // resize (not just refresh): status-row visibility changes the chat height. + m.resizeViewport() + m.resizeVulnerabilityViewport() + case "collection_bootstrap": + return m.handleCollectionBootstrap(envelope.Payload) + case "collection_delta": + return m.handleCollectionDelta(envelope.Payload) + case "command_result": + if m.client == nil { + return nil + } + expectedCommand, pending := m.client.ExpectedCommand(envelope.RequestID) + if !pending { + return nil + } + var result protocol.CommandResult + if err := json.Unmarshal(envelope.Payload, &result); err != nil { + m.errorText = err.Error() + return nil + } + if result.Command != expectedCommand || !m.client.Resolve(envelope.RequestID, result.Command) { + return nil + } + if !result.OK { + if result.Command == "collection.resync" { + if collection := m.resyncRequests[envelope.RequestID]; collection != "" { + m.resyncRequested[collection] = false + delete(m.resyncRequests, envelope.RequestID) + } + } + message := "Command failed" + if result.Error != nil && strings.TrimSpace(result.Error.Message) != "" { + message = result.Error.Message + } + // Setup-mode errors live in the scrollback (red), like Python; during + // a scan they surface on the status line. + if m.snapshot.SetupMode { + m.setupMsg(message, render.Col(red)) + } else { + m.errorText = message + } + return nil + } + if m.snapshot.ScanStarted && !m.snapshot.SetupMode && strings.HasPrefix(result.Command, "setup.") { + return nil + } + m.errorText = "" + switch result.Command { + case "viewer.open": + var data struct { + Status string `json:"status"` + URL *string `json:"url"` + } + _ = json.Unmarshal(result.Result, &data) + m.snapshot.ViewerStatus = data.Status + m.snapshot.ViewerURL = data.URL + } + } + return nil +} + +func (m *Model) consumeMessages(messages []protocol.Message, setupMode bool) { + if m.seenMessages == nil { + m.seenMessages = map[string]bool{} + } + for _, message := range messages { + key := message.ID + if key == "" { + key = message.Level + "\x00" + message.Text + } + if m.seenMessages[key] { + continue + } + m.seenMessages[key] = true + if !setupMode || strings.TrimSpace(message.Text) == "" { + continue + } + style := render.Dim() + switch message.Level { + case "error": + style = render.Col(red) + case "warning": + style = render.Col(amber) + } + m.setupMsg(message.Text, style) + } +} + +func validCollection(name string) bool { + return name == "agents" || name == "events" || name == "vulnerabilities" +} + +func (m *Model) collectionMismatch(name string) tea.Cmd { + delete(m.collectionAssemblies, name) + if !validCollection(name) || m.resyncRequested[name] || m.client == nil { + return nil + } + m.resyncRequested[name] = true + return send(m.client, "collection.resync", map[string]any{"collection": name}) +} + +func (m *Model) clearCollectionResync(name string) { + m.resyncRequested[name] = false + for requestID, collection := range m.resyncRequests { + if collection == name { + delete(m.resyncRequests, requestID) + } + } +} + +func (m *Model) handleCollectionBootstrap(payload json.RawMessage) tea.Cmd { + var chunk protocol.CollectionBootstrap + if err := json.Unmarshal(payload, &chunk); err != nil { + m.errorText = err.Error() + return nil + } + if !validCollection(chunk.Collection) { + m.errorText = "Unknown collection: " + chunk.Collection + return nil + } + if chunk.Cursor == 0 { + m.resyncRequested[chunk.Collection] = false + } + if chunk.Cursor == 0 { + if chunk.Revision <= m.collectionRevisions[chunk.Collection] { + return nil + } + m.collectionAssemblies[chunk.Collection] = &collectionAssembly{ + kind: "bootstrap", revision: chunk.Revision, ids: map[string]bool{}, + } + } + assembly := m.collectionAssemblies[chunk.Collection] + if assembly == nil || assembly.kind != "bootstrap" || assembly.revision != chunk.Revision || assembly.cursor != chunk.Cursor { + return m.collectionMismatch(chunk.Collection) + } + if chunk.NextCursor != chunk.Cursor+len(chunk.Items) { + return m.collectionMismatch(chunk.Collection) + } + for _, raw := range chunk.Items { + if chunk.Collection == "agents" { + var agent protocol.Agent + if err := json.Unmarshal(raw, &agent); err != nil || agent.ID == "" { + return m.collectionMismatch(chunk.Collection) + } + if assembly.ids[agent.ID] { + return m.collectionMismatch(chunk.Collection) + } + assembly.ids[agent.ID] = true + assembly.agents = append(assembly.agents, agent) + } else if chunk.Collection == "events" { + var event protocol.Event + if err := json.Unmarshal(raw, &event); err != nil || event.ID == "" { + return m.collectionMismatch(chunk.Collection) + } + if assembly.ids[event.ID] { + return m.collectionMismatch(chunk.Collection) + } + assembly.ids[event.ID] = true + assembly.events = append(assembly.events, event) + } else { + var finding map[string]any + if err := json.Unmarshal(raw, &finding); err != nil || collectionItemID(finding) == "" { + return m.collectionMismatch(chunk.Collection) + } + id := collectionItemID(finding) + if assembly.ids[id] { + return m.collectionMismatch(chunk.Collection) + } + assembly.ids[id] = true + assembly.findings = append(assembly.findings, finding) + } + } + assembly.cursor = chunk.NextCursor + if !chunk.Done { + return nil + } + if chunk.Collection == "agents" { + selectedAgentID := m.selectedAgentID() + m.snapshot.Agents = assembly.agents + m.selectedAgent = selectedAgentIndex(m.snapshot.Agents, selectedAgentID) + } else if chunk.Collection == "events" { + m.snapshot.Events = assembly.events + } else { + m.snapshot.Vulnerabilities = assembly.findings + } + m.collectionRevisions[chunk.Collection] = chunk.Revision + delete(m.collectionAssemblies, chunk.Collection) + m.clearCollectionResync(chunk.Collection) + return m.refreshAfterCollection(chunk.Collection) +} + +func (m *Model) handleCollectionDelta(payload json.RawMessage) tea.Cmd { + var chunk protocol.CollectionDelta + if err := json.Unmarshal(payload, &chunk); err != nil { + m.errorText = err.Error() + return nil + } + if !validCollection(chunk.Collection) { + m.errorText = "Unknown collection: " + chunk.Collection + return nil + } + if chunk.Cursor == 0 { + if chunk.BaseRevision != m.collectionRevisions[chunk.Collection] || chunk.Revision <= chunk.BaseRevision { + return m.collectionMismatch(chunk.Collection) + } + m.collectionAssemblies[chunk.Collection] = &collectionAssembly{ + kind: "delta", revision: chunk.Revision, baseRevision: chunk.BaseRevision, + } + } + assembly := m.collectionAssemblies[chunk.Collection] + if assembly == nil || assembly.kind != "delta" || assembly.revision != chunk.Revision || + assembly.baseRevision != chunk.BaseRevision || assembly.cursor != chunk.Cursor { + return m.collectionMismatch(chunk.Collection) + } + if chunk.NextCursor != chunk.Cursor+len(chunk.Operations) { + return m.collectionMismatch(chunk.Collection) + } + assembly.operations = append(assembly.operations, chunk.Operations...) + assembly.cursor = chunk.NextCursor + if !chunk.Done { + return nil + } + if !m.applyCollectionOperations(chunk.Collection, assembly.operations) { + return m.collectionMismatch(chunk.Collection) + } + m.collectionRevisions[chunk.Collection] = chunk.Revision + delete(m.collectionAssemblies, chunk.Collection) + m.clearCollectionResync(chunk.Collection) + return m.refreshAfterCollection(chunk.Collection) +} + +func (m *Model) applyCollectionOperations(name string, operations []protocol.CollectionOperation) bool { + seen := make(map[string]bool, len(operations)) + if name == "agents" { + selectedAgentID := m.selectedAgentID() + values := append([]protocol.Agent(nil), m.snapshot.Agents...) + positions := make(map[string]int, len(values)) + for index, agent := range values { + positions[agent.ID] = index + } + for _, operation := range operations { + if operation.Op == "delete" { + if operation.ID == "" || seen[operation.ID] { + return false + } + seen[operation.ID] = true + index, exists := positions[operation.ID] + if !exists { + return false + } + values = append(values[:index], values[index+1:]...) + positions = make(map[string]int, len(values)) + for position, value := range values { + positions[value.ID] = position + } + continue + } + if operation.Op != "upsert" { + return false + } + var agent protocol.Agent + if err := json.Unmarshal(operation.Item, &agent); err != nil || agent.ID == "" || seen[agent.ID] { + return false + } + seen[agent.ID] = true + if index, exists := positions[agent.ID]; exists { + values[index] = agent + } else { + positions[agent.ID] = len(values) + values = append(values, agent) + } + } + m.snapshot.Agents = values + m.selectedAgent = selectedAgentIndex(values, selectedAgentID) + return true + } + if name == "events" { + values := append([]protocol.Event(nil), m.snapshot.Events...) + positions := make(map[string]int, len(values)) + for index, event := range values { + positions[event.ID] = index + } + for _, operation := range operations { + if operation.Op == "delete" { + if operation.ID == "" || seen[operation.ID] { + return false + } + seen[operation.ID] = true + index, exists := positions[operation.ID] + if !exists { + return false + } + values = append(values[:index], values[index+1:]...) + positions = make(map[string]int, len(values)) + for position, value := range values { + positions[value.ID] = position + } + continue + } + if operation.Op != "upsert" { + return false + } + var event protocol.Event + if err := json.Unmarshal(operation.Item, &event); err != nil || event.ID == "" || event.Version < 0 || seen[event.ID] { + return false + } + seen[event.ID] = true + if index, exists := positions[event.ID]; exists { + current := values[index] + if event.Version <= current.Version { + return false + } + values[index] = event + } else { + positions[event.ID] = len(values) + values = append(values, event) + } + } + m.snapshot.Events = values + return true + } + + values := append([]map[string]any(nil), m.snapshot.Vulnerabilities...) + positions := make(map[string]int, len(values)) + for index, finding := range values { + positions[collectionItemID(finding)] = index + } + for _, operation := range operations { + if operation.Op == "delete" { + if operation.ID == "" || seen[operation.ID] { + return false + } + seen[operation.ID] = true + index, exists := positions[operation.ID] + if !exists { + return false + } + values = append(values[:index], values[index+1:]...) + positions = make(map[string]int, len(values)) + for position, value := range values { + positions[collectionItemID(value)] = position + } + continue + } + if operation.Op != "upsert" { + return false + } + var finding map[string]any + if err := json.Unmarshal(operation.Item, &finding); err != nil { + return false + } + id := collectionItemID(finding) + if id == "" { + return false + } + if seen[id] { + return false + } + seen[id] = true + if index, exists := positions[id]; exists { + values[index] = finding + } else { + positions[id] = len(values) + values = append(values, finding) + } + } + m.snapshot.Vulnerabilities = values + return true +} + +func collectionItemID(item map[string]any) string { + id, _ := item["id"].(string) + return id +} + +func (m *Model) refreshAfterCollection(name string) tea.Cmd { + if name == "agents" { + m.ensureAgentVisible() + m.refreshViewport() + return m.notifyBudgetPause() + } + if name == "events" { + m.refreshViewport() + return nil + } + m.selectedVuln = min(m.selectedVuln, max(0, len(m.snapshot.Vulnerabilities)-1)) + m.ensureVulnerabilityVisible() + m.resizeVulnerabilityViewport() + return nil +} + +// notifyBudgetPause ports _notify_budget_pause: a one-shot warning toast when +// any agent hits the budget limit, re-armed once no agent is paused. +func (m *Model) notifyBudgetPause() tea.Cmd { + paused := false + for _, agent := range m.snapshot.Agents { + if agent.Status == "budget_paused" { + paused = true + break + } + } + if paused && !m.budgetPauseNotified { + m.budgetPauseNotified = true + return m.showToastFor( + "Budget limit reached — agents paused. Send a message to continue "+ + "(this extends the budget), or ctrl-q to quit.", + 15*time.Second, + ) + } + if !paused { + m.budgetPauseNotified = false + } + return nil +} diff --git a/strix/interface/tui/internal/protocol/protocol.go b/strix/interface/tui/internal/protocol/protocol.go new file mode 100644 index 00000000..38ba63a3 --- /dev/null +++ b/strix/interface/tui/internal/protocol/protocol.go @@ -0,0 +1,118 @@ +package protocol + +import "encoding/json" + +const Version = 3 + +var Capabilities = []string{ + "state-revisions", + "collection-deltas", + "structured-command-errors", + "agents-collection", +} + +type Envelope struct { + Version int `json:"version"` + Type string `json:"type"` + RequestID string `json:"request_id,omitempty"` + Payload json.RawMessage `json:"payload"` +} + +type Message struct { + ID string `json:"id"` + Text string `json:"text"` + Level string `json:"level"` +} + +type Agent struct { + ID string `json:"id"` + Name string `json:"name"` + ParentID *string `json:"parent_id"` + Status string `json:"status"` + ErrorMessage string `json:"error_message"` +} + +type Event struct { + ID string `json:"id"` + Type string `json:"type"` + AgentID string `json:"agent_id"` + Timestamp string `json:"timestamp"` + Version int `json:"version"` + Data map[string]any `json:"data"` +} + +type Hello struct { + Capabilities []string `json:"capabilities"` +} + +type Snapshot struct { + SetupMode bool `json:"setup_mode"` + ScanStarted bool `json:"scan_started"` + ScanState string `json:"scan_state"` + Targets []string `json:"targets"` + TargetCount int `json:"target_count"` + WorkingDir string `json:"working_dir"` + PendingMount string `json:"pending_mount"` + Instruction string `json:"instruction"` + ScanMode string `json:"scan_mode"` + MaxBudgetUSD *float64 `json:"max_budget_usd"` + MaxTurns int `json:"max_turns"` + ScopeMode string `json:"scope_mode"` + DiffBase string `json:"diff_base"` + Model string `json:"model"` + ModelWarning string `json:"model_warning"` + CaidoURL string `json:"caido_url"` + Messages []Message `json:"messages"` + Agents []Agent `json:"-"` + Events []Event `json:"-"` + Vulnerabilities []map[string]any `json:"-"` + Usage map[string]any `json:"usage"` + Subscription bool `json:"subscription"` + ViewerStatus string `json:"viewer_status"` + ViewerURL *string `json:"viewer_url"` + Error *string `json:"error"` + ProjectionTruncated bool `json:"projection_truncated"` +} + +type StateUpdate struct { + Revision int `json:"revision"` + State Snapshot `json:"state"` +} + +type CollectionBootstrap struct { + Collection string `json:"collection"` + Revision int `json:"revision"` + Cursor int `json:"cursor"` + NextCursor int `json:"next_cursor"` + Done bool `json:"done"` + Items []json.RawMessage `json:"items"` +} + +type CollectionOperation struct { + Op string `json:"op"` + ID string `json:"id,omitempty"` + Item json.RawMessage `json:"item"` +} + +type CollectionDelta struct { + Collection string `json:"collection"` + BaseRevision int `json:"base_revision"` + Revision int `json:"revision"` + Cursor int `json:"cursor"` + NextCursor int `json:"next_cursor"` + Done bool `json:"done"` + Operations []CollectionOperation `json:"operations"` +} + +type CommandError struct { + Code string `json:"code"` + Message string `json:"message"` + Retryable bool `json:"retryable"` +} + +type CommandResult struct { + OK bool `json:"ok"` + Command string `json:"command"` + Result json.RawMessage `json:"result"` + Error *CommandError `json:"error"` +} diff --git a/strix/interface/tui/internal/protocol/protocol_test.go b/strix/interface/tui/internal/protocol/protocol_test.go new file mode 100644 index 00000000..f2f539b6 --- /dev/null +++ b/strix/interface/tui/internal/protocol/protocol_test.go @@ -0,0 +1,22 @@ +package protocol + +import ( + "reflect" + "testing" +) + +func TestProtocolVersionAndCapabilities(t *testing.T) { + if Version != 3 { + t.Fatalf("protocol version = %d, want 3", Version) + } + wantCapabilities := []string{ + "state-revisions", + "collection-deltas", + "structured-command-errors", + "agents-collection", + } + if !reflect.DeepEqual(Capabilities, wantCapabilities) { + t.Fatalf("capabilities = %#v, want %#v", Capabilities, wantCapabilities) + } + +} diff --git a/strix/interface/tui/internal/render/agent_message.go b/strix/interface/tui/internal/render/agent_message.go new file mode 100644 index 00000000..84715223 --- /dev/null +++ b/strix/interface/tui/internal/render/agent_message.go @@ -0,0 +1,320 @@ +package render + +import ( + "regexp" + "strings" + + "github.com/charmbracelet/lipgloss" +) + +// --------------------------------------------------------------------------- +// Markdown (agent_message_renderer.py) +// --------------------------------------------------------------------------- + +var blankLineRuns = regexp.MustCompile(`\n\s*\n`) + +type mdHeader struct { + prefix string + strip int + style lipgloss.Style +} + +var mdHeaders = []mdHeader{ + {"###### ", 7, Bold(Field)}, + {"##### ", 6, Bold(Green)}, + {"#### ", 5, Bold(Hdr16a)}, + {"### ", 4, Bold(Hdr158)}, + {"## ", 3, Bold(Green)}, + {"# ", 2, Bold(Field)}, +} + +// renderAssistantMarkdown ports AgentMessageRenderer.render_simple + helpers. +func renderAssistantMarkdown(content string) string { + if content == "" { + return "" + } + cleaned := strings.TrimSpace(blankLineRuns.ReplaceAllString(content, "\n\n")) + if cleaned == "" { + return "" + } + return applyMarkdownStyles(cleaned) +} + +func applyMarkdownStyles(text string) string { + var out strings.Builder + lines := strings.Split(text, "\n") + + inCode := false + codeLang := "" + var codeLines []string + + flushCode := func() { + if len(codeLines) > 0 { + out.WriteString(HighlightCode(strings.Join(codeLines, "\n"), codeLang)) + } + codeLines = nil + codeLang = "" + } + + for i := 0; i < len(lines); i++ { + line := lines[i] + if i > 0 && !inCode { + out.WriteString("\n") + } + + if !inCode { + if rows := tableRows(lines[i:]); rows > 0 { + out.WriteString(renderMarkdownTable(lines[i : i+rows])) + i += rows - 1 + continue + } + } + + if strings.HasPrefix(line, "```") { + if !inCode { + inCode = true + codeLines = nil + codeLang = strings.TrimSpace(strings.TrimPrefix(line, "```")) + if i > 0 { + out.WriteString("\n") + } + } else { + inCode = false + flushCode() + } + continue + } + + if inCode { + codeLines = append(codeLines, line) + continue + } + + if h := tryHeader(line); h != nil { + out.WriteString(h.style.Render(line[h.strip:])) + continue + } + switch { + case strings.HasPrefix(line, "> "): + out.WriteString(Col(Green).Render("┃ ") + inlineFormat(line[2:])) + case strings.HasPrefix(line, "- "), strings.HasPrefix(line, "* "): + out.WriteString(Col(Green).Render("• ") + inlineFormat(line[2:])) + case len(line) > 2 && line[0] >= '0' && line[0] <= '9' && (line[1:3] == ". " || line[1:3] == ") "): + out.WriteString(Col(Green).Render(string(line[0])+". ") + inlineFormat(line[2:])) + case line == "---" || line == "***" || line == "___": + out.WriteString(Col(Green).Render(strings.Repeat("─", 40))) + default: + out.WriteString(inlineFormat(line)) + } + } + + if inCode && len(codeLines) > 0 { + flushCode() + } + return out.String() +} + +func isTableRow(line string) bool { + trimmed := strings.TrimSpace(line) + return strings.HasPrefix(trimmed, "|") && strings.Count(trimmed, "|") >= 2 +} + +var tableSeparatorCell = regexp.MustCompile(`^:?-+:?$`) + +func isTableSeparator(line string) bool { + if !isTableRow(line) { + return false + } + cells := splitTableRow(line) + if len(cells) == 0 { + return false + } + for _, cell := range cells { + if !tableSeparatorCell.MatchString(strings.TrimSpace(cell)) { + return false + } + } + return true +} + +// tableRows returns how many leading lines form a markdown table (header, +// separator, then body rows), or 0 when the block is not a table. +func tableRows(lines []string) int { + if len(lines) < 2 || !isTableRow(lines[0]) || !isTableSeparator(lines[1]) { + return 0 + } + rows := 2 + for rows < len(lines) && isTableRow(lines[rows]) && !isTableSeparator(lines[rows]) { + rows++ + } + return rows +} + +func splitTableRow(line string) []string { + trimmed := strings.TrimSpace(line) + trimmed = strings.TrimPrefix(trimmed, "|") + trimmed = strings.TrimSuffix(trimmed, "|") + cells := strings.Split(trimmed, "|") + for i := range cells { + cells[i] = strings.TrimSpace(cells[i]) + } + return cells +} + +// renderMarkdownTable draws a column-aligned table: bold header, a rule under +// it, and inline-formatted body cells. +func renderMarkdownTable(lines []string) string { + headerStyle := func(cell string) string { return Bold(Field).Render(cell) } + rows := make([][]string, 0, len(lines)-1) + styleCells := func(line string, style func(string) string) []string { + cells := splitTableRow(line) + for i := range cells { + cells[i] = style(cells[i]) + } + return cells + } + rows = append(rows, styleCells(lines[0], headerStyle)) + for _, line := range lines[2:] { + rows = append(rows, styleCells(line, inlineFormat)) + } + + widths := make([]int, len(rows[0])) + for _, cells := range rows { + for i, cell := range cells { + if i < len(widths) { + widths[i] = max(widths[i], lipgloss.Width(cell)) + } + } + } + + formatRow := func(cells []string) string { + parts := make([]string, len(widths)) + for i := range widths { + cell := "" + if i < len(cells) { + cell = cells[i] + } + parts[i] = cell + strings.Repeat(" ", max(0, widths[i]-lipgloss.Width(cell))) + } + return strings.TrimRight(strings.Join(parts, Dim().Render(" │ ")), " ") + } + + out := []string{formatRow(rows[0])} + rule := make([]string, len(widths)) + for i, width := range widths { + rule[i] = strings.Repeat("─", width) + } + out = append(out, Dim().Render(strings.Join(rule, "─┼─"))) + for _, cells := range rows[1:] { + out = append(out, formatRow(cells)) + } + return strings.Join(out, "\n") +} + +func tryHeader(line string) *mdHeader { + for i := range mdHeaders { + if strings.HasPrefix(line, mdHeaders[i].prefix) { + return &mdHeaders[i] + } + } + return nil +} + +func isWordByte(b byte) bool { + return b == '_' || b >= '0' && b <= '9' || b >= 'a' && b <= 'z' || b >= 'A' && b <= 'Z' +} + +// canOpenEmphasis reports whether an emphasis run starting at i (with the +// given marker width) follows CommonMark-style flanking rules: it must not +// sit inside a word and must be followed by a non-space. +func canOpenEmphasis(line string, i, width int) bool { + if i > 0 && isWordByte(line[i-1]) { + return false + } + // Underscores appear inside identifiers far more often than as emphasis, + // so they only open at a word boundary. + if i > 0 && line[i] == '_' && line[i-1] != ' ' && line[i-1] != '\t' { + return false + } + after := i + width + return after < len(line) && line[after] != ' ' && line[after] != '\t' +} + +// canCloseEmphasis reports whether an emphasis run ending at end (marker +// starts at end) is preceded by a non-space and not followed by a word. +func canCloseEmphasis(line string, end, width int) bool { + if end > 0 && (line[end-1] == ' ' || line[end-1] == '\t') { + return false + } + after := end + width + return after >= len(line) || !isWordByte(line[after]) +} + +// findEmphasisEnd locates the closing marker for an emphasis span opened at +// i, honoring the flanking rules; returns -1 when the span should be treated +// as literal text. +func findEmphasisEnd(line string, i int, marker string) int { + from := i + len(marker) + for { + end := strings.Index(line[from:], marker) + if end == -1 { + return -1 + } + end += from + if end == i+len(marker) { + return -1 + } + if canCloseEmphasis(line, end, len(marker)) { + return end + } + from = end + 1 + } +} + +// inlineFormat ports _process_inline_formatting. +func inlineFormat(line string) string { + var out strings.Builder + i, n := 0, len(line) + for i < n { + if i+1 < n && (line[i:i+2] == "**" || line[i:i+2] == "__") { + marker := line[i : i+2] + if canOpenEmphasis(line, i, 2) { + if end := findEmphasisEnd(line, i, marker); end != -1 { + out.WriteString(Bold(Field).Render(line[i+2 : end])) + i = end + 2 + continue + } + } + } + if i+1 < n && line[i:i+2] == "~~" { + if canOpenEmphasis(line, i, 2) { + if end := findEmphasisEnd(line, i, "~~"); end != -1 { + out.WriteString(lipgloss.NewStyle().Strikethrough(true).Foreground(Strike).Render(line[i+2 : end])) + i = end + 2 + continue + } + } + } + if line[i] == '`' { + if end := strings.Index(line[i+1:], "`"); end != -1 { + end += i + 1 + out.WriteString(lipgloss.NewStyle().Bold(true).Foreground(Green).Background(CodeBg).Render(line[i+1 : end])) + i = end + 1 + continue + } + } + if line[i] == '*' || line[i] == '_' { + marker := string(line[i]) + if i+1 < n && line[i+1] != line[i] && canOpenEmphasis(line, i, 1) { + if end := findEmphasisEnd(line, i, marker); end != -1 && (end+1 >= n || line[end+1] != line[i]) { + out.WriteString(lipgloss.NewStyle().Italic(true).Foreground(Mint).Render(line[i+1 : end])) + i = end + 1 + continue + } + } + } + out.WriteByte(line[i]) + i++ + } + return out.String() +} diff --git a/strix/interface/tui/internal/render/agents_graph.go b/strix/interface/tui/internal/render/agents_graph.go new file mode 100644 index 00000000..2a83448b --- /dev/null +++ b/strix/interface/tui/internal/render/agents_graph.go @@ -0,0 +1,86 @@ +package render + +import ( + "strings" + + "github.com/charmbracelet/lipgloss" +) + +// --------------------------------------------------------------------------- +// Agents graph (agents_graph_renderer.py) +// --------------------------------------------------------------------------- + +func renderAgentGraphTool(name string, args map[string]any, result any) string { + var b strings.Builder + switch name { + case "view_agent_graph": + b.WriteString(Col(Lavender).Render("◇ ") + Dim().Render("viewing agents graph")) + case "create_agent": + agentName := StringValue(args["name"]) + if agentName == "" { + agentName = "Agent" + } + b.WriteString(Col(Lavender).Render("◈ ") + Dim().Render("spawning ") + Bold(Lavender).Render(agentName)) + if task := StringValue(args["task"]); task != "" { + b.WriteString("\n " + Dim().Render(task)) + } + case "send_message_to_agent": + b.WriteString(Col(InfoBlue).Render("→ ")) + if target := StringValue(args["target_agent_id"]); target != "" { + b.WriteString(Dim().Render("to " + target)) + } else { + b.WriteString(Dim().Render("sending message")) + } + if msg := StringValue(args["message"]); msg != "" { + b.WriteString("\n " + Dim().Render(msg)) + } + case "agent_finish": + success := true + if v, ok := args["success"].(bool); ok { + success = v + } + if success { + b.WriteString(Col(Green).Render("◆ ") + Bold(Green).Render("Agent completed")) + } else { + b.WriteString(Col(Red).Render("◆ ") + Bold(Red).Render("Agent failed")) + } + if summary := StringValue(args["result_summary"]); summary != "" { + b.WriteString("\n " + lipgloss.NewStyle().Bold(true).Render(summary)) + if findings, ok := args["findings"].([]any); ok { + for _, f := range findings { + b.WriteString("\n • " + Dim().Render(StringValue(f))) + } + } + } else { + b.WriteString("\n " + Dim().Render("Completing task...")) + } + case "wait_for_agents": + b.WriteString(Col(Gray).Render("○ ") + Dim().Render("waiting")) + if reason := StringValue(args["reason"]); reason != "" { + b.WriteString("\n " + Dim().Render(reason)) + } + case "stop_agent": + b.WriteString(Col(Red).Render("◼ ") + Dim().Render("stopping")) + if target := StringValue(args["target_agent_id"]); target != "" { + b.WriteString(Bold(Red).Render(" " + target)) + } + cascade := true + if v, ok := args["cascade"].(bool); ok { + cascade = v + } + if cascade { + b.WriteString(Dim().Italic(true).Render(" + descendants")) + } + if reason := StringValue(args["reason"]); reason != "" { + b.WriteString("\n " + Dim().Render(reason)) + } + if m, ok := result.(map[string]any); ok { + if s, hs := m["success"].(bool); hs && !s { + if e := StringValue(m["error"]); e != "" { + b.WriteString("\n " + Col(Red).Render(e)) + } + } + } + } + return b.String() +} diff --git a/strix/interface/tui/internal/render/chat.go b/strix/interface/tui/internal/render/chat.go new file mode 100644 index 00000000..bfc42728 --- /dev/null +++ b/strix/interface/tui/internal/render/chat.go @@ -0,0 +1,32 @@ +package render + +import ( + "strings" + + "github.com/charmbracelet/lipgloss" +) + +// --------------------------------------------------------------------------- +// Chat messages +// --------------------------------------------------------------------------- + +// renderUserMessage ports UserMessageRenderer._format_user_message. +func renderUserMessage(content string) string { + bar := Col(Blue).Render("▍") + var b strings.Builder + b.WriteString(bar + " " + lipgloss.NewStyle().Bold(true).Render("You:")) + for _, line := range strings.Split(content, "\n") { + b.WriteString("\n" + bar + " " + line) + } + return b.String() +} + +// renderChat renders a chat event (assistant markdown or user message). +func Chat(data map[string]any) string { + role, _ := data["role"].(string) + content := StripControls(StringValue(data["content"])) + if role == "user" { + return renderUserMessage(content) + } + return renderAssistantMarkdown(content) +} diff --git a/strix/interface/tui/internal/render/code.go b/strix/interface/tui/internal/render/code.go new file mode 100644 index 00000000..0e3383ec --- /dev/null +++ b/strix/interface/tui/internal/render/code.go @@ -0,0 +1,70 @@ +package render + +import ( + "path/filepath" + "strings" + + "github.com/alecthomas/chroma/v2" + "github.com/alecthomas/chroma/v2/formatters" + "github.com/alecthomas/chroma/v2/lexers" + "github.com/alecthomas/chroma/v2/styles" +) + +// HighlightCode ports the Python renderers' pygments highlighting: colorize +// code for the terminal using the "native" style, falling back to the plain +// text when the language is unknown or the highlighter fails. +func HighlightCode(code, language string) string { + if strings.TrimSpace(code) == "" { + return code + } + var lexer chroma.Lexer + if language != "" { + lexer = lexers.Get(language) + } + if lexer == nil { + lexer = lexers.Analyse(code) + } + if lexer == nil { + return Col(Text).Render(code) + } + lexer = chroma.Coalesce(lexer) + style := styles.Get("native") + formatter := formatters.Get("terminal256") + iterator, err := lexer.Tokenise(nil, code) + if err != nil { + return Col(Text).Render(code) + } + var out strings.Builder + if err := formatter.Format(&out, style, iterator); err != nil { + return Col(Text).Render(code) + } + return strings.TrimSuffix(out.String(), "\n") +} + +// languageForPath resolves a chroma language name from a file path, returning +// "" when the extension is unknown. +func languageForPath(path string) string { + if path == "" { + return "" + } + lexer := lexers.Match(filepath.Base(path)) + if lexer == nil { + return "" + } + return lexer.Config().Name +} + +// ParseFencedCode ports parse_fenced_code: strip a surrounding ``` fence and +// return the declared language (if any) and the inner code. +func ParseFencedCode(raw string) (language, code string) { + trimmed := strings.TrimSpace(raw) + if !strings.HasPrefix(trimmed, "```") { + return "", raw + } + lines := strings.Split(trimmed, "\n") + if len(lines) < 2 || strings.TrimSpace(lines[len(lines)-1]) != "```" { + return "", raw + } + language = strings.TrimSpace(strings.TrimPrefix(lines[0], "```")) + return language, strings.Join(lines[1:len(lines)-1], "\n") +} diff --git a/strix/interface/tui/internal/render/dependency.go b/strix/interface/tui/internal/render/dependency.go new file mode 100644 index 00000000..f41bddc3 --- /dev/null +++ b/strix/interface/tui/internal/render/dependency.go @@ -0,0 +1,105 @@ +package render + +import ( + "strings" + + "github.com/charmbracelet/lipgloss" +) + +func renderDependencyReport(args map[string]any, result any) string { + resultMap, _ := result.(map[string]any) + // Unsuccessful / not-persisted variants. + if resultMap != nil { + success, hasSuccess := resultMap["success"].(bool) + warning := StringValue(resultMap["warning"]) + if (hasSuccess && !success) || warning != "" { + return renderDependencyUnsuccessful(args, resultMap) + } + } + var b strings.Builder + b.WriteString("📦 " + Bold(ReportHdr).Render("Dependency (SCA) Report")) + field := func(label, value string) { + if value != "" { + b.WriteString("\n\n" + Bold(Field).Render(label+": ") + value) + } + } + title := StringValue(args["title"]) + field("Title", title) + if sev := StringValue(resultMap["severity"]); sev != "" { + b.WriteString("\n\n" + Bold(Field).Render("Severity: ") + + lipgloss.NewStyle().Bold(true).Foreground(SeverityColor(sev)).Render(strings.ToUpper(sev))) + } + if score, ok := NumericValue(args["advisory_cvss"]); ok { + b.WriteString("\n\n" + Bold(Field).Render("Advisory CVSS: ") + + lipgloss.NewStyle().Bold(true).Foreground(CVSSColor(score)).Render(StringValue(args["advisory_cvss"]))) + } + field("CVE", StringValue(args["cve"])) + field("CWE", StringValue(args["cwe"])) + if pkg := StringValue(args["package_name"]); pkg != "" { + b.WriteString("\n\n" + Bold(Field).Render("Package: ") + Bold(InfoBlue).Render(pkg)) + if eco := StringValue(args["package_ecosystem"]); eco != "" { + b.WriteString(Dim().Render(" (" + eco + ")")) + } + } + if inst := StringValue(args["installed_version"]); inst != "" { + b.WriteString("\n\n" + Bold(Field).Render("Installed: ") + Col(Red).Render(inst)) + if fixed := StringValue(args["fixed_version"]); fixed != "" { + b.WriteString(Dim().Render(" → ") + Bold(Field).Render("Fixed: ") + Col(Green).Render(fixed)) + } + } + field("Fix Effort", StringValue(args["fix_effort"])) + field("Target", StringValue(args["target"])) + section := func(label, value string) { + if value != "" { + b.WriteString("\n\n" + Bold(Field).Render(label) + "\n" + value) + } + } + section("Description", StringValue(args["description"])) + section("Impact", StringValue(args["impact"])) + section("Technical Analysis", StringValue(args["technical_analysis"])) + if reach := StringValue(args["reachability"]); reach != "" && reach != "unknown" { + b.WriteString("\n\n" + Bold(Field).Render("Usage evidence: ") + reach) + if ev := StringValue(args["reachability_evidence"]); ev != "" { + b.WriteString("\n" + ev) + } + } + section("Assumptions", StringValue(args["assumptions"])) + section("Remediation", StringValue(args["remediation_steps"])) + if title == "" { + b.WriteString("\n " + Dim().Render("Creating dependency report...")) + } + return "\n\n" + b.String() + "\n\n" +} + +func renderDependencyUnsuccessful(args, result map[string]any) string { + var b strings.Builder + b.WriteString("📦 " + Bold(ReportHdr).Render("Dependency (SCA) Report")) + if title := StringValue(args["title"]); title != "" { + b.WriteString("\n\n" + Bold(Field).Render("Title: ") + title) + } + success, hasSuccess := result["success"].(bool) + var label, detail string + var style lipgloss.Style + if hasSuccess && !success { + detail = StringValue(result["error"]) + if errs, ok := result["errors"].([]any); ok && len(errs) > 0 { + var parts []string + for _, e := range errs { + parts = append(parts, StringValue(e)) + } + detail = strings.Join(parts, "; ") + } + label, style = "✗ Not created: ", Bold(SevCrit) + if detail == "" { + detail = "Report was not created." + } + } else { + detail = StringValue(result["warning"]) + label, style = "⚠ Not persisted: ", Bold(SevMed) + if detail == "" { + detail = "Report could not be persisted." + } + } + b.WriteString("\n\n" + style.Render(label) + detail) + return "\n\n" + b.String() + "\n\n" +} diff --git a/strix/interface/tui/internal/render/file_edit.go b/strix/interface/tui/internal/render/file_edit.go new file mode 100644 index 00000000..e1c2176f --- /dev/null +++ b/strix/interface/tui/internal/render/file_edit.go @@ -0,0 +1,143 @@ +package render + +import ( + "strings" +) + +// --------------------------------------------------------------------------- +// Filesystem: apply_patch + view_image (filesystem_renderer.py) +// --------------------------------------------------------------------------- + +const ( + addFilePfx = "*** Add File: " + deleteFilePfx = "*** Delete File: " + updateFilePfx = "*** Update File: " + beginPatch = "*** Begin Patch" + endPatch = "*** End Patch" +) + +type patchOp struct { + kind string + path string + old []string + new []string +} + +func extractPatchText(args map[string]any) string { + if raw, ok := args["patch"].(string); ok { + return raw + } + if raw, ok := args["patch"].(map[string]any); ok { + if inner, ok := raw["patch"].(string); ok { + return inner + } + } + if fb, ok := args["input"].(string); ok { + return fb + } + return "" +} + +func parsePatchOperations(patch string) []patchOp { + var ops []patchOp + var cur *patchOp + flush := func() { + if cur != nil && cur.kind != "" { + ops = append(ops, *cur) + } + cur = nil + } + for _, line := range strings.Split(patch, "\n") { + switch { + case line == beginPatch || line == endPatch: + continue + case strings.HasPrefix(line, addFilePfx): + flush() + cur = &patchOp{kind: "add", path: strings.TrimSpace(line[len(addFilePfx):])} + case strings.HasPrefix(line, updateFilePfx): + flush() + cur = &patchOp{kind: "update", path: strings.TrimSpace(line[len(updateFilePfx):])} + case strings.HasPrefix(line, deleteFilePfx): + flush() + cur = &patchOp{kind: "delete", path: strings.TrimSpace(line[len(deleteFilePfx):])} + case cur != nil && cur.kind == "update": + if strings.HasPrefix(line, "@@") { + continue + } + if strings.HasPrefix(line, "-") && !strings.HasPrefix(line, "---") { + cur.old = append(cur.old, line[1:]) + } else if strings.HasPrefix(line, "+") && !strings.HasPrefix(line, "+++") { + cur.new = append(cur.new, line[1:]) + } + case cur != nil && cur.kind == "add": + if strings.HasPrefix(line, "+") { + cur.new = append(cur.new, line[1:]) + } else if strings.TrimSpace(line) != "" { + cur.new = append(cur.new, line) + } + } + } + flush() + return ops +} + +var opLabel = map[string]string{"add": "create", "update": "edit", "delete": "delete"} + +func renderPatchOperation(b *strings.Builder, op patchOp) { + label := opLabel[op.kind] + if label == "" { + label = "file" + } + b.WriteString(Col(Emerald).Render("◇ ") + Dim().Render(label)) + if op.path != "" { + p := op.path + if len(p) > 60 { + p = p[len(p)-60:] + } + b.WriteString(" " + Dim().Render(p)) + } + lang := languageForPath(op.path) + if op.kind == "update" { + for _, line := range highlightLines(op.old, lang) { + b.WriteString("\n" + Col(Red).Render("-") + " " + line) + } + for _, line := range highlightLines(op.new, lang) { + b.WriteString("\n" + Col(Green).Render("+") + " " + line) + } + } else if op.kind == "add" && len(op.new) > 0 { + b.WriteString("\n" + HighlightCode(strings.Join(op.new, "\n"), lang)) + } +} + +func highlightLines(lines []string, lang string) []string { + if len(lines) == 0 || lang == "" { + return lines + } + return strings.Split(HighlightCode(strings.Join(lines, "\n"), lang), "\n") +} + +func renderApplyPatch(args map[string]any, result any, status string) string { + ops := parsePatchOperations(extractPatchText(args)) + var b strings.Builder + if len(ops) == 0 { + b.WriteString(Col(Emerald).Render("◇ ") + Dim().Render("patch")) + if s, ok := result.(string); ok && strings.TrimSpace(s) != "" { + b.WriteString("\n " + Dim().Render(strings.TrimSpace(s))) + } else if result == nil { + b.WriteString(" " + Dim().Render("Processing...")) + } + return b.String() + } + for i, op := range ops { + if i > 0 { + b.WriteString("\n") + } + renderPatchOperation(&b, op) + } + if status == "failed" { + if s, ok := result.(string); ok && strings.TrimSpace(s) != "" { + b.WriteString("\n " + Col(Red).Render(strings.TrimSpace(s))) + } + } + return b.String() +} diff --git a/strix/interface/tui/internal/render/helpers.go b/strix/interface/tui/internal/render/helpers.go new file mode 100644 index 00000000..80c6dfa8 --- /dev/null +++ b/strix/interface/tui/internal/render/helpers.go @@ -0,0 +1,112 @@ +package render + +import ( + "encoding/json" + "fmt" + "sort" + "strings" +) + +// --------------------------------------------------------------------------- +// small helpers +// --------------------------------------------------------------------------- + +func truthy(v any) bool { + switch x := v.(type) { + case bool: + return x + case string: + return x != "" + case float64: + return x != 0 + case nil: + return false + } + return v != nil +} + +func NumericValue(v any) (float64, bool) { + switch x := v.(type) { + case float64: + return x, true + case int: + return float64(x), true + case int64: + return float64(x), true + } + return 0, false +} + +func truncStr(s string, n int) string { + if len(s) > n { + return s[:n] + } + return s +} + +func lastN(s string, n int) string { + if len(s) > n { + return s[len(s)-n:] + } + return s +} + +func firstN(s string, n int) string { + if len(s) > n { + return s[:n] + } + return s +} + +func joinTrunc(items []any, max, limit int) string { + shown := items + if len(shown) > limit { + shown = shown[:limit] + } + var parts []string + for _, it := range shown { + parts = append(parts, ptrunc(StringValue(it), max)) + } + return strings.Join(parts, ", ") +} + +// stripControlsKeepTabs drops control bytes except \t and \n (shell cleaning). +func stripControlsKeepTabs(s string) string { + return strings.Map(func(r rune) rune { + if r == '\n' || r == '\t' || r >= 32 { + return r + } + return -1 + }, s) +} + +func StringValue(value any) string { + if value == nil { + return "" + } + if text, ok := value.(string); ok { + return text + } + raw, err := json.Marshal(value) + if err == nil { + return string(raw) + } + return fmt.Sprint(value) +} +func StripControls(value string) string { + return strings.Map(func(r rune) rune { + if r == '\n' || r == '\t' || r >= 32 { + return r + } + return -1 + }, value) +} + +func SortedKeys(values map[string]any) []string { + keys := make([]string, 0, len(values)) + for key := range values { + keys = append(keys, key) + } + sort.Strings(keys) + return keys +} diff --git a/strix/interface/tui/internal/render/image.go b/strix/interface/tui/internal/render/image.go new file mode 100644 index 00000000..9e6f118e --- /dev/null +++ b/strix/interface/tui/internal/render/image.go @@ -0,0 +1,106 @@ +package render + +import ( + "strings" +) + +func renderViewImage(args map[string]any, result any) string { + path := strings.TrimSpace(StringValue(args["path"])) + var b strings.Builder + b.WriteString(Col(Emerald).Render("◇ ") + Dim().Render("view image")) + if path != "" { + if len(path) > 60 { + path = path[len(path)-60:] + } + b.WriteString(" " + Dim().Render(path)) + } + if s, ok := result.(string); ok { + low := strings.ToLower(strings.TrimSpace(s)) + if strings.HasPrefix(low, "image path ") || strings.HasPrefix(low, "unable to read image") || + strings.HasPrefix(low, "manifest path") || strings.HasPrefix(low, "exceeded the allowed size") || + strings.Contains(low, "not a supported image") { + b.WriteString("\n " + Col(Red).Render(strings.TrimSpace(s))) + return b.String() + } + } + if isImageSuccess(result) { + b.WriteString(" " + Col(Green).Render("✓")) + if KittyGraphicsSupported() { + if mime, payload := extractImageDataURI(result); mime != "" { + if block := kittyImageBlock(mime, payload); block != "" { + b.WriteString("\n" + block) + } + } + } + } + return b.String() +} + +var imageMimes = []string{"png", "jpeg", "jpg", "gif", "webp"} + +func isBase64Byte(b byte) bool { + return b >= 'A' && b <= 'Z' || b >= 'a' && b <= 'z' || b >= '0' && b <= '9' || + b == '+' || b == '/' || b == '=' +} + +// parseImageDataURI scans a data URI without a regexp: payloads run to +// megabytes and the regexp engine is far too slow to walk them per frame. +func parseImageDataURI(s string) (mime, payload string) { + start := strings.Index(s, "data:image/") + if start < 0 { + return "", "" + } + rest := s[start+len("data:image/"):] + for _, candidate := range imageMimes { + if !strings.HasPrefix(rest, candidate+";base64,") { + continue + } + data := rest[len(candidate)+len(";base64,"):] + end := len(data) + for i := range len(data) { + if !isBase64Byte(data[i]) { + end = i + break + } + } + if candidate == "jpg" { + candidate = "jpeg" + } + return candidate, data[:end] + } + return "", "" +} + +// extractImageDataURI pulls a base64 image payload out of a view_image tool +// result: a raw data URI or a structured map with an image_url/url field. +func extractImageDataURI(result any) (mime, payload string) { + var s string + switch v := result.(type) { + case string: + s = v + case map[string]any: + if u := StringValue(v["image_url"]); u != "" { + s = u + } else if u := StringValue(v["url"]); u != "" { + s = u + } + } + if s == "" { + return "", "" + } + mime, payload = parseImageDataURI(s) + if mime == "" || len(payload) < 100 || len(payload)%4 != 0 { + return "", "" + } + return mime, payload +} + +func isImageSuccess(result any) bool { + if m, ok := result.(map[string]any); ok { + return StringValue(m["type"]) == "image" + } + if s, ok := result.(string); ok { + return strings.HasPrefix(strings.TrimLeft(s, " \t\n"), "data:image/") + } + return false +} diff --git a/strix/interface/tui/internal/render/image_detect.go b/strix/interface/tui/internal/render/image_detect.go new file mode 100644 index 00000000..d1905208 --- /dev/null +++ b/strix/interface/tui/internal/render/image_detect.go @@ -0,0 +1,139 @@ +package render + +import ( + "bytes" + "os" + "time" + + "github.com/charmbracelet/x/term" +) + +// queryBudget bounds the whole capability exchange. A terminal answers in +// microseconds; anything this slow is not going to answer at all. +const queryBudget = 500 * time.Millisecond + +// drainBudget is the grace period spent collecting whatever else the terminal +// sent after the answer we were looking for. +const drainBudget = 50 * time.Millisecond + +// etx is what ctrl-c delivers while ISIG is cleared. +const etx = 0x03 + +// DetectKittyGraphics asks the terminal whether it supports the kitty +// graphics protocol, the way kitty's own tooling does: send a 1x1 query +// (a=q) followed by a Primary Device Attributes request, then read until the +// DA1 response arrives. A graphics-capable terminal answers the query with an +// APC "OK" response before the DA1; anything else ignores it. Must run before +// Bubble Tea takes over stdin. +func DetectKittyGraphics() { + supported, interrupted := queryKittyGraphics(os.Stdin, os.Stdout) + KittyGraphicsSupported = func() bool { return supported } + if interrupted { + // The query runs with ISIG cleared, so ctrl-c arrives as a byte instead + // of a signal. Raise it now that the terminal is restored, so a ctrl-c + // during startup quits rather than being swallowed. + interruptSelf() + } +} + +func queryKittyGraphics(in, out *os.File) (supported, interrupted bool) { + fd := int(in.Fd()) + if !term.IsTerminal(uintptr(fd)) { + return false, false + } + oldState, err := term.MakeRaw(uintptr(fd)) + if err != nil { + return false, false + } + // Everything the terminal sends must be consumed before the terminal echoes + // it: once cooked mode is back, a reply still in flight is printed to the + // screen as mojibake like "^[[?62;52;c". + defer term.Restore(uintptr(fd), oldState) //nolint:errcheck + + // The same 1x1 RGB query used by viuer and yazi; DA1 (CSI c) is answered + // by every terminal and bounds the read. + if _, err := out.WriteString("\x1b_Gi=31,s=1,v=1,a=q,t=d,f=24;AAAA\x1b\\\x1b[c"); err != nil { + return false, false + } + + reply := readCapabilityReply(in, queryBudget) + if reply.answered { + // The kitty answer arrives before the DA1, so the DA1 is still on its + // way. Take it now rather than leaving it for the shell to echo. + drainInput(in, drainBudget) + } + return reply.supported, reply.interrupted +} + +// capabilityReply is what the terminal told us: whether it supports the +// protocol, whether it answered at all, and whether the user pressed ctrl-c +// while we were waiting. +type capabilityReply struct { + supported bool + answered bool + interrupted bool +} + +// readCapabilityReply reads until the kitty answer or the DA1 that follows it, +// whichever comes first. +func readCapabilityReply(in *os.File, budget time.Duration) capabilityReply { + deadline := time.Now().Add(budget) + var buf bytes.Buffer + chunk := make([]byte, 256) + for { + remaining := time.Until(deadline) + if remaining <= 0 { + return capabilityReply{} + } + // The read itself has to be bounded. os.File deadlines do not work on a + // terminal - the fd is blocking, so it is never registered with the + // runtime poller and SetReadDeadline fails with "file type does not + // support deadline" - which would leave this read hanging until the + // terminal happened to send something. + ready, err := waitReadable(in, remaining) + if err != nil || !ready { + return capabilityReply{} + } + n, err := in.Read(chunk) + if n > 0 { + buf.Write(chunk[:n]) + // ctrl-c is ETX here rather than a signal. Stop waiting on the + // terminal the moment the user asks to leave. + if bytes.IndexByte(buf.Bytes(), etx) >= 0 { + return capabilityReply{interrupted: true} + } + if apc := bytes.Index(buf.Bytes(), []byte("\x1b_G")); apc >= 0 && + bytes.Contains(buf.Bytes()[apc:], []byte(";OK")) { + return capabilityReply{supported: true, answered: true} + } + // DA1 response: ESC [ ? ... c + if idx := bytes.Index(buf.Bytes(), []byte("\x1b[?")); idx >= 0 && + bytes.IndexByte(buf.Bytes()[idx:], 'c') >= 0 { + return capabilityReply{answered: true} + } + } + if err != nil { + return capabilityReply{} + } + } +} + +// drainInput consumes whatever is already readable, so no part of the terminal's +// answer survives into cooked mode. +func drainInput(in *os.File, budget time.Duration) { + deadline := time.Now().Add(budget) + chunk := make([]byte, 256) + for { + remaining := time.Until(deadline) + if remaining <= 0 { + return + } + ready, err := waitReadable(in, remaining) + if err != nil || !ready { + return + } + if _, err := in.Read(chunk); err != nil { + return + } + } +} diff --git a/strix/interface/tui/internal/render/image_detect_test.go b/strix/interface/tui/internal/render/image_detect_test.go new file mode 100644 index 00000000..41bde37e --- /dev/null +++ b/strix/interface/tui/internal/render/image_detect_test.go @@ -0,0 +1,133 @@ +//go:build !windows + +package render + +import ( + "os" + "testing" + "time" +) + +// A terminal that ignores the query must not stall startup. This is the bound +// that os.File read deadlines could not provide: a tty descriptor is blocking, +// so it is never registered with the runtime poller and SetReadDeadline fails +// with "file type does not support deadline", leaving the read to hang until the +// terminal happened to send something. +func TestCapabilityReadGivesUpOnASilentTerminal(t *testing.T) { + reader, writer := pipePair(t) + defer writer.Close() + + start := time.Now() + reply := readCapabilityReply(reader, 150*time.Millisecond) + + if reply.supported || reply.answered { + t.Fatalf("silence reported an answer: %+v", reply) + } + if elapsed := time.Since(start); elapsed > 3*time.Second { + t.Fatalf("the read was not bounded: %s", elapsed) + } +} + +func TestCapabilityReadClassifiesTheReply(t *testing.T) { + for _, testCase := range []struct { + name string + reply string + want bool + }{ + {"DA1 alone means no kitty support", "\x1b[?62;52;c", false}, + {"a kitty answer means support", "\x1b_Gi=31;OK\x1b\\\x1b[?62;52;c", true}, + } { + t.Run(testCase.name, func(t *testing.T) { + reader, writer := pipePair(t) + defer writer.Close() + if _, err := writer.WriteString(testCase.reply); err != nil { + t.Fatalf("write reply: %v", err) + } + + reply := readCapabilityReply(reader, time.Second) + + if !reply.answered { + t.Fatal("a reply was sent but not seen") + } + if reply.supported != testCase.want { + t.Fatalf("support = %v, want %v", reply.supported, testCase.want) + } + }) + } +} + +// The DA1 trails a kitty answer, so it is still arriving when the answer is +// recognized. Anything left unread is echoed to the screen once cooked mode +// returns, which is where "^[[?62;52;c" came from. +func TestDrainClearsWhatFollowsTheAnswer(t *testing.T) { + reader, writer := pipePair(t) + defer writer.Close() + if _, err := writer.WriteString("\x1b_Gi=31;OK\x1b\\\x1b[?62;52;c"); err != nil { + t.Fatalf("write reply: %v", err) + } + + reply := readCapabilityReply(reader, time.Second) + if !reply.supported || !reply.answered { + t.Fatalf("kitty answer not recognized: %+v", reply) + } + drainInput(reader, drainBudget) + + leftover, err := waitReadable(reader, 100*time.Millisecond) + if err != nil { + t.Fatalf("leftover check failed: %v", err) + } + if leftover { + t.Fatal("part of the reply survived the drain and would be echoed") + } +} + +// The query clears ISIG, so ctrl-c arrives as ETX rather than a signal. It has to +// end the wait instead of being swallowed as terminal noise, which is what left a +// hung startup unresponsive to ctrl-c. +func TestCtrlCEndsTheWait(t *testing.T) { + reader, writer := pipePair(t) + defer writer.Close() + if _, err := writer.Write([]byte{etx}); err != nil { + t.Fatalf("write ctrl-c: %v", err) + } + + start := time.Now() + reply := readCapabilityReply(reader, 10*time.Second) + + if !reply.interrupted { + t.Fatalf("ctrl-c was not recognized: %+v", reply) + } + if reply.answered || reply.supported { + t.Fatalf("ctrl-c must not be read as a terminal answer: %+v", reply) + } + if elapsed := time.Since(start); elapsed > 2*time.Second { + t.Fatalf("ctrl-c did not end the wait promptly: %s", elapsed) + } +} + +// waitReadable must report readiness without waiting out the whole timeout. +func TestWaitReadableSeesAvailableInput(t *testing.T) { + reader, writer := pipePair(t) + defer writer.Close() + if _, err := writer.WriteString("x"); err != nil { + t.Fatalf("write: %v", err) + } + + ready, err := waitReadable(reader, time.Second) + if err != nil { + t.Fatalf("waitReadable failed: %v", err) + } + if !ready { + t.Fatal("input was available but waitReadable reported none") + } +} + +func pipePair(t *testing.T) (reader, writer *os.File) { + t.Helper() + reader, writer, err := os.Pipe() + if err != nil { + t.Fatalf("pipe: %v", err) + } + t.Cleanup(func() { reader.Close() }) + return reader, writer +} diff --git a/strix/interface/tui/internal/render/image_detect_unix.go b/strix/interface/tui/internal/render/image_detect_unix.go new file mode 100644 index 00000000..87b0b81a --- /dev/null +++ b/strix/interface/tui/internal/render/image_detect_unix.go @@ -0,0 +1,37 @@ +//go:build !windows + +package render + +import ( + "os" + "time" + + "golang.org/x/sys/unix" +) + +// waitReadable reports whether the descriptor has input available within the +// timeout. poll(2) works on a blocking terminal descriptor, which is what a tty +// is and why os.File read deadlines cannot be used here. +func waitReadable(in *os.File, timeout time.Duration) (bool, error) { + fds := []unix.PollFd{{Fd: int32(in.Fd()), Events: unix.POLLIN}} + milliseconds := int(timeout.Milliseconds()) + if milliseconds <= 0 { + milliseconds = 1 + } + for { + n, err := unix.Poll(fds, milliseconds) + if err == unix.EINTR { + continue + } + if err != nil { + return false, err + } + return n > 0, nil + } +} + +// interruptSelf raises the interrupt the terminal could not deliver while the +// capability query held the terminal with signals disabled. +func interruptSelf() { + _ = unix.Kill(os.Getpid(), unix.SIGINT) +} diff --git a/strix/interface/tui/internal/render/image_detect_windows.go b/strix/interface/tui/internal/render/image_detect_windows.go new file mode 100644 index 00000000..7825f609 --- /dev/null +++ b/strix/interface/tui/internal/render/image_detect_windows.go @@ -0,0 +1,19 @@ +//go:build windows + +package render + +import ( + "os" + "time" +) + +// waitReadable has no console equivalent worth carrying: no Windows terminal +// implements the kitty graphics protocol, so detection reports no support rather +// than blocking on a reply that never comes. +func waitReadable(_ *os.File, _ time.Duration) (bool, error) { + return false, nil +} + +// interruptSelf has nothing to do: detection never reads on this platform, so +// ctrl-c is never withheld from the console. +func interruptSelf() {} diff --git a/strix/interface/tui/internal/render/image_kitty.go b/strix/interface/tui/internal/render/image_kitty.go new file mode 100644 index 00000000..1eeb006e --- /dev/null +++ b/strix/interface/tui/internal/render/image_kitty.go @@ -0,0 +1,202 @@ +package render + +import ( + "bytes" + "encoding/base64" + "fmt" + "image" + _ "image/gif" + _ "image/jpeg" + "image/png" + "strings" + "sync" +) + +// Native inline images via the kitty graphics protocol with Unicode +// placeholders (https://sw.kovidgoyal.net/kitty/graphics-protocol/): the image +// is transmitted once out of band with a virtual placement, and the chat trace +// renders placeholder cells that the terminal replaces with real pixels. The +// placeholder rows are plain styled text, so they scroll and diff like any +// other Bubble Tea content. Terminals without the protocol show no preview. + +const ( + imageMinCols = 20 + imageMaxCols = 100 + imageDefaultCols = 72 + imageMaxRows = 28 + kittyChunkSize = 4096 +) + +var imageCols = imageDefaultCols + +// SetImageWidth sizes inline image placements to the chat content width in cells. +func SetImageWidth(cells int) { + imageCols = min(max(cells, imageMinCols), imageMaxCols) +} + +// KittyGraphicsSupported reports whether the terminal supports the kitty +// graphics protocol; set at startup by DetectKittyGraphics via a live +// terminal query. +var KittyGraphicsSupported = func() bool { return false } + +type kittyPlacement struct { + id uint32 + cols int + rows int + placeholder string +} + +var ( + kittyMu sync.Mutex + kittyByHash = map[string]kittyPlacement{} + kittyQueue []string + kittyNextID uint32 = 1 +) + +// DrainImageTransmissions returns queued kitty transmit/placement sequences, +// to be written directly to the terminal exactly once per image. +func DrainImageTransmissions() []string { + kittyMu.Lock() + defer kittyMu.Unlock() + out := kittyQueue + kittyQueue = nil + return out +} + +// payloadKey identifies an image payload without hashing megabytes of base64 +// on every frame: its length plus both ends are enough to tell distinct +// images apart. +func payloadKey(payload string) string { + const edge = 64 + if len(payload) <= 2*edge { + return payload + } + return fmt.Sprintf("%d:%s:%s", len(payload), payload[:edge], payload[len(payload)-edge:]) +} + +// kittyImageBlock registers the image payload (queueing its transmission on +// first sight) and returns the styled placeholder block for the chat trace. +func kittyImageBlock(mime, payload string) string { + kittyMu.Lock() + defer kittyMu.Unlock() + key := payloadKey(payload) + placement, ok := kittyByHash[key] + if !ok { + pngData, w, h := payloadToPNG(mime, payload) + if pngData == nil { + return "" + } + cols := min(imageCols, w) + rows := (h*cols + w - 1) / (w * 2) + rows = min(max(1, rows), imageMaxRows) + placement = kittyPlacement{id: kittyNextID, cols: cols, rows: rows} + placement.placeholder = kittyPlaceholder(placement) + kittyNextID++ + kittyByHash[key] = placement + kittyQueue = append(kittyQueue, kittyTransmit(placement, pngData)) + } + return placement.placeholder +} + +func payloadToPNG(mime, payload string) (data []byte, w, h int) { + raw, err := base64.StdEncoding.DecodeString(payload) + if err != nil { + return nil, 0, 0 + } + img, _, err := image.Decode(bytes.NewReader(raw)) + if err != nil { + return nil, 0, 0 + } + bounds := img.Bounds() + if bounds.Dx() <= 0 || bounds.Dy() <= 0 { + return nil, 0, 0 + } + if mime == "png" { + return raw, bounds.Dx(), bounds.Dy() + } + var buf bytes.Buffer + if err := png.Encode(&buf, img); err != nil { + return nil, 0, 0 + } + return buf.Bytes(), bounds.Dx(), bounds.Dy() +} + +// kittyTransmit builds the chunked APC sequences transmitting the PNG and +// creating a virtual (U=1) placement for Unicode placeholders. +func kittyTransmit(p kittyPlacement, pngData []byte) string { + encoded := base64.StdEncoding.EncodeToString(pngData) + var b strings.Builder + first := true + for len(encoded) > 0 { + chunk := encoded + if len(chunk) > kittyChunkSize { + chunk = chunk[:kittyChunkSize] + } + encoded = encoded[len(chunk):] + more := 0 + if len(encoded) > 0 { + more = 1 + } + if first { + fmt.Fprintf(&b, "\x1b_Ga=t,q=2,f=100,i=%d,m=%d;%s\x1b\\", p.id, more, chunk) + first = false + } else { + fmt.Fprintf(&b, "\x1b_Gm=%d;%s\x1b\\", more, chunk) + } + } + fmt.Fprintf(&b, "\x1b_Ga=p,q=2,U=1,i=%d,c=%d,r=%d\x1b\\", p.id, p.cols, p.rows) + return b.String() +} + +// kittyPlaceholder renders the rows x cols grid of U+10EEEE placeholder cells +// carrying the image id in the foreground color and the cell position in +// row/column diacritics. The id must reach the terminal as an exact truecolor +// value, so the SGR sequence is emitted directly rather than through lipgloss +// (whose profile detection may downsample it). +func kittyPlaceholder(p kittyPlacement) string { + id := p.id & 0xffffff + var b strings.Builder + for row := range p.rows { + if row > 0 { + b.WriteString("\n") + } + fmt.Fprintf(&b, "\x1b[38;2;%d;%d;%dm", id>>16&0xff, id>>8&0xff, id&0xff) + for col := range p.cols { + b.WriteRune(0x10eeee) + b.WriteRune(rowColumnDiacritics[row]) + b.WriteRune(rowColumnDiacritics[col]) + } + b.WriteString("\x1b[39m") + } + return b.String() +} + +// rowColumnDiacritics is kitty's canonical placeholder diacritic table +// (gen/rowcolumn-diacritics.txt); index n encodes row/column number n. +var rowColumnDiacritics = []rune{ + 0x0305, 0x030D, 0x030E, 0x0310, 0x0312, 0x033D, 0x033E, 0x033F, 0x0346, 0x034A, 0x034B, 0x034C, + 0x0350, 0x0351, 0x0352, 0x0357, 0x035B, 0x0363, 0x0364, 0x0365, 0x0366, 0x0367, 0x0368, 0x0369, + 0x036A, 0x036B, 0x036C, 0x036D, 0x036E, 0x036F, 0x0483, 0x0484, 0x0485, 0x0486, 0x0487, 0x0592, + 0x0593, 0x0594, 0x0595, 0x0597, 0x0598, 0x0599, 0x059C, 0x059D, 0x059E, 0x059F, 0x05A0, 0x05A1, + 0x05A8, 0x05A9, 0x05AB, 0x05AC, 0x05AF, 0x05C4, 0x0610, 0x0611, 0x0612, 0x0613, 0x0614, 0x0615, + 0x0616, 0x0617, 0x0657, 0x0658, 0x0659, 0x065A, 0x065B, 0x065D, 0x065E, 0x06D6, 0x06D7, 0x06D8, + 0x06D9, 0x06DA, 0x06DB, 0x06DC, 0x06DF, 0x06E0, 0x06E1, 0x06E2, 0x06E4, 0x06E7, 0x06E8, 0x06EB, + 0x06EC, 0x0730, 0x0732, 0x0733, 0x0735, 0x0736, 0x073A, 0x073D, 0x073F, 0x0740, 0x0741, 0x0743, + 0x0745, 0x0747, 0x0749, 0x074A, 0x07EB, 0x07EC, 0x07ED, 0x07EE, 0x07EF, 0x07F0, 0x07F1, 0x07F3, + 0x0816, 0x0817, 0x0818, 0x0819, 0x081B, 0x081C, 0x081D, 0x081E, 0x081F, 0x0820, 0x0821, 0x0822, + 0x0823, 0x0825, 0x0826, 0x0827, 0x0829, 0x082A, 0x082B, 0x082C, 0x082D, 0x0951, 0x0953, 0x0954, + 0x0F82, 0x0F83, 0x0F86, 0x0F87, 0x135D, 0x135E, 0x135F, 0x17DD, 0x193A, 0x1A17, 0x1A75, 0x1A76, + 0x1A77, 0x1A78, 0x1A79, 0x1A7A, 0x1A7B, 0x1A7C, 0x1B6B, 0x1B6D, 0x1B6E, 0x1B6F, 0x1B70, 0x1B71, + 0x1B72, 0x1B73, 0x1CD0, 0x1CD1, 0x1CD2, 0x1CDA, 0x1CDB, 0x1CE0, 0x1DC0, 0x1DC1, 0x1DC3, 0x1DC4, + 0x1DC5, 0x1DC6, 0x1DC7, 0x1DC8, 0x1DC9, 0x1DCB, 0x1DCC, 0x1DD1, 0x1DD2, 0x1DD3, 0x1DD4, 0x1DD5, + 0x1DD6, 0x1DD7, 0x1DD8, 0x1DD9, 0x1DDA, 0x1DDB, 0x1DDC, 0x1DDD, 0x1DDE, 0x1DDF, 0x1DE0, 0x1DE1, + 0x1DE2, 0x1DE3, 0x1DE4, 0x1DE5, 0x1DE6, 0x1DFE, 0x20D0, 0x20D1, 0x20D4, 0x20D5, 0x20D6, 0x20D7, + 0x20DB, 0x20DC, 0x20E1, 0x20E7, 0x20E9, 0x20F0, 0x2CEF, 0x2CF0, 0x2CF1, 0x2DE0, 0x2DE1, 0x2DE2, + 0x2DE3, 0x2DE4, 0x2DE5, 0x2DE6, 0x2DE7, 0x2DE8, 0x2DE9, 0x2DEA, 0x2DEB, 0x2DEC, 0x2DED, 0x2DEE, + 0x2DEF, 0x2DF0, 0x2DF1, 0x2DF2, 0x2DF3, 0x2DF4, 0x2DF5, 0x2DF6, 0x2DF7, 0x2DF8, 0x2DF9, 0x2DFA, + 0x2DFB, 0x2DFC, 0x2DFD, 0x2DFE, 0x2DFF, 0xA66F, 0xA67C, 0xA67D, 0xA6F0, 0xA6F1, 0xA8E0, 0xA8E1, + 0xA8E2, 0xA8E3, 0xA8E4, 0xA8E5, 0xA8E6, 0xA8E7, 0xA8E8, 0xA8E9, 0xA8EA, 0xA8EB, 0xA8EC, 0xA8ED, + 0xA8EE, 0xA8EF, 0xA8F0, 0xA8F1, 0xAAB0, 0xAAB2, 0xAAB3, 0xAAB7, 0xAAB8, 0xAABE, 0xAABF, 0xAAC1, + 0xFE20, 0xFE21, 0xFE22, 0xFE23, 0xFE24, 0xFE25, 0xFE26, 0x10A0F, 0x10A38, 0x1D185, 0x1D186, + 0x1D187, 0x1D188, 0x1D189, 0x1D1AA, 0x1D1AB, 0x1D1AC, 0x1D1AD, 0x1D242, 0x1D243, 0x1D244, +} diff --git a/strix/interface/tui/internal/render/image_kitty_test.go b/strix/interface/tui/internal/render/image_kitty_test.go new file mode 100644 index 00000000..0f838e59 --- /dev/null +++ b/strix/interface/tui/internal/render/image_kitty_test.go @@ -0,0 +1,103 @@ +package render + +import ( + "bytes" + "encoding/base64" + "image" + "image/color" + "image/png" + "strings" + "testing" +) + +func testImageDataURI(t *testing.T, w, h int) string { + t.Helper() + img := image.NewRGBA(image.Rect(0, 0, w, h)) + for y := range h { + for x := range w { + img.Set(x, y, color.RGBA{R: uint8(255 * x / w), G: uint8(255 * y / h), B: 128, A: 255}) + } + } + var buf bytes.Buffer + if err := png.Encode(&buf, img); err != nil { + t.Fatal(err) + } + return "data:image/png;base64," + base64.StdEncoding.EncodeToString(buf.Bytes()) +} + +func withKittySupport(t *testing.T, supported bool) { + t.Helper() + previous := KittyGraphicsSupported + KittyGraphicsSupported = func() bool { return supported } + t.Cleanup(func() { KittyGraphicsSupported = previous }) +} + +func TestViewImageRendersKittyPlaceholders(t *testing.T) { + withKittySupport(t, true) + uri := testImageDataURI(t, 120, 80) + out := Tool(tool("view_image", map[string]any{"path": "/tmp/shot.png"}, uri, "completed")) + if !strings.ContainsRune(out, 0x10eeee) { + t.Fatalf("expected kitty placeholder cells in render:\n%s", out) + } + + transmissions := DrainImageTransmissions() + if len(transmissions) != 1 { + t.Fatalf("expected one queued transmission, got %d", len(transmissions)) + } + seq := transmissions[0] + if !strings.Contains(seq, "\x1b_Ga=t,q=2,f=100,") { + t.Fatalf("missing transmit sequence: %.80s", seq) + } + if !strings.Contains(seq, "a=p,q=2,U=1,") { + t.Fatalf("missing virtual placement: %.80s", seq) + } + + // Re-rendering the same image must not queue a second transmission. + Tool(tool("view_image", map[string]any{"path": "/tmp/shot.png"}, uri, "completed")) + if again := DrainImageTransmissions(); len(again) != 0 { + t.Fatalf("image retransmitted: %d", len(again)) + } +} + +func TestViewImageWithoutKittySupportShowsNoPreview(t *testing.T) { + withKittySupport(t, false) + uri := testImageDataURI(t, 60, 40) + out := Tool(tool("view_image", map[string]any{"path": "/tmp/shot.png"}, uri, "completed")) + if !strings.Contains(out, "✓") { + t.Fatalf("expected success check:\n%s", out) + } + if strings.ContainsRune(out, 0x10eeee) { + t.Fatal("placeholder cells must not render without kitty graphics support") + } + if len(DrainImageTransmissions()) != 0 { + t.Fatal("no transmissions expected without kitty graphics support") + } +} + +func TestExtractImageDataURI(t *testing.T) { + uri := testImageDataURI(t, 8, 8) + if mime, payload := extractImageDataURI(uri); mime != "png" || payload == "" { + t.Fatal("raw data URI should extract") + } + if mime, _ := extractImageDataURI(map[string]any{"image_url": uri}); mime != "png" { + t.Fatal("structured result should extract") + } + if mime, _ := extractImageDataURI("data:image/png;base64,short"); mime != "" { + t.Fatal("tiny payload must be rejected") + } +} + +func TestKittyPlaceholderGrid(t *testing.T) { + p := kittyPlacement{id: 3, cols: 4, rows: 2} + out := kittyPlaceholder(p) + lines := strings.Split(out, "\n") + if len(lines) != 2 { + t.Fatalf("expected 2 rows, got %d", len(lines)) + } + if got := strings.Count(out, string(rune(0x10eeee))); got != 8 { + t.Fatalf("expected 8 placeholder cells, got %d", got) + } + if !strings.Contains(out, "\x1b[38;2;0;0;3m") { + t.Fatalf("placeholder must carry the image id in the foreground color:\n%q", out) + } +} diff --git a/strix/interface/tui/internal/render/markdown_test.go b/strix/interface/tui/internal/render/markdown_test.go new file mode 100644 index 00000000..cd701e26 --- /dev/null +++ b/strix/interface/tui/internal/render/markdown_test.go @@ -0,0 +1,103 @@ +package render + +import ( + "strings" + "testing" + + "github.com/charmbracelet/x/ansi" +) + +func TestHighlightCodeColorsKnownLanguage(t *testing.T) { + out := HighlightCode("def main():\n return 1", "python") + if !strings.Contains(out, "\x1b[") { + t.Fatal("python code was not colorized") + } + if ansi.Strip(out) != "def main():\n return 1" { + t.Fatalf("highlighting changed the code text: %q", ansi.Strip(out)) + } +} + +func TestMarkdownCodeFenceIsHighlighted(t *testing.T) { + out := renderAssistantMarkdown("intro\n```python\nimport os\n```\ndone") + plain := ansi.Strip(out) + if !strings.Contains(plain, "import os") { + t.Fatalf("code fence content missing: %q", plain) + } + if strings.Contains(plain, "```") { + t.Fatalf("fence markers leaked into output: %q", plain) + } +} + +func TestParseFencedCode(t *testing.T) { + lang, code := ParseFencedCode("```python\nprint(1)\n```") + if lang != "python" || code != "print(1)" { + t.Fatalf("got lang=%q code=%q", lang, code) + } + lang, code = ParseFencedCode("plain text") + if lang != "" || code != "plain text" { + t.Fatalf("unfenced text mangled: lang=%q code=%q", lang, code) + } +} + +func TestMarkdownTableIsAligned(t *testing.T) { + out := renderAssistantMarkdown(strings.Join([]string{ + "| Name | Severity |", + "| --- | --- |", + "| SQLi | **high** |", + "| XSS | low |", + }, "\n")) + plain := ansi.Strip(out) + lines := strings.Split(plain, "\n") + if len(lines) != 4 { + t.Fatalf("expected 4 table rows, got %d: %q", len(lines), plain) + } + if !strings.Contains(lines[0], "Name") || !strings.Contains(lines[0], "│") { + t.Fatalf("header row not formatted: %q", lines[0]) + } + if !strings.Contains(lines[1], "─┼─") { + t.Fatalf("separator rule missing: %q", lines[1]) + } + if !strings.Contains(lines[2], "high") || strings.Contains(lines[2], "**") { + t.Fatalf("body cell not inline-formatted: %q", lines[2]) + } + if strings.Index(lines[2], "│") != strings.Index(lines[3], "│") { + t.Fatalf("columns misaligned:\n%q\n%q", lines[2], lines[3]) + } +} + +func TestNonTablePipeLinesAreLeftAlone(t *testing.T) { + out := renderAssistantMarkdown("a | b\nplain line") + if !strings.Contains(ansi.Strip(out), "a | b") { + t.Fatalf("pipe text mangled: %q", ansi.Strip(out)) + } +} + +func TestInlineFormatKeepsNonEmphasisMarkers(t *testing.T) { + literal := []string{ + "ls *.py *.go", + "snake_case_name and other_var_here", + "a * b * c", + "call obj.__init__ now", + "rm -rf /tmp/* /var/*", + "5 * 3 = 15", + } + for _, line := range literal { + if got := ansi.Strip(inlineFormat(line)); got != line { + t.Fatalf("%q was treated as emphasis: %q", line, got) + } + } +} + +func TestInlineFormatStillStylesRealEmphasis(t *testing.T) { + cases := map[string]string{ + "this is *italic* text": "this is italic text", + "this is **bold** text": "this is bold text", + "gone ~~away~~ now": "gone away now", + "use `code` here": "use code here", + } + for line, want := range cases { + if got := ansi.Strip(inlineFormat(line)); got != want { + t.Fatalf("%q: got %q want %q", line, got, want) + } + } +} diff --git a/strix/interface/tui/internal/render/notes.go b/strix/interface/tui/internal/render/notes.go new file mode 100644 index 00000000..6c81492e --- /dev/null +++ b/strix/interface/tui/internal/render/notes.go @@ -0,0 +1,111 @@ +package render + +import ( + "strings" +) + +// --------------------------------------------------------------------------- +// Notes (notes_renderer.py) +// --------------------------------------------------------------------------- + +func renderNote(name string, args map[string]any, result any) string { + var b strings.Builder + icon := Col(Gold).Render("◇ ") + switch name { + case "create_note": + category := StringValue(args["category"]) + if category == "" { + category = "general" + } + title, content := strings.TrimSpace(StringValue(args["title"])), strings.TrimSpace(StringValue(args["content"])) + b.WriteString(icon + Dim().Render("note") + " " + Dim().Render("("+category+")")) + if title != "" { + b.WriteString("\n " + title) + } + if content != "" { + b.WriteString("\n " + Dim().Render(content)) + } + if title == "" && content == "" { + b.WriteString("\n " + Dim().Render("Capturing...")) + } + case "delete_note": + b.WriteString(icon + Dim().Render("note removed")) + case "update_note": + title, content := StringValue(args["title"]), strings.TrimSpace(StringValue(args["content"])) + b.WriteString(icon + Dim().Render("note updated")) + if title != "" { + b.WriteString("\n " + title) + } + if content != "" { + b.WriteString("\n " + Dim().Render(content)) + } + if title == "" && content == "" { + b.WriteString("\n " + Dim().Render("Updating...")) + } + case "list_notes": + b.WriteString(icon + Dim().Render("notes")) + b.WriteString(noteListBody(result)) + case "get_note": + b.WriteString(icon + Dim().Render("note read")) + if m, ok := result.(map[string]any); ok && truthy(m["success"]) { + note, _ := m["note"].(map[string]any) + renderSingleNote(&b, note) + } else { + b.WriteString("\n " + Dim().Render("Loading...")) + } + default: + b.WriteString(icon + Dim().Render(strings.ReplaceAll(name, "_", " "))) + } + return b.String() +} + +func noteListBody(result any) string { + var b strings.Builder + if s, ok := result.(string); ok && strings.TrimSpace(s) != "" { + return "\n " + Dim().Render(strings.TrimSpace(s)) + } + m, ok := result.(map[string]any) + if !ok || !truthy(m["success"]) { + return "\n " + Dim().Render("Loading...") + } + notes, _ := m["notes"].([]any) + count, _ := NumericValue(m["total_count"]) + if int(count) == 0 || len(notes) == 0 { + return "\n " + Dim().Render("No notes") + } + for _, n := range notes { + note, _ := n.(map[string]any) + title := strings.TrimSpace(StringValue(note["title"])) + if title == "" { + title = "(untitled)" + } + category := StringValue(note["category"]) + if category == "" { + category = "general" + } + content := strings.TrimSpace(StringValue(note["content"])) + if content == "" { + content = strings.TrimSpace(StringValue(note["content_preview"])) + } + b.WriteString("\n - " + title + Dim().Render(" ("+category+")")) + if content != "" { + b.WriteString("\n " + Dim().Render(content)) + } + } + return b.String() +} + +func renderSingleNote(b *strings.Builder, note map[string]any) { + title := strings.TrimSpace(StringValue(note["title"])) + if title == "" { + title = "(untitled)" + } + category := StringValue(note["category"]) + if category == "" { + category = "general" + } + b.WriteString("\n " + title + Dim().Render(" ("+category+")")) + if content := strings.TrimSpace(StringValue(note["content"])); content != "" { + b.WriteString("\n " + Dim().Render(content)) + } +} diff --git a/strix/interface/tui/internal/render/proxy.go b/strix/interface/tui/internal/render/proxy.go new file mode 100644 index 00000000..a8f9fb75 --- /dev/null +++ b/strix/interface/tui/internal/render/proxy.go @@ -0,0 +1,577 @@ +package render + +import ( + "fmt" + "strings" + + "github.com/charmbracelet/lipgloss" +) + +// --------------------------------------------------------------------------- +// Proxy (proxy_renderer.py) +// --------------------------------------------------------------------------- + +const proxyIcon = "<~>" + +func proxyStatusStyle(code int) lipgloss.Style { + switch { + case code >= 200 && code < 300: + return Col(Green) + case code >= 300 && code < 400: + return Col(Status3xx) + case code >= 400 && code < 500: + return Col(Status4xx) + case code >= 500: + return Col(Red) + } + return Dim() +} + +func ptrunc(s string, max int) string { + if len(s) > max { + return s[:max-3] + "..." + } + return s +} + +func psanitize(s string, max int) string { + clean := strings.NewReplacer("\n", " ", "\r", "", "\t", " ").Replace(s) + return ptrunc(clean, max) +} + +func renderProxyTool(name string, args map[string]any, result any, status string) string { + switch name { + case "list_requests": + return renderListRequests(args, result, status) + case "view_request": + return renderViewRequest(args, result, status) + case "repeat_request": + return renderRepeatRequest(args, result, status) + case "list_sitemap": + return renderListSitemap(args, result, status) + case "view_sitemap_entry": + return renderViewSitemapEntry(args, result, status) + case "scope_rules": + return renderScopeRules(args, result, status) + } + return "" +} + +func resultMapOf(result any) (map[string]any, bool) { + m, ok := result.(map[string]any) + return m, ok +} + +func renderListRequests(args map[string]any, result any, status string) string { + var b strings.Builder + b.WriteString(Dim().Render(proxyIcon) + Col(Cyan).Render(" listing requests")) + if f := StringValue(args["httpql_filter"]); f != "" { + b.WriteString(Dim().Italic(true).Render(" where " + ptrunc(f, 150))) + } + var meta []string + if s := StringValue(args["sort_by"]); s != "" && s != "timestamp" { + meta = append(meta, "by:"+s) + } + if s := StringValue(args["sort_order"]); s != "" && s != "desc" { + meta = append(meta, s) + } + if s := StringValue(args["scope_id"]); s != "" { + meta = append(meta, "scope:"+truncStr(s, 8)) + } + if len(meta) > 0 { + b.WriteString(Dim().Render(" (" + strings.Join(meta, ", ") + ")")) + } + if status == "completed" { + if m, ok := resultMapOf(result); ok { + if e, has := m["error"]; has { + b.WriteString(Col(Red).Render(" error: " + psanitize(StringValue(e), 150))) + } else { + entries, _ := m["entries"].([]any) + suffix := "" + if pi, ok := m["page_info"].(map[string]any); ok && truthy(pi["has_next_page"]) { + suffix = "+" + } + b.WriteString(Dim().Render(fmt.Sprintf(" [%d%s found]", len(entries), suffix))) + renderRequestEntries(&b, entries) + } + } + } + return b.String() +} + +func renderRequestEntries(b *strings.Builder, entries []any) { + if len(entries) == 0 { + return + } + b.WriteString("\n") + limit := len(entries) + if limit > 20 { + limit = 20 + } + for i := 0; i < limit; i++ { + entry, ok := entries[i].(map[string]any) + if !ok { + continue + } + req, _ := entry["request"].(map[string]any) + resp, _ := entry["response"].(map[string]any) + method := StringValue(req["method"]) + if method == "" { + method = "?" + } + host := StringValue(req["host"]) + path := StringValue(req["path"]) + if path == "" { + path = "/" + } + b.WriteString(" " + Col(Lavender).Render(fmt.Sprintf("%-6s", method))) + b.WriteString(Dim().Render(" " + ptrunc(host+path, 180))) + if code, ok := NumericValue(resp["status_code"]); ok && code != 0 { + b.WriteString(proxyStatusStyle(int(code)).Render(fmt.Sprintf(" %d", int(code)))) + } + if i < limit-1 { + b.WriteString("\n") + } + } + if len(entries) > 20 { + b.WriteString("\n" + Dim().Italic(true).Render(fmt.Sprintf(" ... +%d more", len(entries)-20))) + } +} + +func renderViewRequest(args map[string]any, result any, status string) string { + var b strings.Builder + b.WriteString(Dim().Render(proxyIcon)) + part := StringValue(args["part"]) + if part == "" { + part = "request" + } + action := "viewing" + search := StringValue(args["search_pattern"]) + if search != "" { + action = "searching" + } + b.WriteString(Col(Cyan).Render(" " + action + " " + part)) + if rid := StringValue(args["request_id"]); rid != "" { + b.WriteString(Dim().Render(" #" + rid)) + } + if search != "" { + b.WriteString(Dim().Italic(true).Render(" /" + ptrunc(search, 100) + "/")) + } + if status == "completed" { + if m, ok := resultMapOf(result); ok { + if e, has := m["error"]; has { + b.WriteString(Col(Red).Render(" error: " + psanitize(StringValue(e), 150))) + } else if hits, has := m["hits"].([]any); has { + total := len(hits) + if t, ok := NumericValue(m["total_hits"]); ok { + total = int(t) + } + b.WriteString(Dim().Render(fmt.Sprintf(" [%d matches]", total))) + renderSearchHits(&b, hits) + } else if content, has := m["content"]; has { + page := 1 + if p, ok := NumericValue(m["page"]); ok { + page = int(p) + } + tl := 0 + if t, ok := NumericValue(m["total_lines"]); ok { + tl = int(t) + } + b.WriteString(Dim().Render(fmt.Sprintf(" [page %d, %d lines]", page, tl))) + renderContentLines(&b, StringValue(content), truthy(m["has_more"])) + } + } + } + return b.String() +} + +func renderSearchHits(b *strings.Builder, hits []any) { + if len(hits) == 0 { + return + } + b.WriteString("\n") + limit := len(hits) + if limit > 5 { + limit = 5 + } + for i := 0; i < limit; i++ { + m, ok := hits[i].(map[string]any) + if !ok { + continue + } + before := lastN(strings.NewReplacer("\n", " ", "\r", "").Replace(StringValue(m["before"])), 100) + after := firstN(strings.NewReplacer("\n", " ", "\r", "").Replace(StringValue(m["after"])), 100) + b.WriteString(" ") + if before != "" { + b.WriteString(Dim().Render("..." + before)) + } + b.WriteString(Bold(Green).Render(StringValue(m["match"]))) + if after != "" { + b.WriteString(Dim().Render(after + "...")) + } + if i < limit-1 { + b.WriteString("\n") + } + } + if len(hits) > 5 { + b.WriteString("\n" + Dim().Italic(true).Render(fmt.Sprintf(" ... +%d more matches", len(hits)-5))) + } +} + +func renderContentLines(b *strings.Builder, content string, hasMore bool) { + if content == "" { + return + } + allLines := strings.Split(content, "\n") + lines := allLines + if len(lines) > 15 { + lines = lines[:15] + } + b.WriteString("\n") + for i, line := range lines { + b.WriteString(" " + Dim().Render(ptrunc(line, maxLineLength))) + if i < len(lines)-1 { + b.WriteString("\n") + } + } + if hasMore || len(allLines) > 15 { + b.WriteString("\n" + Dim().Italic(true).Render(" ... more content available")) + } +} + +func renderRepeatRequest(args map[string]any, result any, status string) string { + var b strings.Builder + b.WriteString(Dim().Render(proxyIcon) + Col(Cyan).Render(" repeating request")) + if rid := StringValue(args["request_id"]); rid != "" { + b.WriteString(Dim().Render(" #" + rid)) + } + if mods, ok := args["modifications"].(map[string]any); ok { + b.WriteString(Dim().Italic(true).Render("\n modifications:")) + arrow := Col(Blue).Render(" >> ") + if url, ok := mods["url"]; ok { + b.WriteString("\n" + arrow + Dim().Render("url: "+ptrunc(StringValue(url), 180))) + } + writeKV := func(key, prefix string, valMax int) { + if kv, ok := mods[key].(map[string]any); ok { + n := 0 + for k, v := range kv { + if n >= 5 { + break + } + b.WriteString("\n" + arrow + Dim().Render(fmt.Sprintf(prefix, k, psanitize(StringValue(v), valMax)))) + n++ + } + } + } + writeKV("headers", "%s: %s", 150) + writeKV("cookies", "cookie %s=%s", 100) + writeKV("params", "param %s=%s", 100) + if body, ok := mods["body"].(string); ok { + b.WriteString("\n" + arrow) + bodyLines := strings.Split(body, "\n") + shown := bodyLines + if len(shown) > 4 { + shown = shown[:4] + } + for i, line := range shown { + if i > 0 { + b.WriteString("\n" + Dim().Render(" ")) + } + b.WriteString(Dim().Render(ptrunc(line, maxLineLength))) + } + if len(bodyLines) > 4 { + b.WriteString(Dim().Italic(true).Render(" ...")) + } + } + } else if mods, ok := args["modifications"].(string); ok && mods != "" { + b.WriteString(Dim().Italic(true).Render("\n " + ptrunc(mods, 200))) + } + if status == "completed" { + if m, ok := resultMapOf(result); ok { + success, hasSuccess := m["success"].(bool) + if hasSuccess && !success && StringValue(m["error"]) != "" { + b.WriteString(Col(Red).Render("\n error: " + psanitize(StringValue(m["error"]), 150))) + } else { + resp, _ := m["response"].(map[string]any) + b.WriteString("\n" + Col(Green).Render(" << ")) + if code, ok := NumericValue(resp["status_code"]); ok && code != 0 { + b.WriteString(proxyStatusStyle(int(code)).Render(fmt.Sprintf("%d", int(code)))) + } else { + b.WriteString(Dim().Render("(no response)")) + } + if ms, ok := NumericValue(m["elapsed_ms"]); ok && ms != 0 { + b.WriteString(Dim().Render(fmt.Sprintf(" (%dms)", int(ms)))) + } + body := StringValue(resp["body"]) + if body != "" { + allLines := strings.Split(body, "\n") + lines := allLines + if len(lines) > 5 { + lines = lines[:5] + } + for _, line := range lines { + b.WriteString("\n" + Col(Green).Render(" << ") + Dim().Render(ptrunc(line, maxLineLength-5))) + } + if truthy(resp["body_truncated"]) || len(allLines) > 5 { + b.WriteString("\n" + Dim().Italic(true).Render(" ...")) + } + } + } + } + } + return b.String() +} + +func renderListSitemap(args map[string]any, result any, status string) string { + var b strings.Builder + b.WriteString(Dim().Render(proxyIcon) + Col(Cyan).Render(" listing sitemap")) + if pid := StringValue(args["parent_id"]); pid != "" { + b.WriteString(Dim().Render(" under #" + ptrunc(pid, 20))) + } + var meta []string + if s := StringValue(args["scope_id"]); s != "" { + meta = append(meta, "scope:"+truncStr(s, 8)) + } + if d := StringValue(args["depth"]); d != "" && d != "DIRECT" { + meta = append(meta, strings.ToLower(d)) + } + if len(meta) > 0 { + b.WriteString(Dim().Render(" (" + strings.Join(meta, ", ") + ")")) + } + if status == "completed" { + if m, ok := resultMapOf(result); ok { + if e, has := m["error"]; has { + b.WriteString(Col(Red).Render(" error: " + psanitize(StringValue(e), 150))) + } else { + total := 0 + if t, ok := NumericValue(m["total_count"]); ok { + total = int(t) + } + entries, _ := m["entries"].([]any) + b.WriteString(Dim().Render(fmt.Sprintf(" [%d entries]", total))) + renderSitemapEntries(&b, entries) + } + } + } + return b.String() +} + +var sitemapKindColors = map[string]lipgloss.Color{ + "DOMAIN": AmberY, "DIRECTORY": Blue, "REQUEST": Green, +} + +func renderSitemapEntries(b *strings.Builder, entries []any) { + if len(entries) == 0 { + return + } + b.WriteString("\n") + limit := len(entries) + if limit > 20 { + limit = 20 + } + for i := 0; i < limit; i++ { + entry, ok := entries[i].(map[string]any) + if !ok { + continue + } + kind := StringValue(entry["kind"]) + if kind == "" { + kind = "?" + } + label := StringValue(entry["label"]) + if label == "" { + label = "?" + } + kindStyle, ok := sitemapKindColors[kind] + style := Dim() + if ok { + style = Col(kindStyle) + } + abbr := kind + if len(abbr) > 3 { + abbr = abbr[:3] + } + b.WriteString(" " + style.Render(fmt.Sprintf("%-3s", abbr)) + Dim().Render(" "+ptrunc(label, 150))) + if req, ok := entry["request"].(map[string]any); ok { + if method := StringValue(req["method"]); method != "" { + b.WriteString(Col(Lavender).Render(" " + method)) + } + if code, ok := NumericValue(req["status_code"]); ok && code != 0 { + b.WriteString(proxyStatusStyle(int(code)).Render(fmt.Sprintf(" %d", int(code)))) + } + } + if truthy(entry["has_descendants"]) { + b.WriteString(Dim().Italic(true).Render(" +")) + } + if i < limit-1 { + b.WriteString("\n") + } + } + if len(entries) > 20 { + b.WriteString("\n" + Dim().Italic(true).Render(fmt.Sprintf(" ... +%d more", len(entries)-20))) + } +} + +func renderViewSitemapEntry(args map[string]any, result any, status string) string { + var b strings.Builder + b.WriteString(Dim().Render(proxyIcon) + Col(Cyan).Render(" viewing sitemap")) + if eid := StringValue(args["entry_id"]); eid != "" { + b.WriteString(Dim().Render(" #" + ptrunc(eid, 20))) + } + if status == "completed" { + if m, ok := resultMapOf(result); ok { + if e, has := m["error"]; has { + b.WriteString(Col(Red).Render(" error: " + psanitize(StringValue(e), 150))) + } else if entry, ok := m["entry"].(map[string]any); ok { + kind, label := StringValue(entry["kind"]), StringValue(entry["label"]) + related, _ := entry["related_requests"].(map[string]any) + if kind != "" && label != "" { + b.WriteString(Dim().Render(fmt.Sprintf(" %s: %s", kind, ptrunc(label, 120)))) + } + total := 0 + if t, ok := NumericValue(related["total_count"]); ok { + total = int(t) + } + if total != 0 { + b.WriteString(Dim().Render(fmt.Sprintf(" [%d requests]", total))) + } + reqs, _ := related["requests"].([]any) + renderRelatedRequests(&b, reqs) + } + } + } + return b.String() +} + +func renderRelatedRequests(b *strings.Builder, reqs []any) { + if len(reqs) == 0 { + return + } + b.WriteString("\n") + limit := len(reqs) + if limit > 10 { + limit = 10 + } + for i := 0; i < limit; i++ { + req, ok := reqs[i].(map[string]any) + if !ok { + continue + } + method := StringValue(req["method"]) + if method == "" { + method = "?" + } + path := StringValue(req["path"]) + if path == "" { + path = "/" + } + b.WriteString(" " + Col(Lavender).Render(fmt.Sprintf("%-6s", method)) + Dim().Render(" "+ptrunc(path, 180))) + if code, ok := NumericValue(req["status_code"]); ok && code != 0 { + b.WriteString(proxyStatusStyle(int(code)).Render(fmt.Sprintf(" %d", int(code)))) + } + if i < limit-1 { + b.WriteString("\n") + } + } + if len(reqs) > 10 { + b.WriteString("\n" + Dim().Italic(true).Render(fmt.Sprintf(" ... +%d more", len(reqs)-10))) + } +} + +var scopeActionMap = map[string]string{ + "get": "getting", "list": "listing", "create": "creating", "update": "updating", "delete": "deleting", +} + +func renderScopeRules(args map[string]any, result any, status string) string { + var b strings.Builder + b.WriteString(Dim().Render(proxyIcon)) + action := StringValue(args["action"]) + actionText, ok := scopeActionMap[action] + if !ok { + if action != "" { + actionText = action + "ing" + } else { + actionText = "managing" + } + } + b.WriteString(Col(Cyan).Render(" " + actionText + " proxy scope")) + if sn := StringValue(args["scope_name"]); sn != "" { + b.WriteString(Dim().Italic(true).Render(" '" + ptrunc(sn, 50) + "'")) + } + if sid := StringValue(args["scope_id"]); sid != "" { + b.WriteString(Dim().Render(" #" + truncStr(sid, 8))) + } + writeList := func(key, label string) { + if items, ok := args[key].([]any); ok && len(items) > 0 { + shown := items + if len(shown) > 4 { + shown = shown[:4] + } + var parts []string + for _, it := range shown { + parts = append(parts, ptrunc(StringValue(it), 40)) + } + b.WriteString("\n " + Dim().Render(label+": "+strings.Join(parts, ", "))) + if len(items) > 4 { + b.WriteString(Dim().Italic(true).Render(fmt.Sprintf(" +%d", len(items)-4))) + } + } + } + writeList("allowlist", "allow") + writeList("denylist", "deny") + if status == "completed" { + if m, ok := resultMapOf(result); ok { + switch { + case m["error"] != nil: + b.WriteString(Col(Red).Render(" error: " + psanitize(StringValue(m["error"]), 150))) + case m["scopes"] != nil: + scopes, _ := m["scopes"].([]any) + b.WriteString(Dim().Render(fmt.Sprintf(" [%d scopes]", len(scopes)))) + renderScopeList(&b, scopes) + case m["scope"] != nil: + if scope, ok := m["scope"].(map[string]any); ok { + if allow, ok := scope["allowlist"].([]any); ok && len(allow) > 0 { + b.WriteString("\n " + Dim().Render("allow: "+joinTrunc(allow, 40, 5))) + } + if deny, ok := scope["denylist"].([]any); ok && len(deny) > 0 { + b.WriteString("\n " + Dim().Render("deny: "+joinTrunc(deny, 40, 5))) + } + } + case m["message"] != nil: + b.WriteString(Col(Green).Render(" " + StringValue(m["message"]))) + } + } + } + return b.String() +} + +func renderScopeList(b *strings.Builder, scopes []any) { + if len(scopes) == 0 { + return + } + b.WriteString("\n") + limit := len(scopes) + if limit > 5 { + limit = 5 + } + for i := 0; i < limit; i++ { + scope, ok := scopes[i].(map[string]any) + if !ok { + continue + } + name := StringValue(scope["name"]) + if name == "" { + name = "?" + } + b.WriteString(" " + Col(Green).Render(ptrunc(name, 40))) + if allow, ok := scope["allowlist"].([]any); ok && len(allow) > 0 { + b.WriteString(Dim().Render(" " + joinTrunc(allow, 30, 3))) + if len(allow) > 3 { + b.WriteString(Dim().Italic(true).Render(fmt.Sprintf(" +%d", len(allow)-3))) + } + } + if i < limit-1 { + b.WriteString("\n") + } + } +} diff --git a/strix/interface/tui/internal/render/registry.go b/strix/interface/tui/internal/render/registry.go new file mode 100644 index 00000000..3c235b0a --- /dev/null +++ b/strix/interface/tui/internal/render/registry.go @@ -0,0 +1,135 @@ +package render + +import ( + "fmt" + "strings" + + "github.com/charmbracelet/lipgloss" +) + +// statusIcon ports BaseToolRenderer.status_icon. +func statusIcon(status string) (string, lipgloss.Style) { + switch status { + case "running": + return "● In progress...", Col(AmberY) + case "completed": + return "✓ Done", Col(Green) + case "failed": + return "✗ Failed", Col(SevCrit) + case "error": + return "✗ Error", Col(SevCrit) + } + return "○ Unknown", Dim() +} + +// renderGenericTool ports registry._render_default_tool_widget. +func renderGenericTool(name string, args map[string]any, result any, status string) string { + var b strings.Builder + b.WriteString(Dim().Render("→ Using tool ") + Bold(Blue).Render(name) + "\n") + for _, k := range SortedKeys(args) { + b.WriteString(" " + Dim().Render(k) + ": " + StringValue(args[k]) + "\n") + } + if (status == "completed" || status == "failed" || status == "error") && result != nil { + b.WriteString(lipgloss.NewStyle().Bold(true).Render("Result: ") + StringValue(result)) + } else { + icon, style := statusIcon(status) + b.WriteString(style.Render(icon)) + } + return b.String() +} + +// --------------------------------------------------------------------------- +// Dispatch +// --------------------------------------------------------------------------- + +func Tool(data map[string]any) string { + name := StringValue(data["tool_name"]) + status := StringValue(data["status"]) + args, _ := data["args"].(map[string]any) + if args == nil { + args = map[string]any{} + } + result := data["result"] + + switch name { + case "exec_command": + return renderExecCommand(args, result, status) + case "write_stdin": + return renderWriteStdin(args, result, status) + case "apply_patch": + return renderApplyPatch(args, result, status) + case "view_image": + return renderViewImage(args, result) + case "create_vulnerability_report": + return renderVulnerabilityReport(args, result) + case "create_dependency_report": + return renderDependencyReport(args, result) + case "list_reports": + return renderListReports(result) + case "get_report": + return renderGetReport(result) + case "respond_to_user": + return renderRespondToUser(args) + case "finish_scan": + return renderFinishScan(args) + case "think": + return renderThink(args) + case "web_search": + return renderWebSearch(args) + case "load_skill": + return renderLoadSkill(args, result) + case "create_note", "delete_note", "update_note", "list_notes", "get_note": + return renderNote(name, args, result) + case "create_todo", "list_todos", "update_todo", "mark_todo_done", "mark_todo_pending", "delete_todo": + return renderTodo(name, result) + case "view_agent_graph", "create_agent", "send_message_to_agent", "agent_finish", "wait_for_agents", "stop_agent": + return renderAgentGraphTool(name, args, result) + case "list_requests", "view_request", "repeat_request", "list_sitemap", "view_sitemap_entry", "scope_rules": + return renderProxyTool(name, args, result, status) + } + return renderGenericTool(name, args, result, status) +} + +// --------------------------------------------------------------------------- +// Collapsing: output-heavy tools (terminal, proxy) render as short block +// previews; clicking a tool in the trace expands it to the full render. +// --------------------------------------------------------------------------- + +const outputPreviewLines = 10 + +// ToolPreviewLines returns how many lines of a tool's render are shown before +// it is collapsed; 0 means the tool is never collapsed. Only tools whose +// output can grow unbounded (terminal, patches, proxy) collapse. +func ToolPreviewLines(name string) int { + switch name { + case "exec_command", "write_stdin", "apply_patch", + "view_request", "repeat_request", "view_sitemap_entry": + return outputPreviewLines + } + return 0 +} + +// CollapseTool clips a full tool render to its preview size, appending a +// click-to-expand/collapse hint. It reports whether the tool has more content +// than the preview (i.e. whether it is expandable). +func CollapseTool(full, name string, expanded bool) (string, bool) { + maxLines := ToolPreviewLines(name) + if maxLines <= 0 { + return full, false + } + lines := strings.Split(full, "\n") + if len(lines) <= maxLines { + return full, false + } + if expanded { + return full + "\n" + Dim().Italic(true).Render(" ▲ click to collapse"), true + } + preview := strings.Join(lines[:maxLines], "\n") + hidden := len(lines) - maxLines + plural := "s" + if hidden == 1 { + plural = "" + } + hint := Dim().Italic(true).Render(fmt.Sprintf(" … +%d line%s — click to expand", hidden, plural)) + return preview + "\n" + hint, true +} diff --git a/strix/interface/tui/internal/render/render_test.go b/strix/interface/tui/internal/render/render_test.go new file mode 100644 index 00000000..f9ed7f84 --- /dev/null +++ b/strix/interface/tui/internal/render/render_test.go @@ -0,0 +1,251 @@ +package render + +import ( + "fmt" + "strings" + "testing" + + "github.com/charmbracelet/x/ansi" +) + +func tool(name string, args map[string]any, result any, status string) map[string]any { + data := map[string]any{"tool_name": name, "status": status} + if args != nil { + data["args"] = args + } + if result != nil { + data["result"] = result + } + return data +} + +func requireContains(t *testing.T, output string, wants ...string) { + t.Helper() + for _, want := range wants { + if !strings.Contains(output, want) { + t.Fatalf("output missing %q:\n%s", want, output) + } + } +} + +func TestChatUserMessage(t *testing.T) { + out := Chat(map[string]any{"role": "user", "content": "hello\nworld"}) + requireContains(t, out, "You:", "hello", "world") +} + +func TestChatAssistantMarkdown(t *testing.T) { + out := Chat(map[string]any{"role": "assistant", "content": "# Heading\n\nSome **bold** text"}) + requireContains(t, out, "Heading", "bold") +} + +func TestExecCommandHighlightsCommand(t *testing.T) { + out := Tool(tool("exec_command", map[string]any{"cmd": "for f in *.py; do echo \"$f\"; done"}, nil, "running")) + if !strings.Contains(out, "\x1b[38;5;") { + t.Fatalf("expected syntax-highlighted command:\n%q", out) + } +} + +func TestApplyPatchHighlightsCode(t *testing.T) { + out := Tool(tool("apply_patch", map[string]any{ + "patch": "*** Update File: src/app.py\n-import os\n+import sys\n+def main():\n+ return sys.argv", + }, nil, "completed")) + if !strings.Contains(out, "\x1b[38;5;") { + t.Fatalf("expected syntax-highlighted patch lines:\n%q", out) + } + lines := strings.Split(out, "\n") + if len(lines) != 5 { + t.Fatalf("diff line structure must survive highlighting, got %d lines:\n%q", len(lines), out) + } +} + +func TestToolDispatchCoversKnownTools(t *testing.T) { + cases := []struct { + name string + data map[string]any + wants []string + }{ + { + "exec_command", + tool("exec_command", map[string]any{"cmd": "ls -la"}, nil, "running"), + []string{"ls -la"}, + }, + { + "write_stdin", + tool("write_stdin", map[string]any{"chars": "y", "session_id": 3}, nil, "completed"), + []string{"y", "session #3"}, + }, + { + "apply_patch", + tool("apply_patch", map[string]any{ + "file_path": "src/app.py", + "patch": "*** Update File: src/app.py\n+new line", + }, nil, "completed"), + []string{"src/app.py"}, + }, + { + "view_image", + tool("view_image", map[string]any{"path": "shot.png"}, nil, "completed"), + []string{"shot.png"}, + }, + { + "create_vulnerability_report", + tool("create_vulnerability_report", + map[string]any{"title": "SQL injection in login", "target": "https://x.test"}, + map[string]any{"severity": "critical", "cvss_score": 9.8}, + "completed"), + []string{"Vulnerability Report", "SQL injection in login", "CRITICAL", "9.8"}, + }, + { + "create_dependency_report", + tool("create_dependency_report", + map[string]any{"package_name": "requests", "installed_version": "2.0.0"}, + nil, "completed"), + []string{"requests"}, + }, + { + "list_reports", + tool("list_reports", nil, map[string]any{ + "success": true, + "total_count": 2, + "severity_counts": map[string]any{"critical": 1, "low": 1}, + "reports": []any{ + map[string]any{"id": "VULN-1", "title": "SQLi", "severity": "critical", "by_you": true}, + map[string]any{"id": "VULN-2", "title": "Weak header", "severity": "low", "agent_name": "recon"}, + }, + }, "completed"), + []string{"reports", "(2)", "CRITICAL", "VULN-1", "SQLi", "(you)", "LOW", "VULN-2", "(recon)"}, + }, + { + "list_reports empty", + tool("list_reports", nil, map[string]any{"success": true, "total_count": 0}, "completed"), + []string{"reports", "(0)", "No reports filed yet"}, + }, + { + "get_report", + tool("get_report", nil, map[string]any{ + "success": true, + "report": map[string]any{ + "id": "VULN-1", "title": "SQLi", "severity": "high", "target": "https://x.test", + }, + }, "completed"), + []string{"report read", "HIGH", "VULN-1", "SQLi", "https://x.test"}, + }, + { + "get_report error", + tool("get_report", nil, map[string]any{"success": false, "error": "not found"}, "failed"), + []string{"report read", "not found"}, + }, + { + "respond_to_user", + tool("respond_to_user", map[string]any{"message": "Here is the answer"}, nil, "completed"), + []string{"Here is the answer", "waiting for your reply"}, + }, + { + "finish_scan", + tool("finish_scan", map[string]any{"executive_summary": "All done"}, nil, "completed"), + []string{"Penetration test completed", "All done"}, + }, + { + "think", + tool("think", map[string]any{"thought": "checking auth flow"}, nil, "running"), + []string{"Thinking", "checking auth flow"}, + }, + { + "web_search", + tool("web_search", map[string]any{"query": "CVE-2024-1234"}, nil, "running"), + []string{"Searching the web", "CVE-2024-1234"}, + }, + { + "load_skill", + tool("load_skill", map[string]any{"skills": []any{"sqli"}}, nil, "completed"), + []string{"sqli"}, + }, + { + "create_note", + tool("create_note", map[string]any{"title": "Recon findings"}, nil, "completed"), + []string{"Recon findings"}, + }, + { + "create_todo", + tool("create_todo", nil, map[string]any{ + "success": true, + "todos": []any{ + map[string]any{"id": 1, "title": "Check login", "status": "pending"}, + }, + }, "completed"), + []string{"Check login"}, + }, + { + "create_agent", + tool("create_agent", map[string]any{"name": "ReconAgent", "task": "map the site"}, nil, "running"), + []string{"spawning", "ReconAgent", "map the site"}, + }, + { + "wait_for_agents", + tool("wait_for_agents", map[string]any{"reason": "results needed"}, nil, "running"), + []string{"waiting", "results needed"}, + }, + { + "stop_agent", + tool("stop_agent", map[string]any{"target_agent_id": "agent-2"}, nil, "completed"), + []string{"stopping", "agent-2"}, + }, + { + "view_agent_graph", + tool("view_agent_graph", nil, nil, "completed"), + []string{"viewing agents graph"}, + }, + { + "list_requests", + tool("list_requests", map[string]any{"httpql_filter": "host:example.com"}, nil, "completed"), + []string{"host:example.com"}, + }, + { + "unknown tool falls back to generic", + tool("brand_new_tool", map[string]any{"alpha": "1"}, "done", "completed"), + []string{"brand_new_tool", "alpha", "Result:", "done"}, + }, + } + + for _, tc := range cases { + t.Run(tc.name, func(t *testing.T) { + requireContains(t, Tool(tc.data), tc.wants...) + }) + } +} + +func TestCollapseToolShellPreviewAndExpand(t *testing.T) { + lines := make([]string, 16) + for i := range lines { + lines[i] = fmt.Sprintf("line %d", i) + } + full := strings.Join(lines, "\n") + + collapsed, expandable := CollapseTool(full, "exec_command", false) + if !expandable { + t.Fatal("long shell output should be expandable") + } + got := strings.Split(ansi.Strip(collapsed), "\n") + if len(got) != 11 || !strings.Contains(got[10], "+6 lines — click to expand") { + t.Fatalf("collapsed shell preview wrong: %q", got) + } + + expanded, expandable := CollapseTool(full, "exec_command", true) + if !expandable || !strings.Contains(ansi.Strip(expanded), full) || + !strings.Contains(ansi.Strip(expanded), "click to collapse") { + t.Fatalf("expanded render wrong: %q", expanded) + } +} + +func TestCollapseToolOnlyOutputHeavyTools(t *testing.T) { + full := "🧠 Thinking\n a long private thought\n spanning lines" + if out, expandable := CollapseTool(full, "think", false); expandable || out != full { + t.Fatal("think must never collapse") + } + if _, expandable := CollapseTool("short", "exec_command", false); expandable { + t.Fatal("short output must not be expandable") + } + if out, expandable := CollapseTool(full, "respond_to_user", false); expandable || out != full { + t.Fatal("respond_to_user must never collapse") + } +} diff --git a/strix/interface/tui/internal/render/report.go b/strix/interface/tui/internal/render/report.go new file mode 100644 index 00000000..0002fdb2 --- /dev/null +++ b/strix/interface/tui/internal/render/report.go @@ -0,0 +1,126 @@ +package render + +import ( + "fmt" + "strings" + + "github.com/charmbracelet/lipgloss" +) + +// --------------------------------------------------------------------------- +// Reporting (reporting_renderer.py) +// --------------------------------------------------------------------------- + +func renderVulnerabilityReport(args map[string]any, result any) string { + resultMap, _ := result.(map[string]any) + var b strings.Builder + b.WriteString("🐞 " + Bold(ReportHdr).Render("Vulnerability Report")) + + field := func(label, value string) { + if value != "" { + b.WriteString("\n\n" + Bold(Field).Render(label+": ") + value) + } + } + title := StringValue(args["title"]) + field("Title", title) + + if sev := StringValue(resultMap["severity"]); sev != "" { + b.WriteString("\n\n" + Bold(Field).Render("Severity: ") + + lipgloss.NewStyle().Bold(true).Foreground(SeverityColor(sev)).Render(strings.ToUpper(sev))) + } + if score, ok := NumericValue(resultMap["cvss_score"]); ok { + b.WriteString("\n\n" + Bold(Field).Render("CVSS Score: ") + + lipgloss.NewStyle().Bold(true).Foreground(CVSSColor(score)).Render(StringValue(resultMap["cvss_score"]))) + } + field("Target", StringValue(args["target"])) + field("Endpoint", StringValue(args["endpoint"])) + field("Method", StringValue(args["method"])) + field("CVE", StringValue(args["cve"])) + field("CWE", StringValue(args["cwe"])) + + if bd, ok := args["cvss_breakdown"].(map[string]any); ok && len(bd) > 0 { + parts := CVSSVectorParts(bd) + if len(parts) > 0 { + b.WriteString("\n\n" + Bold(Field).Render("CVSS Vector: ") + Dim().Render(strings.Join(parts, "/"))) + } + } + + section := func(label, value string) { + if value != "" { + b.WriteString("\n\n" + Bold(Field).Render(label) + "\n" + value) + } + } + section("Description", StringValue(args["description"])) + section("Impact", StringValue(args["impact"])) + section("Technical Analysis", StringValue(args["technical_analysis"])) + renderCodeLocations(&b, args["code_locations"]) + section("PoC Description", StringValue(args["poc_description"])) + if poc := StringValue(args["poc_script_code"]); poc != "" { + b.WriteString("\n\n" + Bold(Field).Render("PoC Code") + "\n" + Col(Text).Render(poc)) + } + section("Remediation", StringValue(args["remediation_steps"])) + + if title == "" { + b.WriteString("\n " + Dim().Render("Creating report...")) + } + return "\n\n" + b.String() + "\n\n" +} + +var cvssKeys = [][2]string{ + {"attack_vector", "AV"}, {"attack_complexity", "AC"}, {"privileges_required", "PR"}, + {"user_interaction", "UI"}, {"scope", "S"}, {"confidentiality", "C"}, + {"integrity", "I"}, {"availability", "A"}, +} + +func CVSSVectorParts(bd map[string]any) []string { + var parts []string + for _, kp := range cvssKeys { + if v := StringValue(bd[kp[0]]); v != "" { + parts = append(parts, kp[1]+":"+v) + } + } + return parts +} + +func renderCodeLocations(b *strings.Builder, raw any) { + locs, ok := raw.([]any) + if !ok || len(locs) == 0 { + return + } + b.WriteString("\n\n" + Bold(Field).Render("Code Locations")) + for i, l := range locs { + loc, ok := l.(map[string]any) + if !ok { + continue + } + b.WriteString("\n\n" + Dim().Render(fmt.Sprintf(" Location %d: ", i+1))) + file := StringValue(loc["file"]) + if file == "" { + file = "unknown" + } + b.WriteString(Bold(InfoBlue).Render(file)) + if start, ok := NumericValue(loc["start_line"]); ok { + if end, ok := NumericValue(loc["end_line"]); ok && end != start { + b.WriteString(Col(LineNum).Render(fmt.Sprintf(":%d-%d", int(start), int(end)))) + } else { + b.WriteString(Col(LineNum).Render(fmt.Sprintf(":%d", int(start)))) + } + } + if label := StringValue(loc["label"]); label != "" { + b.WriteString(lipgloss.NewStyle().Italic(true).Foreground(Label).Render("\n " + label)) + } + if snip := StringValue(loc["snippet"]); snip != "" { + b.WriteString("\n " + Col(Snippet).Render(snip)) + } + before, after := StringValue(loc["fix_before"]), StringValue(loc["fix_after"]) + if before != "" || after != "" { + b.WriteString("\n " + Dim().Render("Fix:")) + if before != "" { + b.WriteString("\n " + Col(Red).Render("- ") + Col(Red).Render(before)) + } + if after != "" { + b.WriteString("\n " + Col(Green).Render("+ ") + Col(Green).Render(after)) + } + } + } +} diff --git a/strix/interface/tui/internal/render/report_list.go b/strix/interface/tui/internal/render/report_list.go new file mode 100644 index 00000000..aa19293d --- /dev/null +++ b/strix/interface/tui/internal/render/report_list.go @@ -0,0 +1,129 @@ +package render + +import ( + "fmt" + "strings" + + "github.com/charmbracelet/lipgloss" +) + +// --------------------------------------------------------------------------- +// Report browsing (reporting_renderer.py: ListReportsRenderer, GetReportRenderer) +// --------------------------------------------------------------------------- + +// listSeverityColor mirrors reporting_renderer._severity_style, whose fallback +// is medium rather than the vulnerability report's neutral gray. +func listSeverityColor(severity string) lipgloss.Color { + switch strings.ToLower(severity) { + case "critical": + return SevCrit + case "high": + return SevHigh + case "medium": + return SevMed + case "low": + return SevLow + case "info": + return SevInfo + case "none": + return Gray + } + return SevMed +} + +// authorLabel ports reporting_renderer._author_label. +func authorLabel(report map[string]any) string { + if by, ok := report["by_you"].(bool); ok && by { + return "you" + } + return strings.TrimSpace(StringValue(report["agent_name"])) +} + +func reportSummaryLine(b *strings.Builder, report map[string]any, prefix string) { + id := strings.TrimSpace(StringValue(report["id"])) + title := strings.TrimSpace(StringValue(report["title"])) + if title == "" { + title = "(untitled)" + } + severity := strings.TrimSpace(StringValue(report["severity"])) + b.WriteString(prefix) + if severity != "" { + b.WriteString(Bold(listSeverityColor(severity)).Render(strings.ToUpper(severity)) + " ") + } + if id != "" { + b.WriteString(Dim().Render(id + " ")) + } + b.WriteString(title) + if author := authorLabel(report); author != "" { + b.WriteString(Dim().Render(" (" + author + ")")) + } +} + +func renderListReports(result any) string { + var b strings.Builder + b.WriteString(Col(Red).Render("◆ ") + Dim().Render("reports")) + + if text, ok := result.(string); ok && strings.TrimSpace(text) != "" { + b.WriteString("\n " + Dim().Render(strings.TrimSpace(text))) + return b.String() + } + + resultMap, _ := result.(map[string]any) + success, _ := resultMap["success"].(bool) + if !success { + b.WriteString("\n " + Dim().Render("Loading...")) + return b.String() + } + + if total, ok := NumericValue(resultMap["total_count"]); ok { + b.WriteString(Dim().Render(fmt.Sprintf(" (%d)", int(total)))) + } else { + b.WriteString(Dim().Render(" (0)")) + } + if counts, ok := resultMap["severity_counts"].(map[string]any); ok { + for _, severity := range SortedKeys(counts) { + b.WriteString(" " + Col(listSeverityColor(severity)).Render( + severity+" "+StringValue(counts[severity]))) + } + } + + reports, _ := resultMap["reports"].([]any) + if len(reports) == 0 { + b.WriteString("\n " + Dim().Render("No reports filed yet")) + return b.String() + } + for _, raw := range reports { + report, ok := raw.(map[string]any) + if !ok { + continue + } + reportSummaryLine(&b, report, "\n - ") + } + return b.String() +} + +func renderGetReport(result any) string { + var b strings.Builder + b.WriteString(Col(Red).Render("◆ ") + Dim().Render("report read")) + + resultMap, _ := result.(map[string]any) + success, _ := resultMap["success"].(bool) + report, _ := resultMap["report"].(map[string]any) + if !success || len(report) == 0 { + detail := "" + if hasSuccess, ok := resultMap["success"].(bool); ok && !hasSuccess { + detail = StringValue(resultMap["error"]) + } + if detail == "" { + detail = "Loading..." + } + b.WriteString("\n " + Dim().Render(detail)) + return b.String() + } + + reportSummaryLine(&b, report, "\n ") + if target := strings.TrimSpace(StringValue(report["target"])); target != "" { + b.WriteString("\n " + Dim().Render(target)) + } + return b.String() +} diff --git a/strix/interface/tui/internal/render/respond.go b/strix/interface/tui/internal/render/respond.go new file mode 100644 index 00000000..7b8452a3 --- /dev/null +++ b/strix/interface/tui/internal/render/respond.go @@ -0,0 +1,18 @@ +package render + +import "strings" + +// --------------------------------------------------------------------------- +// Direct replies (respond_renderer.py) +// --------------------------------------------------------------------------- + +// renderRespondToUser shows the reply as the agent's own prose, since +// respond_to_user carries the message the user is meant to read. +func renderRespondToUser(args map[string]any) string { + var b strings.Builder + if message := StringValue(args["message"]); message != "" { + b.WriteString(renderAssistantMarkdown(message) + "\n\n") + } + b.WriteString(Col(Gray).Render("○ ") + Dim().Render("waiting for your reply")) + return b.String() +} diff --git a/strix/interface/tui/internal/render/scan.go b/strix/interface/tui/internal/render/scan.go new file mode 100644 index 00000000..d1fc75c5 --- /dev/null +++ b/strix/interface/tui/internal/render/scan.go @@ -0,0 +1,31 @@ +package render + +import ( + "strings" +) + +// --------------------------------------------------------------------------- +// Finish scan (finish_renderer.py) +// --------------------------------------------------------------------------- + +func renderFinishScan(args map[string]any) string { + var b strings.Builder + b.WriteString(Col(Green).Render("◆ ") + Bold(Green).Render("Penetration test completed")) + section := func(label, value string) { + if value != "" { + b.WriteString("\n\n" + Bold(Field).Render(label) + "\n" + value) + } + } + es := StringValue(args["executive_summary"]) + me := StringValue(args["methodology"]) + ta := StringValue(args["technical_analysis"]) + re := StringValue(args["recommendations"]) + section("Executive Summary", es) + section("Methodology", me) + section("Technical Analysis", ta) + section("Recommendations", re) + if es == "" && me == "" && ta == "" && re == "" { + b.WriteString("\n " + Dim().Render("Generating final report...")) + } + return "\n\n" + b.String() + "\n\n" +} diff --git a/strix/interface/tui/internal/render/simple.go b/strix/interface/tui/internal/render/simple.go new file mode 100644 index 00000000..2dfa5641 --- /dev/null +++ b/strix/interface/tui/internal/render/simple.go @@ -0,0 +1,52 @@ +package render + +import ( + "strings" +) + +// --------------------------------------------------------------------------- +// Simple tools (think, web_search, load_skill) + generic fallback +// --------------------------------------------------------------------------- + +func renderThink(args map[string]any) string { + thought := StringValue(args["thought"]) + var b strings.Builder + b.WriteString("🧠 " + Bold(Purple).Render("Thinking") + "\n ") + if thought != "" { + b.WriteString(Dim().Italic(true).Render(thought)) + } else { + b.WriteString(Dim().Italic(true).Render("Thinking...")) + } + return b.String() +} + +func renderWebSearch(args map[string]any) string { + query := StringValue(args["query"]) + var b strings.Builder + b.WriteString("🌐 " + Bold(InfoBlue).Render("Searching the web...")) + if query != "" { + b.WriteString("\n " + Dim().Render(query)) + } + return b.String() +} + +func renderLoadSkill(args map[string]any, result any) string { + var requested string + if list, ok := args["skills"].([]any); ok { + var parts []string + for _, s := range list { + parts = append(parts, StringValue(s)) + } + requested = strings.Join(parts, ", ") + } else { + requested = StringValue(args["skills"]) + } + var b strings.Builder + b.WriteString(Col(Emerald).Render("◇ ") + Dim().Render("loading skill")) + if requested != "" { + b.WriteString(" " + Col(Emerald).Render(requested)) + } else if result == nil { + b.WriteString("\n " + Dim().Render("Loading...")) + } + return b.String() +} diff --git a/strix/interface/tui/internal/render/styles.go b/strix/interface/tui/internal/render/styles.go new file mode 100644 index 00000000..9fc99043 --- /dev/null +++ b/strix/interface/tui/internal/render/styles.go @@ -0,0 +1,82 @@ +// Package render turns chat and tool events into styled terminal output, +// with one file per tool renderer. +package render + +import ( + "strings" + + "github.com/charmbracelet/lipgloss" +) + +// Colors and shared lipgloss style helpers used across the renderers. +// Rich's "dim" attribute maps to lipgloss Faint. +var ( + Green = lipgloss.Color("#22c55e") + Blue = lipgloss.Color("#3b82f6") + Red = lipgloss.Color("#ef4444") + Text = lipgloss.Color("#d4d4d4") + Field = lipgloss.Color("#4ade80") // FIELD_STYLE base (bold) + ReportHdr = lipgloss.Color("#ea580c") // report title / orange + SevCrit = lipgloss.Color("#dc2626") + SevHigh = lipgloss.Color("#ea580c") + SevMed = lipgloss.Color("#d97706") + SevLow = lipgloss.Color("#65a30d") + SevInfo = lipgloss.Color("#0284c7") + Gray = lipgloss.Color("#6b7280") + Purple = lipgloss.Color("#a855f7") // thinking + Lavender = lipgloss.Color("#a78bfa") // todos / agent graph + Emerald = lipgloss.Color("#10b981") // skills / patch ops + Gold = lipgloss.Color("#fbbf24") // notes + AmberY = lipgloss.Color("#f59e0b") // running icon / reopened + LineNum = lipgloss.Color("#facc15") + Label = lipgloss.Color("#a1a1aa") + Snippet = lipgloss.Color("#e2e8f0") + Slate = lipgloss.Color("#94a3b8") + Cyan = lipgloss.Color("#06b6d4") // proxy + Status3xx = lipgloss.Color("#eab308") + Status4xx = lipgloss.Color("#f97316") + Hdr16a = lipgloss.Color("#16a34a") + Hdr158 = lipgloss.Color("#15803d") + Mint = lipgloss.Color("#86efac") + Strike = lipgloss.Color("#525252") + CodeBg = lipgloss.Color("#0a0a0a") + InfoBlue = lipgloss.Color("#60a5fa") +) + +// Style helpers. Col() foreground; Dim() Rich "dim" (faint attribute). +func Col(c lipgloss.Color) lipgloss.Style { return lipgloss.NewStyle().Foreground(c) } +func Dim() lipgloss.Style { return lipgloss.NewStyle().Faint(true) } +func Bold(c lipgloss.Color) lipgloss.Style { + return lipgloss.NewStyle().Bold(true).Foreground(c) +} + +// severityColor maps a severity string to the report renderer's color. +func SeverityColor(sev string) lipgloss.Color { + switch strings.ToLower(sev) { + case "critical": + return SevCrit + case "high": + return SevHigh + case "medium": + return SevMed + case "low": + return SevLow + case "info": + return SevInfo + } + return Gray +} + +func CVSSColor(score float64) lipgloss.Color { + switch { + case score >= 9.0: + return SevCrit + case score >= 7.0: + return SevHigh + case score >= 4.0: + return SevMed + case score >= 0.1: + return SevLow + } + return Gray +} diff --git a/strix/interface/tui/internal/render/terminal.go b/strix/interface/tui/internal/render/terminal.go new file mode 100644 index 00000000..059e1936 --- /dev/null +++ b/strix/interface/tui/internal/render/terminal.go @@ -0,0 +1,183 @@ +package render + +import ( + "fmt" + "regexp" + "strings" + + "github.com/charmbracelet/lipgloss" +) + +// --------------------------------------------------------------------------- +// Shell renderer (shell_renderer.py) +// --------------------------------------------------------------------------- + +const ( + maxOutputLines = 50 + maxLineLength = 200 +) + +var ( + exitRE = regexp.MustCompile(`Process exited with code (-?\d+)`) + sessionRE = regexp.MustCompile(`Process running with session ID (\d+)`) + stripRE = regexp.MustCompile(`(?m)^(Chunk ID: [0-9a-f]+|Wall time: [\d.]+ seconds|Process exited with code -?\d+|Process running with session ID \d+|Original token count: \d+)\s*$`) +) + +const outputHeader = "\nOutput:\n" + +type shellParsed struct { + content string + exitCode int + hasExitCode bool +} + +func parseShellResult(result any) shellParsed { + if m, ok := result.(map[string]any); ok { + p := shellParsed{content: StringValue(m["content"])} + if code, ok := NumericValue(m["exit_code"]); ok { + p.exitCode, p.hasExitCode = int(code), true + } + return p + } + s, ok := result.(string) + if !ok { + if result == nil { + return shellParsed{} + } + return shellParsed{content: StringValue(result)} + } + p := shellParsed{} + if m := exitRE.FindStringSubmatch(s); m != nil { + fmt.Sscanf(m[1], "%d", &p.exitCode) + p.hasExitCode = true + } + if idx := strings.Index(s, outputHeader); idx >= 0 { + p.content = s[idx+len(outputHeader):] + } else { + p.content = s + } + return p +} + +func cleanShellOutput(output string) string { + cleaned := stripControlsKeepTabs(output) + cleaned = stripRE.ReplaceAllString(cleaned, "") + if strings.TrimSpace(cleaned) == "" { + return "" + } + lines := strings.Split(cleaned, "\n") + var filtered []string + for _, line := range lines { + if len(filtered) == 0 && strings.TrimSpace(line) == "" { + continue + } + if strings.TrimSpace(line) == "Output:" { + continue + } + filtered = append(filtered, line) + } + for len(filtered) > 0 && strings.TrimSpace(filtered[len(filtered)-1]) == "" { + filtered = filtered[:len(filtered)-1] + } + return strings.TrimSpace(strings.Join(filtered, "\n")) +} + +func truncateShellLine(line string) string { + if len(line) > maxLineLength { + return line[:maxLineLength-3] + "..." + } + return line +} + +// formatShellOutput ports _format_output (head/tail truncation with a middle marker). +func formatShellOutput(output string) string { + lines := strings.Split(output, "\n") + total := len(lines) + head := maxOutputLines / 2 + tail := maxOutputLines - head - 1 + + var b strings.Builder + if total <= maxOutputLines { + for i, line := range lines { + b.WriteString(" " + Dim().Render(truncateShellLine(line))) + if i < len(lines)-1 { + b.WriteString("\n") + } + } + return b.String() + } + + display := lines[:head] + hidden := total - head - tail + for _, line := range display { + b.WriteString(" " + Dim().Render(truncateShellLine(line)) + "\n") + } + b.WriteString(Dim().Italic(true).Render(fmt.Sprintf(" ... %d lines truncated ...", hidden)) + "\n") + tailLines := lines[total-tail:] + for i, line := range tailLines { + b.WriteString(" " + Dim().Render(truncateShellLine(line))) + if i < len(tailLines)-1 { + b.WriteString("\n") + } + } + return b.String() +} + +func appendShellOutput(b *strings.Builder, p shellParsed, status string) { + output := cleanShellOutput(p.content) + if status == "running" { + if output != "" { + b.WriteString("\n" + formatShellOutput(output)) + } + return + } + if output == "" { + if p.hasExitCode && p.exitCode != 0 { + b.WriteString("\n" + Col(Red).Faint(true).Render(fmt.Sprintf(" exit %d", p.exitCode))) + } + return + } + b.WriteString("\n" + formatShellOutput(output)) + if p.hasExitCode && p.exitCode != 0 { + b.WriteString("\n" + Col(Red).Faint(true).Render(fmt.Sprintf(" exit %d", p.exitCode))) + } +} + +func renderTerminal(prompt string, promptColor lipgloss.Color, command string, result any, status, meta string) string { + var b strings.Builder + b.WriteString(Dim().Render(">_") + " ") + if strings.TrimSpace(command) == "" { + b.WriteString(Dim().Render("getting logs...")) + } else { + b.WriteString(Col(promptColor).Render(prompt) + " " + command) + } + if meta != "" { + b.WriteString(Dim().Render(" " + meta)) + } + if result != nil { + appendShellOutput(&b, parseShellResult(result), status) + } + return b.String() +} + +func renderExecCommand(args map[string]any, result any, status string) string { + cmd := StringValue(args["cmd"]) + var metaParts []string + if wd := StringValue(args["workdir"]); wd != "" { + metaParts = append(metaParts, "cwd:"+wd) + } + if b, ok := args["tty"].(bool); ok && b { + metaParts = append(metaParts, "tty") + } + meta := strings.Join(metaParts, ", ") + return renderTerminal("$", Green, HighlightCode(cmd, "bash"), result, status, meta) +} + +func renderWriteStdin(args map[string]any, result any, status string) string { + chars := StringValue(args["chars"]) + meta := "" + if sid, ok := args["session_id"]; ok && sid != nil { + meta = "session #" + StringValue(sid) + } + return renderTerminal(">>>", Blue, chars, result, status, meta) +} diff --git a/strix/interface/tui/internal/render/todo.go b/strix/interface/tui/internal/render/todo.go new file mode 100644 index 00000000..8ec09b2f --- /dev/null +++ b/strix/interface/tui/internal/render/todo.go @@ -0,0 +1,80 @@ +package render + +import ( + "strings" + + "github.com/charmbracelet/lipgloss" +) + +// --------------------------------------------------------------------------- +// Todos (todo_renderer.py) +// --------------------------------------------------------------------------- + +var todoMarkers = map[string]string{"pending": "[ ]", "in_progress": "[~]", "done": "[•]"} + +var todoTitles = map[string]struct { + title string + color lipgloss.Color + loading string + errMsg string +}{ + "create_todo": {"Todo", Lavender, "Creating...", "Failed to create todo"}, + "list_todos": {"Todos", Lavender, "Loading...", "Unable to list todos"}, + "update_todo": {"Todo Updated", Lavender, "Updating...", "Failed to update todo"}, + "mark_todo_done": {"Todo Completed", Lavender, "Marking done...", "Failed to mark todo done"}, + "mark_todo_pending": {"Todo Reopened", AmberY, "Reopening...", "Failed to reopen todo"}, + "delete_todo": {"Todo Removed", Slate, "Removing...", "Failed to remove todo"}, +} + +func renderTodo(name string, result any) string { + meta := todoTitles[name] + var b strings.Builder + b.WriteString("📋 " + Bold(meta.color).Render(meta.title)) + if s, ok := result.(string); ok && strings.TrimSpace(s) != "" { + b.WriteString("\n " + Dim().Render(strings.TrimSpace(s))) + return b.String() + } + if m, ok := result.(map[string]any); ok { + if truthy(m["success"]) { + formatTodoLines(&b, m) + } else { + errMsg := StringValue(m["error"]) + if errMsg == "" { + errMsg = meta.errMsg + } + b.WriteString("\n " + Col(Red).Render(errMsg)) + } + } else { + b.WriteString("\n " + Dim().Render(meta.loading)) + } + return b.String() +} + +func formatTodoLines(b *strings.Builder, result map[string]any) { + todos, ok := result["todos"].([]any) + if !ok || len(todos) == 0 { + b.WriteString("\n " + Dim().Render("No todos")) + return + } + for _, t := range todos { + todo, _ := t.(map[string]any) + status := StringValue(todo["status"]) + marker := todoMarkers[status] + if marker == "" { + marker = todoMarkers["pending"] + } + title := strings.TrimSpace(StringValue(todo["title"])) + if title == "" { + title = "(untitled)" + } + b.WriteString("\n " + marker + " ") + switch status { + case "done": + b.WriteString(Dim().Strikethrough(true).Render(title)) + case "in_progress": + b.WriteString(lipgloss.NewStyle().Italic(true).Render(title)) + default: + b.WriteString(title) + } + } +} diff --git a/strix/interface/tui/live_view.py b/strix/interface/tui/live_view.py index 4401fb30..24e676fe 100644 --- a/strix/interface/tui/live_view.py +++ b/strix/interface/tui/live_view.py @@ -10,6 +10,8 @@ from typing import TYPE_CHECKING, Any if TYPE_CHECKING: from pathlib import Path +from agents.tool import ToolOutputImage + from strix.core.paths import runtime_state_dir from strix.interface.tui.history import load_session_history @@ -21,8 +23,57 @@ class TuiLiveView: self._next_event_id = 1 self._open_assistant_event_by_agent: dict[str, dict[str, Any]] = {} self._tool_event_by_agent_and_call_id: dict[tuple[str, str], dict[str, Any]] = {} + self._user_instruction: str | None = None + self._user_instruction_at: str | None = None + self._user_instruction_shown = False + + def set_user_instruction(self, text: str | None, *, timestamp: str | None = None) -> None: + """Open the transcript with what the user asked for. + + The prompt from the start screen, ``--instruction`` and + ``--instruction-file`` all reach the agent folded into its task, which the + transcript does not show. This replays it as their first message instead, + once, against the root agent - which may not exist yet, so it is held + until that agent appears. + """ + if self._user_instruction_shown or not (text or "").strip(): + return + self._user_instruction = str(text).strip() + self._user_instruction_at = timestamp + self.flush_user_instruction() + + def flush_user_instruction(self) -> bool: + """Post the held opening message once a root agent exists, once. + + Driven from wherever the agent graph is refreshed rather than from + ``upsert_agent``, which subclasses override without calling back here. + Returns whether it posted, so callers can report the change. + """ + if self._user_instruction_shown or not self._user_instruction: + return False + root_id = next( + (agent_id for agent_id, agent in self.agents.items() if agent.get("parent_id") is None), + None, + ) + if root_id is None: + return False + self._user_instruction_shown = True + self._append_event( + root_id, + "chat", + { + "role": "user", + "content": self._user_instruction, + "metadata": {"source": "user_instruction"}, + }, + timestamp=self._user_instruction_at, + ) + return True def hydrate_from_run_dir(self, run_dir: Path) -> None: + # Armed before the agents are added so the root agent's arrival puts the + # user's opening message ahead of the replayed history. + self._load_user_instruction(run_dir) state_dir = runtime_state_dir(run_dir) agents_path = state_dir / "agents.json" if not agents_path.exists(): @@ -45,14 +96,42 @@ class TuiLiveView: parent_id=parent_of.get(agent_id) if isinstance(parent_of, dict) else None, status=str(status), ) + # Ahead of the replayed history, so it opens the transcript. + self.flush_user_instruction() self._hydrate_sdk_session_history(run_dir, statuses.keys()) + def _load_user_instruction(self, run_dir: Path) -> None: + """Take the user's opening message from the run record, if it has one.""" + try: + record = json.loads((run_dir / "run.json").read_text(encoding="utf-8")) + except (OSError, json.JSONDecodeError): + return + if not isinstance(record, dict): + return + instruction = record.get("user_instruction") + if not isinstance(instruction, str): + return + start_time = record.get("start_time") + # Stamped with the run's start so it sorts ahead of replayed history. + self.set_user_instruction( + instruction, + timestamp=start_time if isinstance(start_time, str) else None, + ) + def _hydrate_sdk_session_history(self, run_dir: Path, agent_ids: Any) -> None: + # An agent's first user turn is the task it was launched with, not + # something the user typed at it, so it is replayed as context rather + # than as a message. + tasked: set[str] = set() for agent_id, item, timestamp in load_session_history(run_dir, agent_ids): + first_user_turn = agent_id not in tasked + if item.get("role") == "user" and item.get("type") in {None, "message"}: + tasked.add(agent_id) self._ingest_session_history_item( agent_id, item, timestamp=timestamp, + first_user_turn=first_user_turn, ) def upsert_agent( @@ -82,7 +161,7 @@ class TuiLiveView: current["parent_id"] = parent_id if status is not None: current["status"] = status - if error_message: + if error_message is not None: current["error_message"] = error_message current["updated_at"] = now @@ -144,22 +223,30 @@ class TuiLiveView: item: dict[str, Any], *, timestamp: str, + first_user_turn: bool = False, ) -> None: item_type = item.get("type") role = item.get("role") if role in {"user", "assistant"} and (item_type in {None, "message"}): content = _session_message_text(item) - if content: - self._append_event( - agent_id, - "chat", - { - "role": role, - "content": content, - "metadata": {"source": "sdk_session"}, - }, - timestamp=timestamp, - ) + if not content: + return + # A live run only shows what the user actually typed; the agent's + # task and the guidance the system feeds it stay out of the + # transcript. Replayed history has to make the same distinction, or + # resuming attributes all of it to the user. + if role == "user" and (first_user_turn or _is_internal_agent_turn(content)): + return + self._append_event( + agent_id, + "chat", + { + "role": role, + "content": content, + "metadata": {"source": "sdk_session"}, + }, + timestamp=timestamp, + ) return if item_type == "function_call": @@ -267,7 +354,7 @@ class TuiLiveView: ) self._tool_event_by_agent_and_call_id[event_key] = event - result = _parse_json_value(output["output"]) + result = _normalize_image_result(_parse_json_value(output["output"])) event["data"]["result"] = result event["data"]["status"] = _tool_status_from_result(result) self._bump_event(event, timestamp=timestamp) @@ -330,6 +417,35 @@ def _session_message_text(item: dict[str, Any]) -> str: return _message_content_text(item.get("content", "")) +# Guidance the system feeds an agent is injected as a user turn, which is the +# same shape a typed message takes, so replayed history cannot tell them apart by +# role alone. These are the exact openings it arrives with. Matching the full +# opening rather than just a leading bracket keeps pasted JSON, markdown links and +# a typed "[URGENT] stop" out of it. +_INTERNAL_TURN_PREFIXES = ( + # strix.core.agents._message_to_session_item: everything the coordinator + # delivers from another agent or from the system, which wraps the stall, + # terminal and budget-extension notices in strix.core.execution too. + "[Message from ", + # strix.core.inputs.child_initial_input: a subagent's parent context. + "== Inherited context from parent", + # strix.core.execution: the no-tool-call recovery nudge, both modes. + "Your previous message ended a turn without a tool call.", + "Your previous response ended the autonomous run without a lifecycle tool call.", + # strix.core.hooks: budget warnings, the only notices injected unwrapped. + *( + f"[{label}] {subject}" + for label in ("NOTICE", "URGENT", "CRITICAL") + for subject in ("Turn budget:", "Scan cost budget:") + ), +) + + +def _is_internal_agent_turn(content: str) -> bool: + """Report whether a replayed user turn is system guidance, not a typed message.""" + return content.lstrip().startswith(_INTERNAL_TURN_PREFIXES) + + def _message_content_text(content: Any) -> str: parts: list[str] = [] content_items = content if isinstance(content, list) else [content] @@ -363,6 +479,30 @@ def _parse_json_value(value: Any) -> Any: return value +def _normalize_image_result(result: Any) -> Any: + image_url = _image_url_from_result(result) + if image_url is None: + return result + return {"type": "image", "image_url": image_url} + + +def _image_url_from_result(result: Any) -> str | None: + if isinstance(result, list): + for block in result: + url = _image_url_from_result(block) + if url is not None: + return url + return None + if isinstance(result, dict): + if result.get("type") in {"image", "input_image", "output_image"}: + url = result.get("image_url") + return url if isinstance(url, str) and url.startswith("data:image/") else None + return None + if isinstance(result, ToolOutputImage) and isinstance(result.image_url, str): + return result.image_url if result.image_url.startswith("data:image/") else None + return None + + def _tool_status_from_result(result: Any) -> str: if isinstance(result, dict) and result.get("success") is False: return "failed" diff --git a/strix/interface/tui/messages.py b/strix/interface/tui/messages.py deleted file mode 100644 index 18cd37c1..00000000 --- a/strix/interface/tui/messages.py +++ /dev/null @@ -1,43 +0,0 @@ -"""Message delivery bridge from TUI input to SDK-backed agents.""" - -from __future__ import annotations - -import asyncio -import logging -from typing import Any - - -logger = logging.getLogger(__name__) - - -def send_user_message_to_agent( - *, - coordinator: Any, - loop: asyncio.AbstractEventLoop | None, - live_view: Any, - target_agent_id: str, - message: str, -) -> bool: - if loop is None or loop.is_closed(): - return False - - live_view.record_user_message(target_agent_id, message) - future = asyncio.run_coroutine_threadsafe( - coordinator.send( - target_agent_id, - {"from": "user", "content": message, "type": "instruction"}, - ), - loop, - ) - future.add_done_callback(_log_delivery_failure) - return True - - -def _log_delivery_failure(future: Any) -> None: - try: - delivered = bool(future.result()) - except Exception: - logger.exception("TUI user message delivery failed") - return - if not delivered: - logger.warning("TUI user message was not persisted to the SDK session") diff --git a/strix/interface/tui/renderers/__init__.py b/strix/interface/tui/renderers/__init__.py deleted file mode 100644 index 75f60d7b..00000000 --- a/strix/interface/tui/renderers/__init__.py +++ /dev/null @@ -1,30 +0,0 @@ -from . import ( - agents_graph_renderer, - filesystem_renderer, - finish_renderer, - load_skill_renderer, - notes_renderer, - proxy_renderer, - reporting_renderer, - shell_renderer, - thinking_renderer, - todo_renderer, - web_search_renderer, -) -from .registry import render_tool_widget - - -__all__ = [ - "agents_graph_renderer", - "filesystem_renderer", - "finish_renderer", - "load_skill_renderer", - "notes_renderer", - "proxy_renderer", - "render_tool_widget", - "reporting_renderer", - "shell_renderer", - "thinking_renderer", - "todo_renderer", - "web_search_renderer", -] diff --git a/strix/interface/tui/renderers/agent_message_renderer.py b/strix/interface/tui/renderers/agent_message_renderer.py deleted file mode 100644 index c4362804..00000000 --- a/strix/interface/tui/renderers/agent_message_renderer.py +++ /dev/null @@ -1,180 +0,0 @@ -import re -from functools import cache -from typing import Any, ClassVar - -from pygments.lexers import get_lexer_by_name, guess_lexer -from pygments.styles import get_style_by_name -from pygments.util import ClassNotFound -from rich.text import Text - - -_BLANK_LINE_RUNS = re.compile(r"\n\s*\n") - - -_HEADER_STYLES = [ - ("###### ", 7, "bold #4ade80"), - ("##### ", 6, "bold #22c55e"), - ("#### ", 5, "bold #16a34a"), - ("### ", 4, "bold #15803d"), - ("## ", 3, "bold #22c55e"), - ("# ", 2, "bold #4ade80"), -] - - -@cache -def _get_style_colors() -> dict[Any, str]: - style = get_style_by_name("native") - return {token: f"#{style_def['color']}" for token, style_def in style if style_def["color"]} - - -def _get_token_color(token_type: Any) -> str | None: - colors = _get_style_colors() - while token_type: - if token_type in colors: - return colors[token_type] - token_type = token_type.parent - return None - - -def _highlight_code(code: str, language: str | None = None) -> Text: - text = Text() - - try: - lexer = get_lexer_by_name(language) if language else guess_lexer(code) - except ClassNotFound: - text.append(code, style="#d4d4d4") - return text - - for token_type, token_value in lexer.get_tokens(code): - if not token_value: - continue - color = _get_token_color(token_type) - text.append(token_value, style=color) - - return text - - -def _try_parse_header(line: str) -> tuple[str, str] | None: - for prefix, strip_len, style in _HEADER_STYLES: - if line.startswith(prefix): - return (line[strip_len:], style) - return None - - -def _apply_markdown_styles(text: str) -> Text: # noqa: PLR0912 - result = Text() - lines = text.split("\n") - - in_code_block = False - code_block_lang: str | None = None - code_block_lines: list[str] = [] - - for i, line in enumerate(lines): - if i > 0 and not in_code_block: - result.append("\n") - - if line.startswith("```"): - if not in_code_block: - in_code_block = True - code_block_lang = line[3:].strip() or None - code_block_lines = [] - if i > 0: - result.append("\n") - else: - in_code_block = False - code_content = "\n".join(code_block_lines) - if code_content: - result.append_text(_highlight_code(code_content, code_block_lang)) - code_block_lines = [] - code_block_lang = None - continue - - if in_code_block: - code_block_lines.append(line) - continue - - header = _try_parse_header(line) - if header: - result.append(header[0], style=header[1]) - elif line.startswith("> "): - result.append("┃ ", style="#22c55e") - result.append_text(_process_inline_formatting(line[2:])) - elif line.startswith(("- ", "* ")): - result.append("• ", style="#22c55e") - result.append_text(_process_inline_formatting(line[2:])) - elif len(line) > 2 and line[0].isdigit() and line[1:3] in (". ", ") "): - result.append(line[0] + ". ", style="#22c55e") - result.append_text(_process_inline_formatting(line[2:])) - elif line.strip() in ("---", "***", "___"): - result.append("─" * 40, style="#22c55e") - else: - result.append_text(_process_inline_formatting(line)) - - if in_code_block and code_block_lines: - code_content = "\n".join(code_block_lines) - result.append_text(_highlight_code(code_content, code_block_lang)) - - return result - - -def _process_inline_formatting(line: str) -> Text: - result = Text() - i = 0 - n = len(line) - - while i < n: - if i + 1 < n and line[i : i + 2] in ("**", "__"): - marker = line[i : i + 2] - end = line.find(marker, i + 2) - if end != -1: - result.append(line[i + 2 : end], style="bold #4ade80") - i = end + 2 - continue - - if i + 1 < n and line[i : i + 2] == "~~": - end = line.find("~~", i + 2) - if end != -1: - result.append(line[i + 2 : end], style="strike #525252") - i = end + 2 - continue - - if line[i] == "`": - end = line.find("`", i + 1) - if end != -1: - result.append(line[i + 1 : end], style="bold #22c55e on #0a0a0a") - i = end + 1 - continue - - if line[i] in ("*", "_"): - marker = line[i] - if i + 1 < n and line[i + 1] != marker: - end = line.find(marker, i + 1) - if end != -1 and (end + 1 >= n or line[end + 1] != marker): - result.append(line[i + 1 : end], style="italic #86efac") - i = end + 1 - continue - - result.append(line[i]) - i += 1 - - return result - - -class AgentMessageRenderer: - _cache: ClassVar[dict[str, Text]] = {} - - @classmethod - def render_simple(cls, content: str) -> Text: - if not content: - return Text() - cleaned = _BLANK_LINE_RUNS.sub("\n\n", content).strip() - if not cleaned: - return Text() - cached = cls._cache.get(cleaned) - if cached is not None: - return cached.copy() - rendered = _apply_markdown_styles(cleaned) - if len(cls._cache) > 100: - cls._cache.clear() - cls._cache[cleaned] = rendered - return rendered.copy() diff --git a/strix/interface/tui/renderers/agents_graph_renderer.py b/strix/interface/tui/renderers/agents_graph_renderer.py deleted file mode 100644 index 92ad1d41..00000000 --- a/strix/interface/tui/renderers/agents_graph_renderer.py +++ /dev/null @@ -1,175 +0,0 @@ -from typing import Any, ClassVar - -from rich.text import Text -from textual.widgets import Static - -from .base_renderer import BaseToolRenderer -from .registry import register_tool_renderer - - -@register_tool_renderer -class ViewAgentGraphRenderer(BaseToolRenderer): - tool_name: ClassVar[str] = "view_agent_graph" - css_classes: ClassVar[list[str]] = ["tool-call", "agents-graph-tool"] - - @classmethod - def render(cls, tool_data: dict[str, Any]) -> Static: - status = tool_data.get("status", "unknown") - - text = Text() - text.append("◇ ", style="#a78bfa") - text.append("viewing agents graph", style="dim") - - css_classes = cls.get_css_classes(status) - return Static(text, classes=css_classes) - - -@register_tool_renderer -class CreateAgentRenderer(BaseToolRenderer): - tool_name: ClassVar[str] = "create_agent" - css_classes: ClassVar[list[str]] = ["tool-call", "agents-graph-tool"] - - @classmethod - def render(cls, tool_data: dict[str, Any]) -> Static: - args = tool_data.get("args", {}) - status = tool_data.get("status", "unknown") - - task = args.get("task", "") - name = args.get("name", "Agent") - - text = Text() - text.append("◈ ", style="#a78bfa") - text.append("spawning ", style="dim") - text.append(name, style="bold #a78bfa") - - if task: - text.append("\n ") - text.append(task, style="dim") - - css_classes = cls.get_css_classes(status) - return Static(text, classes=css_classes) - - -@register_tool_renderer -class SendMessageToAgentRenderer(BaseToolRenderer): - tool_name: ClassVar[str] = "send_message_to_agent" - css_classes: ClassVar[list[str]] = ["tool-call", "agents-graph-tool"] - - @classmethod - def render(cls, tool_data: dict[str, Any]) -> Static: - args = tool_data.get("args", {}) - status = tool_data.get("status", "unknown") - - message = args.get("message", "") - target_agent_id = args.get("target_agent_id", "") - - text = Text() - text.append("→ ", style="#60a5fa") - if target_agent_id: - text.append(f"to {target_agent_id}", style="dim") - else: - text.append("sending message", style="dim") - - if message: - text.append("\n ") - text.append(message, style="dim") - - css_classes = cls.get_css_classes(status) - return Static(text, classes=css_classes) - - -@register_tool_renderer -class AgentFinishRenderer(BaseToolRenderer): - tool_name: ClassVar[str] = "agent_finish" - css_classes: ClassVar[list[str]] = ["tool-call", "agents-graph-tool"] - - @classmethod - def render(cls, tool_data: dict[str, Any]) -> Static: - args = tool_data.get("args", {}) - - result_summary = args.get("result_summary", "") - findings = args.get("findings", []) - success = args.get("success", True) - - text = Text() - - if success: - text.append("◆ ", style="#22c55e") - text.append("Agent completed", style="bold #22c55e") - else: - text.append("◆ ", style="#ef4444") - text.append("Agent failed", style="bold #ef4444") - - if result_summary: - text.append("\n ") - text.append(result_summary, style="bold") - - if findings and isinstance(findings, list): - for finding in findings: - text.append("\n • ") - text.append(str(finding), style="dim") - else: - text.append("\n ") - text.append("Completing task...", style="dim") - - css_classes = cls.get_css_classes("completed") - return Static(text, classes=css_classes) - - -@register_tool_renderer -class WaitForMessageRenderer(BaseToolRenderer): - tool_name: ClassVar[str] = "wait_for_message" - css_classes: ClassVar[list[str]] = ["tool-call", "agents-graph-tool"] - - @classmethod - def render(cls, tool_data: dict[str, Any]) -> Static: - args = tool_data.get("args", {}) - status = tool_data.get("status", "unknown") - - reason = args.get("reason", "") - - text = Text() - text.append("○ ", style="#6b7280") - text.append("waiting", style="dim") - - if reason: - text.append("\n ") - text.append(reason, style="dim") - - css_classes = cls.get_css_classes(status) - return Static(text, classes=css_classes) - - -@register_tool_renderer -class StopAgentRenderer(BaseToolRenderer): - tool_name: ClassVar[str] = "stop_agent" - css_classes: ClassVar[list[str]] = ["tool-call", "agents-graph-tool"] - - @classmethod - def render(cls, tool_data: dict[str, Any]) -> Static: - args = tool_data.get("args", {}) - result = tool_data.get("result") - status = tool_data.get("status", "unknown") - - target_agent_id = args.get("target_agent_id", "") - cascade = args.get("cascade", True) - reason = args.get("reason", "") - - text = Text() - text.append("◼ ", style="#ef4444") - text.append("stopping", style="dim") - if target_agent_id: - text.append(f" {target_agent_id}", style="bold #ef4444") - if cascade: - text.append(" + descendants", style="dim italic") - - if reason: - text.append("\n ") - text.append(reason, style="dim") - - if isinstance(result, dict) and result.get("success") is False and result.get("error"): - text.append("\n ") - text.append(str(result["error"]), style="#ef4444") - - css_classes = cls.get_css_classes(status) - return Static(text, classes=css_classes) diff --git a/strix/interface/tui/renderers/base_renderer.py b/strix/interface/tui/renderers/base_renderer.py deleted file mode 100644 index aea25b22..00000000 --- a/strix/interface/tui/renderers/base_renderer.py +++ /dev/null @@ -1,30 +0,0 @@ -from abc import ABC, abstractmethod -from typing import Any, ClassVar - -from textual.widgets import Static - - -class BaseToolRenderer(ABC): - tool_name: ClassVar[str] = "" - css_classes: ClassVar[list[str]] = ["tool-call"] - - @classmethod - @abstractmethod - def render(cls, tool_data: dict[str, Any]) -> Static: - pass - - @classmethod - def status_icon(cls, status: str) -> tuple[str, str]: - icons = { - "running": ("● In progress...", "#f59e0b"), - "completed": ("✓ Done", "#22c55e"), - "failed": ("✗ Failed", "#dc2626"), - "error": ("✗ Error", "#dc2626"), - } - return icons.get(status, ("○ Unknown", "dim")) - - @classmethod - def get_css_classes(cls, status: str) -> str: - base_classes = cls.css_classes.copy() - base_classes.append(f"status-{status}") - return " ".join(base_classes) diff --git a/strix/interface/tui/renderers/filesystem_renderer.py b/strix/interface/tui/renderers/filesystem_renderer.py deleted file mode 100644 index 341addcb..00000000 --- a/strix/interface/tui/renderers/filesystem_renderer.py +++ /dev/null @@ -1,266 +0,0 @@ -from __future__ import annotations - -import json -from functools import cache -from typing import Any, ClassVar - -from pygments.lexers import get_lexer_by_name, get_lexer_for_filename -from pygments.styles import get_style_by_name -from pygments.util import ClassNotFound -from rich.text import Text -from textual.widgets import Static - -from .base_renderer import BaseToolRenderer -from .registry import register_tool_renderer - - -_ADD_FILE = "*** Add File: " -_DELETE_FILE = "*** Delete File: " -_UPDATE_FILE = "*** Update File: " -_BEGIN_PATCH = "*** Begin Patch" -_END_PATCH = "*** End Patch" - -_VIEW_IMAGE_ERROR_PREFIXES = ( - "image path ", - "unable to read image", - "manifest path", - "exceeded the allowed size", -) - - -@cache -def _get_style_colors() -> dict[Any, str]: - style = get_style_by_name("native") - return {token: f"#{style_def['color']}" for token, style_def in style if style_def["color"]} - - -def _get_lexer_for_file(path: str) -> Any: - try: - return get_lexer_for_filename(path) - except ClassNotFound: - return get_lexer_by_name("text") - - -def _get_token_color(token_type: Any) -> str | None: - colors = _get_style_colors() - while token_type: - if token_type in colors: - return colors[token_type] - token_type = token_type.parent - return None - - -def _highlight_code(code: str, path: str) -> Text: - lexer = _get_lexer_for_file(path) - text = Text() - for token_type, token_value in lexer.get_tokens(code): - if not token_value: - continue - color = _get_token_color(token_type) - text.append(token_value, style=color) - return text - - -def _extract_patch_text(args: dict[str, Any]) -> str: - """apply_patch input arrives as either {"patch": text} or raw text in - the "input" field, depending on whether the tool is wrapped as a - chat-completions FunctionTool or routed through as a CustomTool. - """ - raw = args.get("patch") - if isinstance(raw, str): - return raw - if isinstance(raw, dict): - inner = raw.get("patch") - if isinstance(inner, str): - return inner - fallback = args.get("input") if isinstance(args, dict) else None - if isinstance(fallback, str): - return fallback - return "" - - -def _parse_patch_operations( - patch_text: str, -) -> list[tuple[str, str, list[str], list[str]]]: - """Return [(kind, path, old_lines, new_lines), ...] for each file op.""" - ops: list[tuple[str, str, list[str], list[str]]] = [] - current_kind: str | None = None - current_path: str | None = None - old_lines: list[str] = [] - new_lines: list[str] = [] - - def flush() -> None: - nonlocal current_kind, current_path, old_lines, new_lines - if current_kind and current_path is not None: - ops.append((current_kind, current_path, old_lines, new_lines)) - current_kind = None - current_path = None - old_lines = [] - new_lines = [] - - for line in patch_text.splitlines(): - if line in (_BEGIN_PATCH, _END_PATCH): - continue - if line.startswith(_ADD_FILE): - flush() - current_kind = "add" - current_path = line[len(_ADD_FILE) :].strip() - elif line.startswith(_UPDATE_FILE): - flush() - current_kind = "update" - current_path = line[len(_UPDATE_FILE) :].strip() - elif line.startswith(_DELETE_FILE): - flush() - current_kind = "delete" - current_path = line[len(_DELETE_FILE) :].strip() - elif current_kind == "update": - if line.startswith("@@"): - continue - if line.startswith("-") and not line.startswith("---"): - old_lines.append(line[1:]) - elif line.startswith("+") and not line.startswith("+++"): - new_lines.append(line[1:]) - elif current_kind == "add": - if line.startswith("+"): - new_lines.append(line[1:]) - elif line.strip(): - new_lines.append(line) - flush() - return ops - - -_OP_LABEL = { - "add": "create", - "update": "edit", - "delete": "delete", -} - - -def _render_operation(text: Text, kind: str, path: str, old: list[str], new: list[str]) -> None: - label = _OP_LABEL.get(kind, "file") - - text.append("◇ ", style="#10b981") - text.append(label, style="dim") - - if path: - path_display = path[-60:] if len(path) > 60 else path - text.append(" ") - text.append(path_display, style="dim") - - if kind == "update": - if old: - highlighted_old = _highlight_code("\n".join(old), path) - for line in highlighted_old.plain.split("\n"): - text.append("\n") - text.append("-", style="#ef4444") - text.append(" ") - text.append(line) - if new: - highlighted_new = _highlight_code("\n".join(new), path) - for line in highlighted_new.plain.split("\n"): - text.append("\n") - text.append("+", style="#22c55e") - text.append(" ") - text.append(line) - elif kind == "add" and new: - text.append("\n") - text.append_text(_highlight_code("\n".join(new), path)) - - -@register_tool_renderer -class ApplyPatchRenderer(BaseToolRenderer): - tool_name: ClassVar[str] = "apply_patch" - css_classes: ClassVar[list[str]] = ["tool-call", "file-edit-tool"] - - @classmethod - def render(cls, tool_data: dict[str, Any]) -> Static: - args = tool_data.get("args", {}) - result = tool_data.get("result") - status = tool_data.get("status", "completed") - - patch_text = _extract_patch_text(args) - ops = _parse_patch_operations(patch_text) - - text = Text() - - if not ops: - text.append("◇ ", style="#10b981") - text.append("patch", style="dim") - if isinstance(result, str) and result.strip(): - text.append("\n ") - text.append(result.strip(), style="dim") - elif not result: - text.append(" ") - text.append("Processing...", style="dim") - return Static(text, classes=cls.get_css_classes(status)) - - for i, (kind, path, old, new) in enumerate(ops): - if i > 0: - text.append("\n") - _render_operation(text, kind, path, old, new) - - if status == "failed" and isinstance(result, str) and result.strip(): - text.append("\n ") - text.append(result.strip(), style="#ef4444") - - return Static(text, classes=cls.get_css_classes(status)) - - -def _is_image_success(result: Any) -> bool: - if isinstance(result, dict) and result.get("type") == "image": - return True - if isinstance(result, str): - stripped = result.lstrip() - if stripped.startswith("data:image/"): - return True - try: - obj = json.loads(stripped) - except (TypeError, ValueError): - return False - return isinstance(obj, dict) and obj.get("type") == "image" - return False - - -def _image_error_text(result: Any) -> str | None: - if not isinstance(result, str): - return None - stripped = result.strip() - if not stripped: - return None - lower = stripped.lower() - if lower.startswith(_VIEW_IMAGE_ERROR_PREFIXES) or "not a supported image" in lower: - return stripped - return None - - -@register_tool_renderer -class ViewImageRenderer(BaseToolRenderer): - tool_name: ClassVar[str] = "view_image" - css_classes: ClassVar[list[str]] = ["tool-call", "file-edit-tool"] - - @classmethod - def render(cls, tool_data: dict[str, Any]) -> Static: - args = tool_data.get("args", {}) - result = tool_data.get("result") - status = tool_data.get("status", "completed") - - path = str(args.get("path", "")).strip() - - text = Text() - text.append("◇ ", style="#10b981") - text.append("view image", style="dim") - - if path: - path_display = path[-60:] if len(path) > 60 else path - text.append(" ") - text.append(path_display, style="dim") - - err = _image_error_text(result) - if err is not None: - text.append("\n ") - text.append(err, style="#ef4444") - elif _is_image_success(result): - text.append(" ") - text.append("✓", style="#22c55e") - - return Static(text, classes=cls.get_css_classes(status)) diff --git a/strix/interface/tui/renderers/finish_renderer.py b/strix/interface/tui/renderers/finish_renderer.py deleted file mode 100644 index 62c21288..00000000 --- a/strix/interface/tui/renderers/finish_renderer.py +++ /dev/null @@ -1,65 +0,0 @@ -from typing import Any, ClassVar - -from rich.text import Text -from textual.widgets import Static - -from .base_renderer import BaseToolRenderer -from .registry import register_tool_renderer - - -FIELD_STYLE = "bold #4ade80" - - -@register_tool_renderer -class FinishScanRenderer(BaseToolRenderer): - tool_name: ClassVar[str] = "finish_scan" - css_classes: ClassVar[list[str]] = ["tool-call", "finish-tool"] - - @classmethod - def render(cls, tool_data: dict[str, Any]) -> Static: - args = tool_data.get("args", {}) - - executive_summary = args.get("executive_summary", "") - methodology = args.get("methodology", "") - technical_analysis = args.get("technical_analysis", "") - recommendations = args.get("recommendations", "") - - text = Text() - text.append("◆ ", style="#22c55e") - text.append("Penetration test completed", style="bold #22c55e") - - if executive_summary: - text.append("\n\n") - text.append("Executive Summary", style=FIELD_STYLE) - text.append("\n") - text.append(executive_summary) - - if methodology: - text.append("\n\n") - text.append("Methodology", style=FIELD_STYLE) - text.append("\n") - text.append(methodology) - - if technical_analysis: - text.append("\n\n") - text.append("Technical Analysis", style=FIELD_STYLE) - text.append("\n") - text.append(technical_analysis) - - if recommendations: - text.append("\n\n") - text.append("Recommendations", style=FIELD_STYLE) - text.append("\n") - text.append(recommendations) - - if not (executive_summary or methodology or technical_analysis or recommendations): - text.append("\n ") - text.append("Generating final report...", style="dim") - - padded = Text() - padded.append("\n\n") - padded.append_text(text) - padded.append("\n\n") - - css_classes = cls.get_css_classes("completed") - return Static(padded, classes=css_classes) diff --git a/strix/interface/tui/renderers/load_skill_renderer.py b/strix/interface/tui/renderers/load_skill_renderer.py deleted file mode 100644 index 52cde4be..00000000 --- a/strix/interface/tui/renderers/load_skill_renderer.py +++ /dev/null @@ -1,37 +0,0 @@ -from typing import Any, ClassVar - -from rich.text import Text -from textual.widgets import Static - -from .base_renderer import BaseToolRenderer -from .registry import register_tool_renderer - - -@register_tool_renderer -class LoadSkillRenderer(BaseToolRenderer): - tool_name: ClassVar[str] = "load_skill" - css_classes: ClassVar[list[str]] = ["tool-call", "load-skill-tool"] - - @classmethod - def render(cls, tool_data: dict[str, Any]) -> Static: - args = tool_data.get("args", {}) - status = tool_data.get("status", "completed") - - raw_skills = args.get("skills", "") - if isinstance(raw_skills, list): - requested = ", ".join(str(s) for s in raw_skills) - else: - requested = str(raw_skills) - - text = Text() - text.append("◇ ", style="#10b981") - text.append("loading skill", style="dim") - - if requested: - text.append(" ") - text.append(requested, style="#10b981") - elif not tool_data.get("result"): - text.append("\n ") - text.append("Loading...", style="dim") - - return Static(text, classes=cls.get_css_classes(status)) diff --git a/strix/interface/tui/renderers/notes_renderer.py b/strix/interface/tui/renderers/notes_renderer.py deleted file mode 100644 index a3e5ba44..00000000 --- a/strix/interface/tui/renderers/notes_renderer.py +++ /dev/null @@ -1,180 +0,0 @@ -from typing import Any, ClassVar - -from rich.text import Text -from textual.widgets import Static - -from .base_renderer import BaseToolRenderer -from .registry import register_tool_renderer - - -def _author_label(note: dict[str, Any]) -> str: - if note.get("by_you"): - return "you" - agent_name = note.get("agent_name") - return str(agent_name).strip() if agent_name else "" - - -@register_tool_renderer -class CreateNoteRenderer(BaseToolRenderer): - tool_name: ClassVar[str] = "create_note" - css_classes: ClassVar[list[str]] = ["tool-call", "notes-tool"] - - @classmethod - def render(cls, tool_data: dict[str, Any]) -> Static: - args = tool_data.get("args", {}) - - title = args.get("title", "") - content = args.get("content", "") - category = args.get("category", "general") - - text = Text() - text.append("◇ ", style="#fbbf24") - text.append("note", style="dim") - text.append(" ") - text.append(f"({category})", style="dim") - - if title: - text.append("\n ") - text.append(title.strip()) - - if content: - text.append("\n ") - text.append(content.strip(), style="dim") - - if not title and not content: - text.append("\n ") - text.append("Capturing...", style="dim") - - css_classes = cls.get_css_classes("completed") - return Static(text, classes=css_classes) - - -@register_tool_renderer -class DeleteNoteRenderer(BaseToolRenderer): - tool_name: ClassVar[str] = "delete_note" - css_classes: ClassVar[list[str]] = ["tool-call", "notes-tool"] - - @classmethod - def render(cls, tool_data: dict[str, Any]) -> Static: # noqa: ARG003 - text = Text() - text.append("◇ ", style="#fbbf24") - text.append("note removed", style="dim") - - css_classes = cls.get_css_classes("completed") - return Static(text, classes=css_classes) - - -@register_tool_renderer -class UpdateNoteRenderer(BaseToolRenderer): - tool_name: ClassVar[str] = "update_note" - css_classes: ClassVar[list[str]] = ["tool-call", "notes-tool"] - - @classmethod - def render(cls, tool_data: dict[str, Any]) -> Static: - args = tool_data.get("args", {}) - - title = args.get("title") - content = args.get("content") - - text = Text() - text.append("◇ ", style="#fbbf24") - text.append("note updated", style="dim") - - if title: - text.append("\n ") - text.append(title) - - if content: - text.append("\n ") - text.append(content.strip(), style="dim") - - if not title and not content: - text.append("\n ") - text.append("Updating...", style="dim") - - css_classes = cls.get_css_classes("completed") - return Static(text, classes=css_classes) - - -@register_tool_renderer -class ListNotesRenderer(BaseToolRenderer): - tool_name: ClassVar[str] = "list_notes" - css_classes: ClassVar[list[str]] = ["tool-call", "notes-tool"] - - @classmethod - def render(cls, tool_data: dict[str, Any]) -> Static: - result = tool_data.get("result") - - text = Text() - text.append("◇ ", style="#fbbf24") - text.append("notes", style="dim") - - if isinstance(result, str) and result.strip(): - text.append("\n ") - text.append(result.strip(), style="dim") - elif result and isinstance(result, dict) and result.get("success"): - count = result.get("total_count", 0) - notes = result.get("notes", []) or [] - - if count == 0: - text.append("\n ") - text.append("No notes", style="dim") - else: - for note in notes: - title = note.get("title", "").strip() or "(untitled)" - category = note.get("category", "general") - note_content = note.get("content", "").strip() - if not note_content: - note_content = note.get("content_preview", "").strip() - - text.append("\n - ") - text.append(title) - text.append(f" ({category})", style="dim") - author = _author_label(note) - if author: - text.append(f" by {author}", style="dim") - - if note_content: - text.append("\n ") - text.append(note_content, style="dim") - else: - text.append("\n ") - text.append("Loading...", style="dim") - - css_classes = cls.get_css_classes("completed") - return Static(text, classes=css_classes) - - -@register_tool_renderer -class GetNoteRenderer(BaseToolRenderer): - tool_name: ClassVar[str] = "get_note" - css_classes: ClassVar[list[str]] = ["tool-call", "notes-tool"] - - @classmethod - def render(cls, tool_data: dict[str, Any]) -> Static: - result = tool_data.get("result") - - text = Text() - text.append("◇ ", style="#fbbf24") - text.append("note read", style="dim") - - if result and isinstance(result, dict) and result.get("success"): - note = result.get("note", {}) or {} - title = str(note.get("title", "")).strip() or "(untitled)" - category = note.get("category", "general") - content = str(note.get("content", "")).strip() - text.append("\n ") - text.append(title) - text.append(f" ({category})", style="dim") - author = _author_label(note) - if author: - text.append(f" by {author}", style="dim") - if content: - text.append("\n ") - text.append(content, style="dim") - else: - text.append("\n ") - text.append("Loading...", style="dim") - - css_classes = cls.get_css_classes("completed") - return Static(text, classes=css_classes) diff --git a/strix/interface/tui/renderers/proxy_renderer.py b/strix/interface/tui/renderers/proxy_renderer.py deleted file mode 100644 index 359b494d..00000000 --- a/strix/interface/tui/renderers/proxy_renderer.py +++ /dev/null @@ -1,536 +0,0 @@ -from typing import Any, ClassVar - -from rich.text import Text -from textual.widgets import Static - -from .base_renderer import BaseToolRenderer -from .registry import register_tool_renderer - - -PROXY_ICON = "<~>" -MAX_REQUESTS_DISPLAY = 20 -MAX_LINE_LENGTH = 200 - - -def _truncate(text: str, max_len: int = 80) -> str: - return text[: max_len - 3] + "..." if len(text) > max_len else text - - -def _sanitize(text: str, max_len: int = 150) -> str: - clean = text.replace("\n", " ").replace("\r", "").replace("\t", " ") - return _truncate(clean, max_len) - - -def _status_style(code: int | None) -> str: - if code is None: - return "dim" - if 200 <= code < 300: - return "#22c55e" # green - if 300 <= code < 400: - return "#eab308" # yellow - if 400 <= code < 500: - return "#f97316" # orange - if code >= 500: - return "#ef4444" # red - return "dim" - - -@register_tool_renderer -class ListRequestsRenderer(BaseToolRenderer): - tool_name: ClassVar[str] = "list_requests" - css_classes: ClassVar[list[str]] = ["tool-call", "proxy-tool"] - - @classmethod - def render(cls, tool_data: dict[str, Any]) -> Static: # noqa: PLR0912, PLR0915 - args = tool_data.get("args", {}) - result = tool_data.get("result") - status = tool_data.get("status", "running") - - httpql_filter = args.get("httpql_filter") - sort_by = args.get("sort_by") - sort_order = args.get("sort_order") - scope_id = args.get("scope_id") - - text = Text() - text.append(PROXY_ICON, style="dim") - text.append(" listing requests", style="#06b6d4") - - if httpql_filter: - text.append(f" where {_truncate(httpql_filter, 150)}", style="dim italic") - - meta_parts = [] - if sort_by and sort_by != "timestamp": - meta_parts.append(f"by:{sort_by}") - if sort_order and sort_order != "desc": - meta_parts.append(sort_order) - if scope_id and isinstance(scope_id, str): - meta_parts.append(f"scope:{scope_id[:8]}") - if meta_parts: - text.append(f" ({', '.join(meta_parts)})", style="dim") - - if status == "completed" and isinstance(result, dict): - if "error" in result: - text.append(f" error: {_sanitize(str(result['error']), 150)}", style="#ef4444") - else: - entries = result.get("entries", []) - page_info = result.get("page_info") or {} - has_more = ( - bool(page_info.get("has_next_page")) if isinstance(page_info, dict) else False - ) - count_suffix = "+" if has_more else "" - text.append(f" [{len(entries)}{count_suffix} found]", style="dim") - - if entries and isinstance(entries, list): - text.append("\n") - for i, entry in enumerate(entries[:MAX_REQUESTS_DISPLAY]): - if not isinstance(entry, dict): - continue - req = entry.get("request") or {} - resp = entry.get("response") or {} - method = req.get("method", "?") if isinstance(req, dict) else "?" - host = req.get("host", "") if isinstance(req, dict) else "" - path = req.get("path", "/") if isinstance(req, dict) else "/" - code = resp.get("status_code") if isinstance(resp, dict) else None - - text.append(" ") - text.append(f"{method:6}", style="#a78bfa") - text.append(f" {_truncate(host + path, 180)}", style="dim") - if code: - text.append(f" {code}", style=_status_style(code)) - - if i < min(len(entries), MAX_REQUESTS_DISPLAY) - 1: - text.append("\n") - - if len(entries) > MAX_REQUESTS_DISPLAY: - text.append("\n") - text.append( - f" ... +{len(entries) - MAX_REQUESTS_DISPLAY} more", - style="dim italic", - ) - - css_classes = cls.get_css_classes(status) - return Static(text, classes=css_classes) - - -@register_tool_renderer -class ViewRequestRenderer(BaseToolRenderer): - tool_name: ClassVar[str] = "view_request" - css_classes: ClassVar[list[str]] = ["tool-call", "proxy-tool"] - - @classmethod - def render(cls, tool_data: dict[str, Any]) -> Static: # noqa: PLR0912, PLR0915 - args = tool_data.get("args", {}) - result = tool_data.get("result") - status = tool_data.get("status", "running") - - request_id = args.get("request_id", "") - part = args.get("part", "request") - search_pattern = args.get("search_pattern") - - text = Text() - text.append(PROXY_ICON, style="dim") - - action = "searching" if search_pattern else "viewing" - text.append(f" {action} {part}", style="#06b6d4") - - if request_id: - text.append(f" #{request_id}", style="dim") - - if search_pattern: - text.append(f" /{_truncate(search_pattern, 100)}/", style="dim italic") - - if status == "completed" and isinstance(result, dict): - if "error" in result: - text.append(f" error: {_sanitize(str(result['error']), 150)}", style="#ef4444") - elif "hits" in result: - hits = result.get("hits", []) - total = result.get("total_hits", len(hits)) - text.append(f" [{total} matches]", style="dim") - - if hits and isinstance(hits, list): - text.append("\n") - for i, m in enumerate(hits[:5]): - if not isinstance(m, dict): - continue - before = m.get("before", "") or "" - match_text = m.get("match", "") or "" - after = m.get("after", "") or "" - - before = before.replace("\n", " ").replace("\r", "")[-100:] - after = after.replace("\n", " ").replace("\r", "")[:100] - - text.append(" ") - - if before: - text.append(f"...{before}", style="dim") - text.append(match_text, style="#22c55e bold") - if after: - text.append(f"{after}...", style="dim") - - if i < min(len(hits), 5) - 1: - text.append("\n") - - if len(hits) > 5: - text.append("\n") - text.append(f" ... +{len(hits) - 5} more matches", style="dim italic") - - elif "content" in result: - page = result.get("page", 1) - total_lines = result.get("total_lines", 0) - has_more = result.get("has_more", False) - content = result.get("content", "") - - text.append(f" [page {page}, {total_lines} lines]", style="dim") - - if content and isinstance(content, str): - lines = content.split("\n")[:15] - text.append("\n") - for i, line in enumerate(lines): - text.append(" ") - text.append(_truncate(line, MAX_LINE_LENGTH), style="dim") - if i < len(lines) - 1: - text.append("\n") - - if has_more or len(content.split("\n")) > 15: - text.append("\n") - text.append(" ... more content available", style="dim italic") - - css_classes = cls.get_css_classes(status) - return Static(text, classes=css_classes) - - -@register_tool_renderer -class RepeatRequestRenderer(BaseToolRenderer): - tool_name: ClassVar[str] = "repeat_request" - css_classes: ClassVar[list[str]] = ["tool-call", "proxy-tool"] - - @classmethod - def render(cls, tool_data: dict[str, Any]) -> Static: # noqa: PLR0912, PLR0915 - args = tool_data.get("args", {}) - result = tool_data.get("result") - status = tool_data.get("status", "running") - - request_id = args.get("request_id", "") - modifications = args.get("modifications") - - text = Text() - text.append(PROXY_ICON, style="dim") - text.append(" repeating request", style="#06b6d4") - - if request_id: - text.append(f" #{request_id}", style="dim") - - if modifications and isinstance(modifications, dict): - text.append("\n modifications:", style="dim italic") - - if "url" in modifications: - text.append("\n") - text.append(" >> ", style="#3b82f6") - text.append(f"url: {_truncate(str(modifications['url']), 180)}", style="dim") - - if "headers" in modifications and isinstance(modifications["headers"], dict): - for k, v in list(modifications["headers"].items())[:5]: - text.append("\n") - text.append(" >> ", style="#3b82f6") - text.append(f"{k}: {_sanitize(str(v), 150)}", style="dim") - - if "cookies" in modifications and isinstance(modifications["cookies"], dict): - for k, v in list(modifications["cookies"].items())[:5]: - text.append("\n") - text.append(" >> ", style="#3b82f6") - text.append(f"cookie {k}={_sanitize(str(v), 100)}", style="dim") - - if "params" in modifications and isinstance(modifications["params"], dict): - for k, v in list(modifications["params"].items())[:5]: - text.append("\n") - text.append(" >> ", style="#3b82f6") - text.append(f"param {k}={_sanitize(str(v), 100)}", style="dim") - - if "body" in modifications and isinstance(modifications["body"], str): - text.append("\n") - text.append(" >> ", style="#3b82f6") - body_lines = modifications["body"].split("\n")[:4] - for i, line in enumerate(body_lines): - if i > 0: - text.append("\n") - text.append(" ", style="dim") - text.append(_truncate(line, MAX_LINE_LENGTH), style="dim") - if len(modifications["body"].split("\n")) > 4: - text.append(" ...", style="dim italic") - - elif modifications and isinstance(modifications, str): - text.append(f"\n {_truncate(modifications, 200)}", style="dim italic") - - if status == "completed" and isinstance(result, dict): - if not result.get("success", True) and result.get("error"): - text.append(f"\n error: {_sanitize(str(result['error']), 150)}", style="#ef4444") - else: - elapsed_ms = result.get("elapsed_ms") - response = result.get("response") or {} - code = response.get("status_code") if isinstance(response, dict) else None - body = response.get("body", "") if isinstance(response, dict) else "" - body_truncated = ( - bool(response.get("body_truncated")) if isinstance(response, dict) else False - ) - - text.append("\n") - text.append(" << ", style="#22c55e") - if code: - text.append(f"{code}", style=_status_style(code)) - else: - text.append("(no response)", style="dim") - if elapsed_ms: - text.append(f" ({elapsed_ms}ms)", style="dim") - - if body and isinstance(body, str): - lines = body.split("\n")[:5] - for line in lines: - text.append("\n") - text.append(" << ", style="#22c55e") - text.append(_truncate(line, MAX_LINE_LENGTH - 5), style="dim") - - if body_truncated or len(body.split("\n")) > 5: - text.append("\n") - text.append(" ...", style="dim italic") - - css_classes = cls.get_css_classes(status) - return Static(text, classes=css_classes) - - -@register_tool_renderer -class ListSitemapRenderer(BaseToolRenderer): - tool_name: ClassVar[str] = "list_sitemap" - css_classes: ClassVar[list[str]] = ["tool-call", "proxy-tool"] - - @classmethod - def render(cls, tool_data: dict[str, Any]) -> Static: # noqa: PLR0912, PLR0915 - args = tool_data.get("args", {}) - result = tool_data.get("result") - status = tool_data.get("status", "running") - - parent_id = args.get("parent_id") - scope_id = args.get("scope_id") - depth = args.get("depth") - - text = Text() - text.append(PROXY_ICON, style="dim") - text.append(" listing sitemap", style="#06b6d4") - - if parent_id: - text.append(f" under #{_truncate(str(parent_id), 20)}", style="dim") - - meta_parts = [] - if scope_id and isinstance(scope_id, str): - meta_parts.append(f"scope:{scope_id[:8]}") - if depth and depth != "DIRECT": - meta_parts.append(depth.lower()) - if meta_parts: - text.append(f" ({', '.join(meta_parts)})", style="dim") - - if status == "completed" and isinstance(result, dict): - if "error" in result: - text.append(f" error: {_sanitize(str(result['error']), 150)}", style="#ef4444") - else: - total = result.get("total_count", 0) - entries = result.get("entries", []) - - text.append(f" [{total} entries]", style="dim") - - if entries and isinstance(entries, list): - text.append("\n") - for i, entry in enumerate(entries[:MAX_REQUESTS_DISPLAY]): - if not isinstance(entry, dict): - continue - kind = entry.get("kind") or "?" - label = entry.get("label") or "?" - has_children = entry.get("has_descendants", False) - req = entry.get("request") or {} - - kind_style = { - "DOMAIN": "#f59e0b", - "DIRECTORY": "#3b82f6", - "REQUEST": "#22c55e", - }.get(kind, "dim") - - text.append(" ") - kind_abbr = kind[:3] if isinstance(kind, str) else "?" - text.append(f"{kind_abbr:3}", style=kind_style) - text.append(f" {_truncate(label, 150)}", style="dim") - - if req: - method = req.get("method", "") - code = req.get("status_code") - if method: - text.append(f" {method}", style="#a78bfa") - if code: - text.append(f" {code}", style=_status_style(code)) - - if has_children: - text.append(" +", style="dim italic") - - if i < min(len(entries), MAX_REQUESTS_DISPLAY) - 1: - text.append("\n") - - if len(entries) > MAX_REQUESTS_DISPLAY: - text.append("\n") - text.append( - f" ... +{len(entries) - MAX_REQUESTS_DISPLAY} more", style="dim italic" - ) - - css_classes = cls.get_css_classes(status) - return Static(text, classes=css_classes) - - -@register_tool_renderer -class ViewSitemapEntryRenderer(BaseToolRenderer): - tool_name: ClassVar[str] = "view_sitemap_entry" - css_classes: ClassVar[list[str]] = ["tool-call", "proxy-tool"] - - @classmethod - def render(cls, tool_data: dict[str, Any]) -> Static: # noqa: PLR0912 - args = tool_data.get("args", {}) - result = tool_data.get("result") - status = tool_data.get("status", "running") - - entry_id = args.get("entry_id", "") - - text = Text() - text.append(PROXY_ICON, style="dim") - text.append(" viewing sitemap", style="#06b6d4") - - if entry_id: - text.append(f" #{_truncate(str(entry_id), 20)}", style="dim") - - if status == "completed" and isinstance(result, dict): - if "error" in result: - text.append(f" error: {_sanitize(str(result['error']), 150)}", style="#ef4444") - elif "entry" in result: - entry = result.get("entry") or {} - if not isinstance(entry, dict): - entry = {} - kind = entry.get("kind", "") - label = entry.get("label", "") - related = entry.get("related_requests") or {} - related_reqs = related.get("requests", []) if isinstance(related, dict) else [] - total_related = related.get("total_count", 0) if isinstance(related, dict) else 0 - - if kind and label: - text.append(f" {kind}: {_truncate(label, 120)}", style="dim") - - if total_related: - text.append(f" [{total_related} requests]", style="dim") - - if related_reqs and isinstance(related_reqs, list): - text.append("\n") - for i, req in enumerate(related_reqs[:10]): - if not isinstance(req, dict): - continue - method = req.get("method", "?") - path = req.get("path", "/") - code = req.get("status_code") - - text.append(" ") - text.append(f"{method:6}", style="#a78bfa") - text.append(f" {_truncate(path, 180)}", style="dim") - if code: - text.append(f" {code}", style=_status_style(code)) - - if i < min(len(related_reqs), 10) - 1: - text.append("\n") - - if len(related_reqs) > 10: - text.append("\n") - text.append(f" ... +{len(related_reqs) - 10} more", style="dim italic") - - css_classes = cls.get_css_classes(status) - return Static(text, classes=css_classes) - - -@register_tool_renderer -class ScopeRulesRenderer(BaseToolRenderer): - tool_name: ClassVar[str] = "scope_rules" - css_classes: ClassVar[list[str]] = ["tool-call", "proxy-tool"] - - @classmethod - def render(cls, tool_data: dict[str, Any]) -> Static: # noqa: PLR0912, PLR0915 - args = tool_data.get("args", {}) - result = tool_data.get("result") - status = tool_data.get("status", "running") - - action = args.get("action", "") - scope_name = args.get("scope_name", "") - scope_id = args.get("scope_id", "") - allowlist = args.get("allowlist") - denylist = args.get("denylist") - - text = Text() - text.append(PROXY_ICON, style="dim") - - action_map = { - "get": "getting", - "list": "listing", - "create": "creating", - "update": "updating", - "delete": "deleting", - } - action_text = action_map.get(action, action + "ing" if action else "managing") - text.append(f" {action_text} proxy scope", style="#06b6d4") - - if scope_name: - text.append(f" '{_truncate(scope_name, 50)}'", style="dim italic") - if scope_id and isinstance(scope_id, str): - text.append(f" #{scope_id[:8]}", style="dim") - - if allowlist and isinstance(allowlist, list): - allow_str = ", ".join(_truncate(str(a), 40) for a in allowlist[:4]) - text.append(f"\n allow: {allow_str}", style="dim") - if len(allowlist) > 4: - text.append(f" +{len(allowlist) - 4}", style="dim italic") - if denylist and isinstance(denylist, list): - deny_str = ", ".join(_truncate(str(d), 40) for d in denylist[:4]) - text.append(f"\n deny: {deny_str}", style="dim") - if len(denylist) > 4: - text.append(f" +{len(denylist) - 4}", style="dim italic") - - if status == "completed" and isinstance(result, dict): - if "error" in result: - text.append(f" error: {_sanitize(str(result['error']), 150)}", style="#ef4444") - elif "scopes" in result: - scopes = result.get("scopes", []) - text.append(f" [{len(scopes)} scopes]", style="dim") - - if scopes and isinstance(scopes, list): - text.append("\n") - for i, scope in enumerate(scopes[:5]): - if not isinstance(scope, dict): - continue - name = scope.get("name", "?") - allow = scope.get("allowlist") or [] - text.append(" ") - text.append(_truncate(str(name), 40), style="#22c55e") - if allow and isinstance(allow, list): - allow_str = ", ".join(_truncate(str(a), 30) for a in allow[:3]) - text.append(f" {allow_str}", style="dim") - if len(allow) > 3: - text.append(f" +{len(allow) - 3}", style="dim italic") - if i < min(len(scopes), 5) - 1: - text.append("\n") - - elif "scope" in result: - scope = result.get("scope") or {} - if isinstance(scope, dict): - allow = scope.get("allowlist") or [] - deny = scope.get("denylist") or [] - - if allow and isinstance(allow, list): - allow_str = ", ".join(_truncate(str(a), 40) for a in allow[:5]) - text.append(f"\n allow: {allow_str}", style="dim") - if deny and isinstance(deny, list): - deny_str = ", ".join(_truncate(str(d), 40) for d in deny[:5]) - text.append(f"\n deny: {deny_str}", style="dim") - - elif "message" in result: - text.append(f" {result['message']}", style="#22c55e") - - css_classes = cls.get_css_classes(status) - return Static(text, classes=css_classes) diff --git a/strix/interface/tui/renderers/registry.py b/strix/interface/tui/renderers/registry.py deleted file mode 100644 index a9849b2d..00000000 --- a/strix/interface/tui/renderers/registry.py +++ /dev/null @@ -1,71 +0,0 @@ -from typing import Any, ClassVar - -from rich.text import Text -from textual.widgets import Static - -from .base_renderer import BaseToolRenderer - - -class ToolTUIRegistry: - _renderers: ClassVar[dict[str, type[BaseToolRenderer]]] = {} - - @classmethod - def register(cls, renderer_class: type[BaseToolRenderer]) -> None: - if not renderer_class.tool_name: - raise ValueError(f"Renderer {renderer_class.__name__} must define tool_name") - - cls._renderers[renderer_class.tool_name] = renderer_class - - @classmethod - def get_renderer(cls, tool_name: str) -> type[BaseToolRenderer] | None: - return cls._renderers.get(tool_name) - - -def register_tool_renderer(renderer_class: type[BaseToolRenderer]) -> type[BaseToolRenderer]: - ToolTUIRegistry.register(renderer_class) - return renderer_class - - -def get_tool_renderer(tool_name: str) -> type[BaseToolRenderer] | None: - return ToolTUIRegistry.get_renderer(tool_name) - - -def render_tool_widget(tool_data: dict[str, Any]) -> Static: - tool_name = tool_data.get("tool_name", "") - renderer = get_tool_renderer(tool_name) - - if renderer: - return renderer.render(tool_data) - return _render_default_tool_widget(tool_data) - - -def _render_default_tool_widget(tool_data: dict[str, Any]) -> Static: - tool_name = tool_data.get("tool_name", "Unknown Tool") - args = tool_data.get("args", {}) - status = tool_data.get("status", "unknown") - result = tool_data.get("result") - - text = Text() - - text.append("→ Using tool ", style="dim") - text.append(tool_name, style="bold blue") - text.append("\n") - - for k, v in list(args.items()): - str_v = str(v) - text.append(" ") - text.append(k, style="dim") - text.append(": ") - text.append(str_v) - text.append("\n") - - if status in ["completed", "failed", "error"] and result is not None: - result_str = str(result) - text.append("Result: ", style="bold") - text.append(result_str) - else: - icon, color = BaseToolRenderer.status_icon(status) - text.append(icon, style=color) - - css_classes = BaseToolRenderer.get_css_classes(status) - return Static(text, classes=css_classes) diff --git a/strix/interface/tui/renderers/reporting_renderer.py b/strix/interface/tui/renderers/reporting_renderer.py deleted file mode 100644 index 49c6f96e..00000000 --- a/strix/interface/tui/renderers/reporting_renderer.py +++ /dev/null @@ -1,547 +0,0 @@ -from functools import cache -from typing import Any, ClassVar - -from pygments.styles import get_style_by_name -from rich.text import Text -from textual.widgets import Static - -from strix.report.writer import parse_fenced_code, resolve_lexer - -from .base_renderer import BaseToolRenderer -from .registry import register_tool_renderer - - -def _coerce_dict(value: Any) -> dict[str, Any]: - if isinstance(value, dict): - return value - return {} - - -def _coerce_list_of_dicts(value: Any) -> list[dict[str, Any]]: - if isinstance(value, list): - return [item for item in value if isinstance(item, dict)] - return [] - - -@cache -def _get_style_colors() -> dict[Any, str]: - style = get_style_by_name("native") - return {token: f"#{style_def['color']}" for token, style_def in style if style_def["color"]} - - -FIELD_STYLE = "bold #4ade80" -DIM_STYLE = "dim" -FILE_STYLE = "bold #60a5fa" -LINE_STYLE = "#facc15" -LABEL_STYLE = "italic #a1a1aa" -CODE_STYLE = "#e2e8f0" -BEFORE_STYLE = "#ef4444" -AFTER_STYLE = "#22c55e" - - -@register_tool_renderer -class CreateVulnerabilityReportRenderer(BaseToolRenderer): - tool_name: ClassVar[str] = "create_vulnerability_report" - css_classes: ClassVar[list[str]] = ["tool-call", "reporting-tool"] - - SEVERITY_COLORS: ClassVar[dict[str, str]] = { - "critical": "#dc2626", - "high": "#ea580c", - "medium": "#d97706", - "low": "#65a30d", - "info": "#0284c7", - } - - @classmethod - def _get_token_color(cls, token_type: Any) -> str | None: - colors = _get_style_colors() - while token_type: - if token_type in colors: - return colors[token_type] - token_type = token_type.parent - return None - - @classmethod - def _highlight_code(cls, code: str, language: str | None) -> Text: - lexer = resolve_lexer(language, code) - text = Text() - - for token_type, token_value in lexer.get_tokens(code): - if not token_value: - continue - color = cls._get_token_color(token_type) - text.append(token_value, style=color) - - return text - - @classmethod - def _get_cvss_color(cls, cvss_score: float) -> str: - if cvss_score >= 9.0: - return "#dc2626" - if cvss_score >= 7.0: - return "#ea580c" - if cvss_score >= 4.0: - return "#d97706" - if cvss_score >= 0.1: - return "#65a30d" - return "#6b7280" - - @classmethod - def render(cls, tool_data: dict[str, Any]) -> Static: # noqa: PLR0912, PLR0915 - args = tool_data.get("args", {}) - result = tool_data.get("result", {}) - - title = args.get("title", "") - description = args.get("description", "") - impact = args.get("impact", "") - target = args.get("target", "") - technical_analysis = args.get("technical_analysis", "") - poc_description = args.get("poc_description", "") - poc_script_code = args.get("poc_script_code", "") - remediation_steps = args.get("remediation_steps", "") - - cvss_breakdown = _coerce_dict(args.get("cvss_breakdown")) - code_locations = _coerce_list_of_dicts(args.get("code_locations")) - - endpoint = args.get("endpoint", "") - method = args.get("method", "") - cve = args.get("cve", "") - cwe = args.get("cwe", "") - - severity = "" - cvss_score = None - if isinstance(result, dict): - severity = result.get("severity", "") - cvss_score = result.get("cvss_score") - - text = Text() - text.append("🐞 ") - text.append("Vulnerability Report", style="bold #ea580c") - - if title: - text.append("\n\n") - text.append("Title: ", style=FIELD_STYLE) - text.append(title) - - if severity: - text.append("\n\n") - text.append("Severity: ", style=FIELD_STYLE) - severity_color = cls.SEVERITY_COLORS.get(severity.lower(), "#6b7280") - text.append(severity.upper(), style=f"bold {severity_color}") - - if cvss_score is not None: - text.append("\n\n") - text.append("CVSS Score: ", style=FIELD_STYLE) - cvss_color = cls._get_cvss_color(cvss_score) - text.append(str(cvss_score), style=f"bold {cvss_color}") - - if target: - text.append("\n\n") - text.append("Target: ", style=FIELD_STYLE) - text.append(target) - - if endpoint: - text.append("\n\n") - text.append("Endpoint: ", style=FIELD_STYLE) - text.append(endpoint) - - if method: - text.append("\n\n") - text.append("Method: ", style=FIELD_STYLE) - text.append(method) - - if cve: - text.append("\n\n") - text.append("CVE: ", style=FIELD_STYLE) - text.append(cve) - - if cwe: - text.append("\n\n") - text.append("CWE: ", style=FIELD_STYLE) - text.append(cwe) - - if cvss_breakdown: - text.append("\n\n") - cvss_parts = [] - for key, prefix in [ - ("attack_vector", "AV"), - ("attack_complexity", "AC"), - ("privileges_required", "PR"), - ("user_interaction", "UI"), - ("scope", "S"), - ("confidentiality", "C"), - ("integrity", "I"), - ("availability", "A"), - ]: - val = cvss_breakdown.get(key) - if val: - cvss_parts.append(f"{prefix}:{val}") - text.append("CVSS Vector: ", style=FIELD_STYLE) - text.append("/".join(cvss_parts), style=DIM_STYLE) - - if description: - text.append("\n\n") - text.append("Description", style=FIELD_STYLE) - text.append("\n") - text.append(description) - - if impact: - text.append("\n\n") - text.append("Impact", style=FIELD_STYLE) - text.append("\n") - text.append(impact) - - if technical_analysis: - text.append("\n\n") - text.append("Technical Analysis", style=FIELD_STYLE) - text.append("\n") - text.append(technical_analysis) - - if code_locations: - text.append("\n\n") - text.append("Code Locations", style=FIELD_STYLE) - for i, loc in enumerate(code_locations): - text.append("\n\n") - text.append(f" Location {i + 1}: ", style=DIM_STYLE) - text.append(loc.get("file", "unknown"), style=FILE_STYLE) - start = loc.get("start_line") - end = loc.get("end_line") - if start is not None: - if end and end != start: - text.append(f":{start}-{end}", style=LINE_STYLE) - else: - text.append(f":{start}", style=LINE_STYLE) - if loc.get("label"): - text.append(f"\n {loc['label']}", style=LABEL_STYLE) - if loc.get("snippet"): - text.append("\n ") - text.append(loc["snippet"], style=CODE_STYLE) - if loc.get("fix_before") or loc.get("fix_after"): - text.append("\n ") - text.append("Fix:", style=DIM_STYLE) - if loc.get("fix_before"): - text.append("\n ") - text.append("- ", style=BEFORE_STYLE) - text.append(loc["fix_before"], style=BEFORE_STYLE) - if loc.get("fix_after"): - text.append("\n ") - text.append("+ ", style=AFTER_STYLE) - text.append(loc["fix_after"], style=AFTER_STYLE) - - if poc_description: - text.append("\n\n") - text.append("PoC Description", style=FIELD_STYLE) - text.append("\n") - text.append(poc_description) - - if poc_script_code: - poc_language, poc_code = parse_fenced_code(poc_script_code) - text.append("\n\n") - text.append("PoC Code", style=FIELD_STYLE) - text.append("\n") - text.append_text(cls._highlight_code(poc_code, poc_language)) - - if remediation_steps: - text.append("\n\n") - text.append("Remediation", style=FIELD_STYLE) - text.append("\n") - text.append(remediation_steps) - - if not title: - text.append("\n ") - text.append("Creating report...", style="dim") - - padded = Text() - padded.append("\n\n") - padded.append_text(text) - padded.append("\n\n") - - css_classes = cls.get_css_classes("completed") - return Static(padded, classes=css_classes) - - -@register_tool_renderer -class CreateDependencyReportRenderer(BaseToolRenderer): - tool_name: ClassVar[str] = "create_dependency_report" - css_classes: ClassVar[list[str]] = ["tool-call", "reporting-tool"] - - SEVERITY_COLORS: ClassVar[dict[str, str]] = { - "critical": "#dc2626", - "high": "#ea580c", - "medium": "#d97706", - "low": "#65a30d", - "info": "#0284c7", - } - - @classmethod - def _get_cvss_color(cls, cvss_score: float) -> str: - if cvss_score >= 9.0: - return "#dc2626" - if cvss_score >= 7.0: - return "#ea580c" - if cvss_score >= 4.0: - return "#d97706" - if cvss_score >= 0.1: - return "#65a30d" - return "#6b7280" - - @classmethod - def _render_unsuccessful(cls, args: dict[str, Any], result: dict[str, Any]) -> Static: - text = Text() - text.append("📦 ") - text.append("Dependency (SCA) Report", style="bold #ea580c") - title = args.get("title", "") - if title: - text.append("\n\n") - text.append("Title: ", style=FIELD_STYLE) - text.append(title) - - warning = result.get("warning") - if result.get("success") is False: - errors = result.get("errors") - detail = ( - "; ".join(errors) if isinstance(errors, list) and errors else result.get("error") - ) - label, style = "✗ Not created: ", "bold #dc2626" - fallback = "Report was not created." - else: - detail = warning - label, style = "⚠ Not persisted: ", "bold #d97706" - fallback = "Report could not be persisted." - text.append("\n\n") - text.append(label, style=style) - text.append(str(detail or fallback)) - - padded = Text() - padded.append("\n\n") - padded.append_text(text) - padded.append("\n\n") - return Static(padded, classes=cls.get_css_classes("failed")) - - @classmethod - def render(cls, tool_data: dict[str, Any]) -> Static: # noqa: PLR0912, PLR0915 - args = tool_data.get("args", {}) - result = tool_data.get("result", {}) - - if isinstance(result, dict) and (result.get("success") is False or result.get("warning")): - return cls._render_unsuccessful(args, result) - - title = args.get("title", "") - description = args.get("description", "") - impact = args.get("impact", "") - target = args.get("target", "") - technical_analysis = args.get("technical_analysis", "") - remediation_steps = args.get("remediation_steps", "") - assumptions = args.get("assumptions", "") - - package_name = args.get("package_name", "") - package_ecosystem = args.get("package_ecosystem", "") - installed_version = args.get("installed_version", "") - fixed_version = args.get("fixed_version", "") - cve = args.get("cve", "") - cwe = args.get("cwe", "") - advisory_cvss = args.get("advisory_cvss") - fix_effort = args.get("fix_effort", "") - - severity = "" - if isinstance(result, dict): - severity = result.get("severity", "") - - text = Text() - text.append("📦 ") - text.append("Dependency (SCA) Report", style="bold #ea580c") - - if title: - text.append("\n\n") - text.append("Title: ", style=FIELD_STYLE) - text.append(title) - - if severity: - text.append("\n\n") - text.append("Severity: ", style=FIELD_STYLE) - severity_color = cls.SEVERITY_COLORS.get(severity.lower(), "#6b7280") - text.append(severity.upper(), style=f"bold {severity_color}") - - if advisory_cvss is not None: - text.append("\n\n") - text.append("Advisory CVSS: ", style=FIELD_STYLE) - try: - score = float(advisory_cvss) - text.append(str(score), style=f"bold {cls._get_cvss_color(score)}") - except (TypeError, ValueError): - text.append(str(advisory_cvss), style=DIM_STYLE) - - if cve: - text.append("\n\n") - text.append("CVE: ", style=FIELD_STYLE) - text.append(cve) - - if cwe: - text.append("\n\n") - text.append("CWE: ", style=FIELD_STYLE) - text.append(cwe) - - if package_name: - text.append("\n\n") - text.append("Package: ", style=FIELD_STYLE) - text.append(package_name, style=FILE_STYLE) - if package_ecosystem: - text.append(f" ({package_ecosystem})", style=DIM_STYLE) - - if installed_version: - text.append("\n\n") - text.append("Installed: ", style=FIELD_STYLE) - text.append(installed_version, style=BEFORE_STYLE) - if fixed_version: - text.append(" → ", style=DIM_STYLE) - text.append("Fixed: ", style=FIELD_STYLE) - text.append(fixed_version, style=AFTER_STYLE) - - if fix_effort: - text.append("\n\n") - text.append("Fix Effort: ", style=FIELD_STYLE) - text.append(fix_effort) - - if target: - text.append("\n\n") - text.append("Target: ", style=FIELD_STYLE) - text.append(target) - - for label, value in [ - ("Description", description), - ("Impact", impact), - ("Technical Analysis", technical_analysis), - ("Assumptions", assumptions), - ("Remediation", remediation_steps), - ]: - if value: - text.append("\n\n") - text.append(label, style=FIELD_STYLE) - text.append("\n") - text.append(value) - - if not title: - text.append("\n ") - text.append("Creating dependency report...", style="dim") - - padded = Text() - padded.append("\n\n") - padded.append_text(text) - padded.append("\n\n") - - css_classes = cls.get_css_classes("completed") - return Static(padded, classes=css_classes) - - -_LIST_SEVERITY_COLORS = { - "critical": "#dc2626", - "high": "#ea580c", - "medium": "#d97706", - "low": "#65a30d", - "info": "#0284c7", - "none": "#6b7280", -} - - -def _severity_style(severity: Any) -> str: - return _LIST_SEVERITY_COLORS.get(str(severity or "").lower(), "#d97706") - - -def _author_label(report: dict[str, Any]) -> str: - if report.get("by_you"): - return "you" - agent_name = report.get("agent_name") - return str(agent_name).strip() if agent_name else "" - - -@register_tool_renderer -class ListReportsRenderer(BaseToolRenderer): - tool_name: ClassVar[str] = "list_reports" - css_classes: ClassVar[list[str]] = ["tool-call", "reporting-tool"] - - @classmethod - def render(cls, tool_data: dict[str, Any]) -> Static: - result = _coerce_dict(tool_data.get("result")) - - text = Text() - text.append("◆ ", style="#ef4444") - text.append("reports", style="dim") - - if isinstance(tool_data.get("result"), str) and str(tool_data["result"]).strip(): - text.append("\n ") - text.append(str(tool_data["result"]).strip(), style="dim") - elif result.get("success"): - total = result.get("total_count", 0) - reports = _coerce_list_of_dicts(result.get("reports")) - counts = _coerce_dict(result.get("severity_counts")) - - text.append(f" ({total})", style="dim") - for sev, count in counts.items(): - text.append(" ") - text.append(f"{sev} {count}", style=_severity_style(sev)) - - if not reports: - text.append("\n ") - text.append("No reports filed yet", style="dim") - else: - for report in reports: - rid = str(report.get("id", "")).strip() - title = str(report.get("title", "")).strip() or "(untitled)" - severity = str(report.get("severity", "")).strip() - text.append("\n - ") - if severity: - text.append(severity.upper(), style=f"bold {_severity_style(severity)}") - text.append(" ") - if rid: - text.append(f"{rid} ", style="dim") - text.append(title) - author = _author_label(report) - if author: - text.append(f" ({author})", style="dim") - else: - text.append("\n ") - text.append("Loading...", style="dim") - - css_classes = cls.get_css_classes("completed") - return Static(text, classes=css_classes) - - -@register_tool_renderer -class GetReportRenderer(BaseToolRenderer): - tool_name: ClassVar[str] = "get_report" - css_classes: ClassVar[list[str]] = ["tool-call", "reporting-tool"] - - @classmethod - def render(cls, tool_data: dict[str, Any]) -> Static: - result = _coerce_dict(tool_data.get("result")) - - text = Text() - text.append("◆ ", style="#ef4444") - text.append("report read", style="dim") - - report = _coerce_dict(result.get("report")) if result.get("success") else {} - if report: - rid = str(report.get("id", "")).strip() - title = str(report.get("title", "")).strip() or "(untitled)" - severity = str(report.get("severity", "")).strip() - text.append("\n ") - if severity: - text.append(severity.upper(), style=f"bold {_severity_style(severity)}") - text.append(" ") - if rid: - text.append(f"{rid} ", style="dim") - text.append(title) - author = _author_label(report) - if author: - text.append(f" ({author})", style="dim") - target = str(report.get("target", "")).strip() - if target: - text.append("\n ") - text.append(target, style="dim") - else: - text.append("\n ") - detail = result.get("error") if result.get("success") is False else None - text.append(str(detail) if detail else "Loading...", style="dim") - - css_classes = cls.get_css_classes("completed") - return Static(text, classes=css_classes) diff --git a/strix/interface/tui/renderers/shell_renderer.py b/strix/interface/tui/renderers/shell_renderer.py deleted file mode 100644 index 22a6ec13..00000000 --- a/strix/interface/tui/renderers/shell_renderer.py +++ /dev/null @@ -1,266 +0,0 @@ -import re -from functools import cache -from typing import Any, ClassVar - -from pygments.lexers import get_lexer_by_name -from pygments.styles import get_style_by_name -from rich.text import Text -from textual.widgets import Static - -from .base_renderer import BaseToolRenderer -from .registry import register_tool_renderer - - -MAX_OUTPUT_LINES = 50 -MAX_LINE_LENGTH = 200 - -STRIP_PATTERNS = [ - r"^Chunk ID: [0-9a-f]+\s*$", - r"^Wall time: [\d.]+ seconds\s*$", - r"^Process exited with code -?\d+\s*$", - r"^Process running with session ID \d+\s*$", - r"^Original token count: \d+\s*$", -] - -_EXIT_RE = re.compile(r"Process exited with code (-?\d+)") -_SESSION_RE = re.compile(r"Process running with session ID (\d+)") -_OUTPUT_HEADER = "\nOutput:\n" - -_CONTROL_BYTES_TO_DROP = dict.fromkeys( - [b for b in range(0x20) if b not in (0x09, 0x0A)] + [0x7F], - None, -) - - -@cache -def _get_style_colors() -> dict[Any, str]: - style = get_style_by_name("native") - return {token: f"#{style_def['color']}" for token, style_def in style if style_def["color"]} - - -def _parse_sdk_shell_result(result: Any) -> dict[str, Any]: - """Translate the SDK's terminal-output string into the dict shape the - renderer's `_append_output` helper expects. - - The SDK returns a header-prefixed string ending with `Output:\\n`. - We extract `content`, `exit_code`, and `session_id`; anything else (or a - non-string result) flows through unchanged so renderers can handle errors. - """ - if isinstance(result, dict): - return result - if not isinstance(result, str): - return {"content": "" if result is None else str(result)} - - exit_match = _EXIT_RE.search(result) - session_match = _SESSION_RE.search(result) - idx = result.find(_OUTPUT_HEADER) - content = result[idx + len(_OUTPUT_HEADER) :] if idx >= 0 else result - - parsed: dict[str, Any] = {"content": content} - if exit_match: - parsed["exit_code"] = int(exit_match.group(1)) - if session_match: - parsed["session_id"] = int(session_match.group(1)) - return parsed - - -def _truncate_line(line: str) -> str: - if len(line) > MAX_LINE_LENGTH: - return line[: MAX_LINE_LENGTH - 3] + "..." - return line - - -def _clean_output(output: str) -> str: - cleaned: str = Text.from_ansi(output).plain.translate(_CONTROL_BYTES_TO_DROP) - for pattern in STRIP_PATTERNS: - cleaned = re.sub(pattern, "", cleaned, flags=re.MULTILINE) - - if cleaned.strip(): - lines = cleaned.splitlines() - filtered_lines: list[str] = [] - for line in lines: - if not filtered_lines and not line.strip(): - continue - if line.strip() == "Output:": - continue - filtered_lines.append(line) - while filtered_lines and not filtered_lines[-1].strip(): - filtered_lines.pop() - cleaned = "\n".join(filtered_lines) - - return cleaned.strip() - - -def _format_output(output: str) -> Text: - text = Text() - lines = output.splitlines() - total_lines = len(lines) - - head_count = MAX_OUTPUT_LINES // 2 - tail_count = MAX_OUTPUT_LINES - head_count - 1 - - if total_lines <= MAX_OUTPUT_LINES: - display_lines = lines - truncated = False - hidden_count = 0 - else: - display_lines = lines[:head_count] - truncated = True - hidden_count = total_lines - head_count - tail_count - - for i, line in enumerate(display_lines): - text.append(" ") - text.append(_truncate_line(line), style="dim") - if i < len(display_lines) - 1 or truncated: - text.append("\n") - - if truncated: - text.append(f" ... {hidden_count} lines truncated ...", style="dim italic") - text.append("\n") - tail_lines = lines[-tail_count:] - for i, line in enumerate(tail_lines): - text.append(" ") - text.append(_truncate_line(line), style="dim") - if i < len(tail_lines) - 1: - text.append("\n") - - return text - - -def _get_token_color(token_type: Any) -> str | None: - colors = _get_style_colors() - while token_type: - if token_type in colors: - return colors[token_type] - token_type = token_type.parent - return None - - -def _highlight_bash(code: str) -> Text: - lexer = get_lexer_by_name("bash") - text = Text() - for token_type, token_value in lexer.get_tokens(code): - if not token_value: - continue - color = _get_token_color(token_type) - text.append(token_value, style=color) - return text - - -def _append_output(text: Text, parsed: dict[str, Any], tool_status: str) -> None: - raw_output = parsed.get("content", "") or "" - output = _clean_output(raw_output) if isinstance(raw_output, str) else "" - exit_code = parsed.get("exit_code") - - if tool_status == "running": - if output: - text.append("\n") - text.append_text(_format_output(output)) - return - - if not output: - if exit_code is not None and exit_code != 0: - text.append("\n") - text.append(f" exit {exit_code}", style="dim #ef4444") - return - - text.append("\n") - text.append_text(_format_output(output)) - - if exit_code is not None and exit_code != 0: - text.append("\n") - text.append(f" exit {exit_code}", style="dim #ef4444") - - -def _build_terminal_content( - *, - prompt: str, - prompt_style: str, - command: str, - parsed_result: dict[str, Any] | None, - tool_status: str, - meta: str | None = None, -) -> Text: - text = Text() - text.append(">_", style="dim") - text.append(" ") - - if not command.strip(): - text.append("getting logs...", style="dim") - else: - text.append(prompt, style=prompt_style) - text.append(" ") - text.append_text(_highlight_bash(command)) - - if meta: - text.append(f" {meta}", style="dim") - - if parsed_result is not None: - _append_output(text, parsed_result, tool_status) - - return text - - -@register_tool_renderer -class ExecCommandRenderer(BaseToolRenderer): - tool_name: ClassVar[str] = "exec_command" - css_classes: ClassVar[list[str]] = ["tool-call", "terminal-tool"] - - @classmethod - def render(cls, tool_data: dict[str, Any]) -> Static: - args = tool_data.get("args", {}) - status = tool_data.get("status", "unknown") - result = tool_data.get("result") - - cmd = str(args.get("cmd", "")) - workdir = args.get("workdir") - tty = bool(args.get("tty")) - - meta_parts: list[str] = [] - if workdir: - meta_parts.append(f"cwd:{workdir}") - if tty: - meta_parts.append("tty") - meta = ", ".join(meta_parts) if meta_parts else None - - parsed = _parse_sdk_shell_result(result) if result is not None else None - - content = _build_terminal_content( - prompt="$", - prompt_style="#22c55e", - command=cmd, - parsed_result=parsed, - tool_status=status, - meta=meta, - ) - - return Static(content, classes=cls.get_css_classes(status)) - - -@register_tool_renderer -class WriteStdinRenderer(BaseToolRenderer): - tool_name: ClassVar[str] = "write_stdin" - css_classes: ClassVar[list[str]] = ["tool-call", "terminal-tool"] - - @classmethod - def render(cls, tool_data: dict[str, Any]) -> Static: - args = tool_data.get("args", {}) - status = tool_data.get("status", "unknown") - result = tool_data.get("result") - - chars = str(args.get("chars", "")) - session_id = args.get("session_id") - meta = f"session #{session_id}" if session_id is not None else None - - parsed = _parse_sdk_shell_result(result) if result is not None else None - - content = _build_terminal_content( - prompt=">>>", - prompt_style="#3b82f6", - command=chars, - parsed_result=parsed, - tool_status=status, - meta=meta, - ) - - return Static(content, classes=cls.get_css_classes(status)) diff --git a/strix/interface/tui/renderers/thinking_renderer.py b/strix/interface/tui/renderers/thinking_renderer.py deleted file mode 100644 index 598bdf33..00000000 --- a/strix/interface/tui/renderers/thinking_renderer.py +++ /dev/null @@ -1,31 +0,0 @@ -from typing import Any, ClassVar - -from rich.text import Text -from textual.widgets import Static - -from .base_renderer import BaseToolRenderer -from .registry import register_tool_renderer - - -@register_tool_renderer -class ThinkRenderer(BaseToolRenderer): - tool_name: ClassVar[str] = "think" - css_classes: ClassVar[list[str]] = ["tool-call", "thinking-tool"] - - @classmethod - def render(cls, tool_data: dict[str, Any]) -> Static: - args = tool_data.get("args", {}) - thought = args.get("thought", "") - - text = Text() - text.append("🧠 ") - text.append("Thinking", style="bold #a855f7") - text.append("\n ") - - if thought: - text.append(thought, style="italic dim") - else: - text.append("Thinking...", style="italic dim") - - css_classes = cls.get_css_classes("completed") - return Static(text, classes=css_classes) diff --git a/strix/interface/tui/renderers/todo_renderer.py b/strix/interface/tui/renderers/todo_renderer.py deleted file mode 100644 index d166864b..00000000 --- a/strix/interface/tui/renderers/todo_renderer.py +++ /dev/null @@ -1,225 +0,0 @@ -from typing import Any, ClassVar - -from rich.text import Text -from textual.widgets import Static - -from .base_renderer import BaseToolRenderer -from .registry import register_tool_renderer - - -STATUS_MARKERS: dict[str, str] = { - "pending": "[ ]", - "in_progress": "[~]", - "done": "[•]", -} - - -def _format_todo_lines(text: Text, result: dict[str, Any]) -> None: - todos = result.get("todos") - if not isinstance(todos, list) or not todos: - text.append("\n ") - text.append("No todos", style="dim") - return - - for todo in todos: - status = todo.get("status", "pending") - marker = STATUS_MARKERS.get(status, STATUS_MARKERS["pending"]) - - title = todo.get("title", "").strip() or "(untitled)" - - text.append("\n ") - text.append(marker) - text.append(" ") - - if status == "done": - text.append(title, style="dim strike") - elif status == "in_progress": - text.append(title, style="italic") - else: - text.append(title) - - -@register_tool_renderer -class CreateTodoRenderer(BaseToolRenderer): - tool_name: ClassVar[str] = "create_todo" - css_classes: ClassVar[list[str]] = ["tool-call", "todo-tool"] - - @classmethod - def render(cls, tool_data: dict[str, Any]) -> Static: - result = tool_data.get("result") - - text = Text() - text.append("📋 ") - text.append("Todo", style="bold #a78bfa") - - if isinstance(result, str) and result.strip(): - text.append("\n ") - text.append(result.strip(), style="dim") - elif result and isinstance(result, dict): - if result.get("success"): - _format_todo_lines(text, result) - else: - error = result.get("error", "Failed to create todo") - text.append("\n ") - text.append(error, style="#ef4444") - else: - text.append("\n ") - text.append("Creating...", style="dim") - - css_classes = cls.get_css_classes("completed") - return Static(text, classes=css_classes) - - -@register_tool_renderer -class ListTodosRenderer(BaseToolRenderer): - tool_name: ClassVar[str] = "list_todos" - css_classes: ClassVar[list[str]] = ["tool-call", "todo-tool"] - - @classmethod - def render(cls, tool_data: dict[str, Any]) -> Static: - result = tool_data.get("result") - - text = Text() - text.append("📋 ") - text.append("Todos", style="bold #a78bfa") - - if isinstance(result, str) and result.strip(): - text.append("\n ") - text.append(result.strip(), style="dim") - elif result and isinstance(result, dict): - if result.get("success"): - _format_todo_lines(text, result) - else: - error = result.get("error", "Unable to list todos") - text.append("\n ") - text.append(error, style="#ef4444") - else: - text.append("\n ") - text.append("Loading...", style="dim") - - css_classes = cls.get_css_classes("completed") - return Static(text, classes=css_classes) - - -@register_tool_renderer -class UpdateTodoRenderer(BaseToolRenderer): - tool_name: ClassVar[str] = "update_todo" - css_classes: ClassVar[list[str]] = ["tool-call", "todo-tool"] - - @classmethod - def render(cls, tool_data: dict[str, Any]) -> Static: - result = tool_data.get("result") - - text = Text() - text.append("📋 ") - text.append("Todo Updated", style="bold #a78bfa") - - if isinstance(result, str) and result.strip(): - text.append("\n ") - text.append(result.strip(), style="dim") - elif result and isinstance(result, dict): - if result.get("success"): - _format_todo_lines(text, result) - else: - error = result.get("error", "Failed to update todo") - text.append("\n ") - text.append(error, style="#ef4444") - else: - text.append("\n ") - text.append("Updating...", style="dim") - - css_classes = cls.get_css_classes("completed") - return Static(text, classes=css_classes) - - -@register_tool_renderer -class MarkTodoDoneRenderer(BaseToolRenderer): - tool_name: ClassVar[str] = "mark_todo_done" - css_classes: ClassVar[list[str]] = ["tool-call", "todo-tool"] - - @classmethod - def render(cls, tool_data: dict[str, Any]) -> Static: - result = tool_data.get("result") - - text = Text() - text.append("📋 ") - text.append("Todo Completed", style="bold #a78bfa") - - if isinstance(result, str) and result.strip(): - text.append("\n ") - text.append(result.strip(), style="dim") - elif result and isinstance(result, dict): - if result.get("success"): - _format_todo_lines(text, result) - else: - error = result.get("error", "Failed to mark todo done") - text.append("\n ") - text.append(error, style="#ef4444") - else: - text.append("\n ") - text.append("Marking done...", style="dim") - - css_classes = cls.get_css_classes("completed") - return Static(text, classes=css_classes) - - -@register_tool_renderer -class MarkTodoPendingRenderer(BaseToolRenderer): - tool_name: ClassVar[str] = "mark_todo_pending" - css_classes: ClassVar[list[str]] = ["tool-call", "todo-tool"] - - @classmethod - def render(cls, tool_data: dict[str, Any]) -> Static: - result = tool_data.get("result") - - text = Text() - text.append("📋 ") - text.append("Todo Reopened", style="bold #f59e0b") - - if isinstance(result, str) and result.strip(): - text.append("\n ") - text.append(result.strip(), style="dim") - elif result and isinstance(result, dict): - if result.get("success"): - _format_todo_lines(text, result) - else: - error = result.get("error", "Failed to reopen todo") - text.append("\n ") - text.append(error, style="#ef4444") - else: - text.append("\n ") - text.append("Reopening...", style="dim") - - css_classes = cls.get_css_classes("completed") - return Static(text, classes=css_classes) - - -@register_tool_renderer -class DeleteTodoRenderer(BaseToolRenderer): - tool_name: ClassVar[str] = "delete_todo" - css_classes: ClassVar[list[str]] = ["tool-call", "todo-tool"] - - @classmethod - def render(cls, tool_data: dict[str, Any]) -> Static: - result = tool_data.get("result") - - text = Text() - text.append("📋 ") - text.append("Todo Removed", style="bold #94a3b8") - - if isinstance(result, str) and result.strip(): - text.append("\n ") - text.append(result.strip(), style="dim") - elif result and isinstance(result, dict): - if result.get("success"): - _format_todo_lines(text, result) - else: - error = result.get("error", "Failed to remove todo") - text.append("\n ") - text.append(error, style="#ef4444") - else: - text.append("\n ") - text.append("Removing...", style="dim") - - css_classes = cls.get_css_classes("completed") - return Static(text, classes=css_classes) diff --git a/strix/interface/tui/renderers/user_message_renderer.py b/strix/interface/tui/renderers/user_message_renderer.py deleted file mode 100644 index ea742ceb..00000000 --- a/strix/interface/tui/renderers/user_message_renderer.py +++ /dev/null @@ -1,29 +0,0 @@ -from rich.text import Text - - -class UserMessageRenderer: - @classmethod - def render_simple(cls, content: str) -> Text: - if not content: - return Text() - - return cls._format_user_message(content) - - @classmethod - def _format_user_message(cls, content: str) -> Text: - text = Text() - - text.append("▍", style="#3b82f6") - text.append(" ") - text.append("You:", style="bold") - text.append("\n") - - lines = content.split("\n") - for i, line in enumerate(lines): - if i > 0: - text.append("\n") - text.append("▍", style="#3b82f6") - text.append(" ") - text.append(line) - - return text diff --git a/strix/interface/tui/renderers/web_search_renderer.py b/strix/interface/tui/renderers/web_search_renderer.py deleted file mode 100644 index 4bd20f78..00000000 --- a/strix/interface/tui/renderers/web_search_renderer.py +++ /dev/null @@ -1,29 +0,0 @@ -from typing import Any, ClassVar - -from rich.text import Text -from textual.widgets import Static - -from .base_renderer import BaseToolRenderer -from .registry import register_tool_renderer - - -@register_tool_renderer -class WebSearchRenderer(BaseToolRenderer): - tool_name: ClassVar[str] = "web_search" - css_classes: ClassVar[list[str]] = ["tool-call", "web-search-tool"] - - @classmethod - def render(cls, tool_data: dict[str, Any]) -> Static: - args = tool_data.get("args", {}) - query = args.get("query", "") - - text = Text() - text.append("🌐 ") - text.append("Searching the web...", style="bold #60a5fa") - - if query: - text.append("\n ") - text.append(query, style="dim") - - css_classes = cls.get_css_classes("completed") - return Static(text, classes=css_classes) diff --git a/strix/interface/tui/runtime.py b/strix/interface/tui/runtime.py new file mode 100644 index 00000000..e056d0bb --- /dev/null +++ b/strix/interface/tui/runtime.py @@ -0,0 +1,392 @@ +"""Launch and supervise the Bubble Tea TUI.""" + +from __future__ import annotations + +import asyncio +import contextlib +import json +import logging +import os +import shutil +import sys +from copy import deepcopy +from pathlib import Path +from typing import TYPE_CHECKING, Any + +from strix.config import load_settings, persist_current +from strix.core.agents import AgentCoordinator +from strix.core.hooks import BudgetExceededError +from strix.core.runner import run_strix_scan +from strix.interface.scan_setup import ( + build_targets_info, + preflight_model_connection, + prepare_run, + telemetry_start, +) +from strix.interface.tui.backend import TuiBackendServer, TuiController +from strix.interface.tui.backend.live_view import TuiLiveView +from strix.interface.tui.sidecar import ( + check_return_code, + child_environment, + launch_tui_process, + package_version, + terminate_process, + tui_executable, + tui_source_dir, + wait_process, +) +from strix.report.state import ReportState, set_global_report_state +from strix.utils.resource_paths import get_strix_resource_path + + +if TYPE_CHECKING: + import argparse + import socket + import subprocess + +logger = logging.getLogger(__name__) + + +class GoTuiPreActivationError(RuntimeError): + """A sidecar failure raised before the Go TUI activates.""" + + +class GoTuiRuntime: + def __init__(self, args: argparse.Namespace) -> None: + self.args = args + self.live_view = TuiLiveView() + self.coordinator = AgentCoordinator() + self.report_state: ReportState | None = None + self.scan_config: dict[str, Any] = {} + self.scan_task: asyncio.Task[None] | None = None + self.scan_error: BaseException | None = None + self._last_sync_fingerprint = "" + self._error_noted_agents: set[str] = set() + self.controller = TuiController( + args, + live_view=self.live_view, + coordinator=self.coordinator, + on_start=self.start_from_setup, + on_quit=self.quit, + ) + self.server = TuiBackendServer(self.controller) + + def init_run_state(self) -> None: + self.scan_config = { + "scan_id": self.args.run_name, + "targets": self.args.targets_info, + "user_instructions": self.args.instruction or "", + "run_name": self.args.run_name, + "diff_scope": self.args.diff_scope, + "scan_mode": self.args.scan_mode, + "non_interactive": False, + "local_sources": self.args.local_sources or [], + "scope_mode": self.args.scope_mode, + "diff_base": self.args.diff_base, + "resume_instruction": self.args.user_explicit_instruction or "", + "workspace_mount": getattr(self.args, "workspace_mount", None) or "", + "workspace_subdir": getattr(self.args, "workspace_subdir", None) or "", + } + self.report_state = ReportState(self.scan_config["run_name"]) + self.report_state.hydrate_from_run_dir() + self.report_state.set_scan_config(self.scan_config) + self.report_state.save_run_data() + set_global_report_state(self.report_state) + self.live_view.hydrate_from_run_dir(self.report_state.get_run_dir()) + self.controller.set_runtime( + report_state=self.report_state, + scan_loop=asyncio.get_running_loop(), + ) + self.report_state.vulnerability_found_callback = lambda _report: ( + self.controller.notify_changed() + ) + self.controller.notify_changed() + + async def start_from_setup(self, verify: bool = True) -> None: + candidate = deepcopy(self.args) + candidate.scan_mode = self.controller.scan_mode + candidate.instruction = self.controller.instruction + # Held apart from instruction, which prepare_run prefixes with the + # diff-scope preamble, so the transcript can show what was typed. + candidate.user_instruction = self.controller.instruction or None + candidate.max_budget_usd = self.controller.max_budget_usd + candidate.max_turns = self.controller.max_turns + candidate.scope_mode = self.controller.scope_mode + candidate.diff_base = self.controller.diff_base + existing_targets = [ + str(target["original"]) + for target in candidate.targets_info + if isinstance(target, dict) and target.get("original") + ] + targets_changed = self.controller.targets != existing_targets + model = (load_settings().llm.model or "").strip() + # A bare prompt launches optimistically: it skips the network preflight + # and lets any model error surface once the agent starts, like a coding + # agent. A named target keeps the upfront check. + if verify: + try: + await preflight_model_connection(model) + except Exception as exc: + logger.exception("Go TUI setup model preflight failed") + raise RuntimeError(f"Model connection failed: {exc}") from exc + # A confirmed target-less launch mounts the working directory for the + # agent to work in, without making it a scan target. + candidate.workspace_mount = self.controller.workspace_mount + if targets_changed: + # Rebuild the full typed set so path canonicalization and local + # deduplication match the CLI. + candidate.target = list(self.controller.targets) + candidate.target_list = [] + build_targets_info(candidate) + prepare_run(candidate) + telemetry_start(candidate) + + vars(self.args).update(vars(candidate)) + self.init_run_state() + self.start_scan() + + async def prepare_and_start(self) -> None: + """Prepare a directly-launched scan once the TUI is on screen. + + The model round trip and run preparation run here rather than before + launch so the interface appears immediately. + """ + model = (load_settings().llm.model or "").strip() + try: + await preflight_model_connection(model) + persist_current() + prepare_run(self.args) + telemetry_start(self.args) + except Exception as exc: + logger.exception("Go TUI scan preparation failed") + self.controller.fail_preparation(str(exc)) + return + self.controller.scan_state = "running" + self.init_run_state() + self.start_scan() + + def start_scan(self) -> None: + if self.scan_task is None: + self.scan_task = asyncio.create_task(self._run_scan()) + + async def _run_scan(self) -> None: + image = str(load_settings().runtime.image or "strix-sandbox:latest") + try: + await run_strix_scan( + scan_config=self.scan_config, + scan_id=self.scan_config["run_name"], + image=image, + local_sources=self.args.local_sources or [], + coordinator=self.coordinator, + interactive=True, + max_turns=self.args.max_turns, + max_budget_usd=self.args.max_budget_usd, + event_sink=self.capture_event, + ) + await self._sync_agent_state() + if self.controller.scan_state == "running": + self.controller.scan_state = "stopped" + except (asyncio.CancelledError, BudgetExceededError): + report_status = ( + self.report_state.run_record.get("status") + if self.report_state is not None + else None + ) + self.controller.scan_state = "completed" if report_status == "completed" else "stopped" + except Exception as exc: + logger.exception("Go TUI scan failed") + self.scan_error = exc + self.controller.error = str(exc) + self.controller.scan_state = "failed" + finally: + with contextlib.suppress(Exception): + await self._sync_agent_state() + self.controller.notify_changed() + + def capture_event(self, agent_id: str, event: Any) -> None: + self.live_view.ingest_sdk_event(agent_id, event) + self.controller.notify_changed() + + async def _sync_agent_state(self) -> bool: + parent_of, statuses, names, errors = await self.coordinator.graph_snapshot() + changed = False + for agent_id, status in statuses.items(): + error = errors.get(agent_id) + changed = ( + self.live_view.upsert_agent( + agent_id, + name=names.get(agent_id, agent_id), + parent_id=parent_of.get(agent_id), + status=str(status), + error_message=error, + ) + or changed + ) + if status in {"failed", "crashed"} and error: + if agent_id not in self._error_noted_agents: + self._error_noted_agents.add(agent_id) + self.live_view.record_agent_error(agent_id, error) + changed = True + else: + self._error_noted_agents.discard(agent_id) + + # The user's opening message waits for the root agent to exist, which is + # the first thing this sync learns about. + changed = self.live_view.flush_user_instruction() or changed + + roots = [agent_id for agent_id, parent_id in parent_of.items() if parent_id is None] + root_id = roots[0] if roots else None + root_status = statuses.get(root_id) if root_id is not None else None + report_status = ( + self.report_state.run_record.get("status") if self.report_state is not None else None + ) + scan_state = self.controller.scan_state + if root_status in {"failed", "crashed"}: + scan_state = "failed" + if root_id is not None and errors.get(root_id): + self.controller.error = errors[root_id] + elif scan_state != "failed": + if report_status == "completed": + scan_state = "completed" + elif root_status == "stopped": + scan_state = "stopped" + elif root_status == "completed": + scan_state = "failed" + self.controller.error = "Scan ended without a completed report" + if scan_state != self.controller.scan_state: + self.controller.scan_state = scan_state + changed = True + return changed + + def _runtime_sync_fingerprint(self) -> str: + usage: dict[str, Any] = {} + vulnerabilities: list[object] = [] + if self.report_state is not None: + usage = dict(self.report_state.get_total_llm_usage()) + vulnerabilities = [ + report.get("id", index) if isinstance(report, dict) else index + for index, report in enumerate(self.report_state.vulnerability_reports) + ] + return json.dumps( + { + "scan_state": self.controller.scan_state, + "usage": usage, + "vulnerabilities": vulnerabilities, + }, + default=str, + sort_keys=True, + separators=(",", ":"), + ) + + async def sync_state(self) -> None: + while True: + if self.scan_task is not None and not self.scan_task.done(): + try: + changed = await self._sync_agent_state() + except Exception as exc: + logger.exception("Go TUI agent-state sync failed") + self.controller.error = f"Agent-state sync failed: {exc}" + changed = True + fingerprint = self._runtime_sync_fingerprint() + if fingerprint != self._last_sync_fingerprint: + self._last_sync_fingerprint = fingerprint + changed = True + if changed: + self.controller.notify_changed() + await asyncio.sleep(0.5) + + async def quit(self) -> None: + self.controller.close_viewer() + self.coordinator.mark_shutting_down() + scan_task = self.scan_task + if scan_task is not None: + if not scan_task.done(): + scan_task.cancel() + with contextlib.suppress(asyncio.CancelledError): + await scan_task + + @staticmethod + def binary_command() -> list[str]: + source = tui_source_dir() + # A checkout may also contain a stale wheel/build sidecar. Running the + # current source is the deterministic development choice. + if (source / "go.mod").is_file() and shutil.which("go"): + return ["go", "run", "./cmd/strix-tui"] + packaged = get_strix_resource_path("bin", tui_executable()) + if packaged.is_file(): + return [str(packaged)] + raise RuntimeError( + "Bubble Tea TUI binary not found. Reinstall Strix from an official platform wheel." + ) + + @staticmethod + async def _cancel_tasks(*tasks: asyncio.Task[None] | None) -> None: + for task in tasks: + if task is None: + continue + task.cancel() + with contextlib.suppress(asyncio.CancelledError): + await task + + async def run(self) -> None: + # Redirect the process's sys.stdout/sys.stderr while the TUI runs so + # logging handlers created during the scan never paint over the Go + # TUI's alt screen. The child still inherits the real terminal fds; + # only the Python-level bindings change. + original_stdout = sys.stdout + original_stderr = sys.stderr + output_sink = Path(os.devnull).open("a", buffering=1) # noqa: SIM115 + sys.stdout = output_sink + sys.stderr = output_sink + backend_socket: socket.socket | None = None + sync_task: asyncio.Task[None] | None = None + prepare_task: asyncio.Task[None] | None = None + process: asyncio.subprocess.Process | subprocess.Popen[bytes] | None = None + try: + env = child_environment() + env["STRIX_VERSION"] = package_version() + command = self.binary_command() + cwd = str(tui_source_dir()) if command[:2] == ["go", "run"] else None + if cwd is not None: + # go run compiles the sidecar when the build cache is cold, so + # tell the terminal why nothing is on screen yet. + print( + "\x1b[2mCompiling the TUI from source (cached after the first run)...\x1b[0m", + file=original_stdout, + flush=True, + ) + process, backend_socket = await launch_tui_process(command, env, cwd) + await self.server.start(backend_socket) + if not self.controller.setup_mode: + self.controller.begin_preparation() + prepare_task = asyncio.create_task(self.prepare_and_start()) + sync_task = asyncio.create_task(self.sync_state()) + return_code = await wait_process(process) + check_return_code(return_code) + except Exception as exc: + await terminate_process(process) + if not self.server.activated: + raise GoTuiPreActivationError(str(exc)) from exc + raise + except BaseException: + await terminate_process(process) + raise + finally: + try: + if backend_socket is not None: + backend_socket.close() + await self._cancel_tasks(prepare_task, sync_task) + await self.quit() + await self.server.close() + finally: + sys.stdout = original_stdout + sys.stderr = original_stderr + output_sink.close() + # Mirror run_tui: surface the captured scan failure once the app has + # exited cleanly so the CLI reports it instead of exiting 0. + if self.scan_error is not None: + raise self.scan_error + + +async def run_go_tui(args: argparse.Namespace) -> None: + await GoTuiRuntime(args).run() diff --git a/strix/interface/tui/sidecar.py b/strix/interface/tui/sidecar.py new file mode 100644 index 00000000..d08d04ac --- /dev/null +++ b/strix/interface/tui/sidecar.py @@ -0,0 +1,191 @@ +"""Launch, authenticate, and supervise the Go TUI sidecar process.""" + +from __future__ import annotations + +import asyncio +import contextlib +import hmac +import os +import secrets +import socket +import subprocess +from importlib.metadata import PackageNotFoundError, version +from pathlib import Path +from typing import Any + + +_WINDOWS_AUTH_TIMEOUT = 10.0 +_PROCESS_EXIT_TIMEOUT = 5.0 +_SENSITIVE_ENV_SUFFIXES = ("_API_KEY", "_ACCESS_KEY") +_SENSITIVE_ENV_PARTS = frozenset( + {"CREDENTIAL", "CREDENTIALS", "PASSWORD", "SECRET", "SECRETS", "TOKEN", "TOKENS"} +) +_SENSITIVE_ENV_NAMES = { + "AWS_ACCESS_KEY_ID", + "GOOGLE_APPLICATION_CREDENTIALS", + "LLM_API_KEY", + "STRIX_TUI_ADDR", + "STRIX_TUI_FD", + "STRIX_TUI_TOKEN", +} + + +def tui_executable() -> str: + return "strix-tui.exe" if os.name == "nt" else "strix-tui" + + +def project_root() -> Path: + return Path(__file__).resolve().parents[3] + + +def tui_source_dir() -> Path: + return Path(__file__).resolve().parent + + +def child_environment() -> dict[str, str]: + """Copy only non-secret process state needed by the terminal sidecar.""" + child: dict[str, str] = {} + for key, value in os.environ.items(): + normalized = key.upper() + if normalized in _SENSITIVE_ENV_NAMES: + continue + if normalized.endswith(_SENSITIVE_ENV_SUFFIXES): + continue + if set(normalized.split("_")) & _SENSITIVE_ENV_PARTS: + continue + child[key] = value + return child + + +def _recv_exactly(connection: socket.socket, size: int) -> bytes: + chunks: list[bytes] = [] + remaining = size + while remaining: + chunk = connection.recv(remaining) + if not chunk: + raise ConnectionError("TUI IPC peer closed during authentication") + chunks.append(chunk) + remaining -= len(chunk) + return b"".join(chunks) + + +def _authenticate_connection( + connection: socket.socket, + address: tuple[Any, ...], + expected_token: str, +) -> None: + if address[0] not in {"127.0.0.1", "::1"}: + raise ConnectionError("TUI IPC connection did not originate from loopback") + connection.settimeout(_WINDOWS_AUTH_TIMEOUT) + supplied = _recv_exactly(connection, len(expected_token)).decode("ascii") + if not hmac.compare_digest(supplied, expected_token): + raise PermissionError("TUI IPC authentication failed") + connection.settimeout(None) + + +def _accept_authenticated_connection( + listener: socket.socket, + expected_token: str, +) -> socket.socket: + """Accept and authenticate the one Windows loopback connection.""" + listener.settimeout(_WINDOWS_AUTH_TIMEOUT) + connection, address = listener.accept() + try: + _authenticate_connection(connection, address, expected_token) + except BaseException: + connection.close() + raise + return connection + + +async def wait_process( + process: asyncio.subprocess.Process | subprocess.Popen[bytes], +) -> int: + if isinstance(process, asyncio.subprocess.Process): + return await process.wait() + return await asyncio.to_thread(process.wait) + + +async def terminate_process( + process: asyncio.subprocess.Process | subprocess.Popen[bytes] | None, +) -> None: + if process is None or process.returncode is not None: + return + with contextlib.suppress(ProcessLookupError): + process.terminate() + wait_task = asyncio.create_task(wait_process(process)) + try: + await asyncio.wait_for(asyncio.shield(wait_task), _PROCESS_EXIT_TIMEOUT) + except TimeoutError: + with contextlib.suppress(ProcessLookupError): + process.kill() + await asyncio.wait_for(asyncio.shield(wait_task), _PROCESS_EXIT_TIMEOUT) + + +async def launch_tui_process( + command: list[str], + env: dict[str, str], + cwd: str | None, +) -> tuple[asyncio.subprocess.Process | subprocess.Popen[bytes], socket.socket]: + if os.name == "nt": + return await _launch_windows_tui_process(command, env, cwd) + return await _launch_posix_tui_process(command, env, cwd) + + +async def _launch_posix_tui_process( + command: list[str], + env: dict[str, str], + cwd: str | None, +) -> tuple[asyncio.subprocess.Process, socket.socket]: + backend_socket, child_socket = socket.socketpair() + try: + env["STRIX_TUI_FD"] = str(child_socket.fileno()) + process = await asyncio.create_subprocess_exec( + *command, env=env, cwd=cwd, pass_fds=(child_socket.fileno(),) + ) + except BaseException: + backend_socket.close() + raise + finally: + child_socket.close() + return process, backend_socket + + +async def _launch_windows_tui_process( + command: list[str], + env: dict[str, str], + cwd: str | None, +) -> tuple[subprocess.Popen[bytes], socket.socket]: + listener = socket.socket(socket.AF_INET, socket.SOCK_STREAM) + windows_process: subprocess.Popen[bytes] | None = None + connection: socket.socket | None = None + try: + listener.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1) + listener.bind(("127.0.0.1", 0)) + listener.listen(1) + token = secrets.token_hex(32) + host, port = listener.getsockname()[:2] + env.update({"STRIX_TUI_ADDR": f"{host}:{port}", "STRIX_TUI_TOKEN": token}) + windows_process = subprocess.Popen(command, env=env, cwd=cwd) # noqa: S603 + connection = await asyncio.to_thread(_accept_authenticated_connection, listener, token) + except BaseException: + await terminate_process(windows_process) + raise + finally: + listener.close() + assert windows_process is not None and connection is not None + return windows_process, connection + + +def check_return_code(return_code: int) -> None: + if return_code != 0: + raise RuntimeError(f"Bubble Tea TUI exited with status {return_code}") + + +def package_version() -> str: + """Report the installed package version for the Go splash/stats + ("dev" when metadata is unavailable).""" + try: + return version("strix-agent") + except PackageNotFoundError: + return "dev" diff --git a/strix/interface/update_check.py b/strix/interface/update_check.py index 71159267..f0d22ae6 100644 --- a/strix/interface/update_check.py +++ b/strix/interface/update_check.py @@ -97,19 +97,19 @@ def _is_newer(latest: str, current: str) -> bool: def _fetch_latest_version() -> str | None: try: if is_binary_install(): - response = requests.get( + with requests.get( f"https://api.github.com/repos/{GITHUB_REPO}/releases/latest", timeout=REQUEST_TIMEOUT_SECONDS, - ) - response.raise_for_status() - tag = response.json().get("tag_name", "") + ) as response: + response.raise_for_status() + tag = response.json().get("tag_name", "") return tag.lstrip("v") or None - response = requests.get( + with requests.get( f"https://pypi.org/pypi/{PYPI_PACKAGE}/json", timeout=REQUEST_TIMEOUT_SECONDS, - ) - response.raise_for_status() - version = response.json().get("info", {}).get("version") + ) as response: + response.raise_for_status() + version = response.json().get("info", {}).get("version") return str(version) if version else None except Exception: # noqa: BLE001 logger.debug("update check failed", exc_info=True) @@ -119,12 +119,13 @@ def _fetch_latest_version() -> str | None: def _fetch_asset_digest(version: str, filename: str) -> str | None: """Return the expected sha256 (hex) for a release asset, if the API provides one.""" try: - response = requests.get( + with requests.get( f"https://api.github.com/repos/{GITHUB_REPO}/releases/tags/v{version}", timeout=REQUEST_TIMEOUT_SECONDS, - ) - response.raise_for_status() - for asset in response.json().get("assets", []): + ) as response: + response.raise_for_status() + assets = response.json().get("assets", []) + for asset in assets: if asset.get("name") == filename: digest = asset.get("digest") or "" if digest.startswith("sha256:"): diff --git a/strix/interface/utils.py b/strix/interface/utils.py index 716ed66e..f73df1c2 100644 --- a/strix/interface/utils.py +++ b/strix/interface/utils.py @@ -11,7 +11,7 @@ import tempfile from dataclasses import dataclass, field from pathlib import Path from typing import Any -from urllib.parse import urlparse +from urllib.parse import parse_qs, urlparse import docker import requests @@ -21,6 +21,7 @@ from rich.panel import Panel from rich.text import Text from strix.config import load_settings +from strix.utils.api_spec import detect_spec_format logger = logging.getLogger(__name__) @@ -252,7 +253,7 @@ def _llm_usage(report_state: Any) -> dict[str, Any]: return usage if isinstance(usage, dict) else {} -def _is_subscription(report_state: Any) -> bool: +def is_subscription_run(report_state: Any) -> bool: """Whether this run uses a model subscription (no metered cost). Prefers the run record so it's correct for hydrated/resumed runs; falls back @@ -308,13 +309,18 @@ def _detail_value(usage: dict[str, Any], detail_key: str, value_key: str) -> int return _int_stat(details, value_key) +def has_model_response(report_state: Any) -> bool: + usage = _llm_usage(report_state) + return bool(usage) and _int_stat(usage, "requests") > 0 + + def _build_llm_usage_stats( stats_text: Text, report_state: Any, *, live: bool = False, ) -> None: - subscription = _is_subscription(report_state) + subscription = is_subscription_run(report_state) usage = _llm_usage(report_state) if not usage or _int_stat(usage, "requests") <= 0: stats_text.append("\n") @@ -378,7 +384,7 @@ def build_live_stats_text(report_state: Any) -> Text: model = load_settings().llm.model or "unknown" stats_text.append("Model ", style="dim") stats_text.append(str(model), style="white") - if _is_subscription(report_state): + if is_subscription_run(report_state): stats_text.append(" · ", style="dim white") stats_text.append(_subscription_label(report_state), style="#22c55e") stats_text.append("\n") @@ -423,7 +429,7 @@ def build_tui_stats_text(report_state: Any) -> Text: model = load_settings().llm.model or "unknown" stats_text.append(str(model), style="white") - subscription = _is_subscription(report_state) + subscription = is_subscription_run(report_state) if subscription: stats_text.append("\n") stats_text.append(_subscription_label(report_state), style="#22c55e") @@ -497,6 +503,15 @@ def _derive_target_label_for_run_name(targets_info: list[dict[str, Any]] | None) if target_type == "ip_address": return str(details.get("target_ip", original) or original) + if target_type == "api_spec": + if details.get("source") == "postman_api": + return "postman-collection" + spec_path = details.get("target_spec", original) + try: + return str(Path(spec_path).stem or spec_path) + except Exception: + return str(spec_path) + return str(original or "pentest") @@ -1105,12 +1120,12 @@ def resolve_diff_scope_context( def _is_http_git_repo(url: str) -> bool: check_url = f"{url.rstrip('/')}/info/refs?service=git-upload-pack" try: - resp = requests.get(check_url, headers={"User-Agent": "git/strix"}, timeout=10) + with requests.get(check_url, headers={"User-Agent": "git/2.43.0"}, timeout=10) as resp: + if resp.status_code >= 400: + return resp.status_code == 401 + return "x-git-upload-pack-advertisement" in resp.headers.get("Content-Type", "") except (requests.RequestException, ValueError): return False - if resp.status_code >= 400: - return resp.status_code == 401 - return "x-git-upload-pack-advertisement" in resp.headers.get("Content-Type", "") def infer_target_type(target: str) -> tuple[str, dict[str, str]]: # noqa: PLR0911 @@ -1126,6 +1141,24 @@ def infer_target_type(target: str) -> tuple[str, dict[str, str]]: # noqa: PLR09 return "repository", {"target_repo": target} parsed = urlparse(target) + if parsed.scheme == "postman": + collection_uid = f"{parsed.netloc}{parsed.path}".strip("/") + if not collection_uid: + raise ValueError( + f"Missing Postman collection id in '{target}' (expected postman://)" + ) + details = { + "target_spec": target, + "spec_format": "postman", + "source": "postman_api", + "collection_uid": collection_uid, + } + query = parse_qs(parsed.query) + env_uid = (query.get("env") or query.get("environment") or [""])[0].strip() + if env_uid: + details["environment_uid"] = env_uid + return "api_spec", details + if parsed.scheme in ("http", "https"): if parsed.username or parsed.password: return "repository", {"target_repo": target} @@ -1149,7 +1182,14 @@ def infer_target_type(target: str) -> tuple[str, dict[str, str]]: # noqa: PLR09 try: if path.exists(): if path.is_dir(): + check_mountable_dir(path) return "local_code", {"target_path": str(path.resolve())} + spec_format = detect_spec_format(path) + if spec_format is not None: + return "api_spec", { + "target_spec": str(path.resolve()), + "spec_format": spec_format, + } raise ValueError(f"Path exists but is not a directory: {target}") except (OSError, RuntimeError) as e: raise ValueError(f"Invalid path: {target} - {e!s}") from e @@ -1176,6 +1216,9 @@ def infer_target_type(target: str) -> tuple[str, dict[str, str]]: # noqa: PLR09 "- A valid URL (http:// or https://)\n" "- A Git repository URL (https://host/org/repo or git@host:org/repo.git)\n" "- A local directory path\n" + "- An API spec file (OpenAPI/Swagger .json/.yaml or a Postman collection)\n" + "- A Postman collection by id (postman://[?env=], " + "needs POSTMAN_API_KEY)\n" "- A domain name (e.g., example.com)\n" "- An IP address (e.g., 192.168.1.10)" ) @@ -1277,7 +1320,7 @@ def collect_local_sources(targets_info: list[dict[str, Any]]) -> list[dict[str, { "source_path": details["target_path"], "workspace_subdir": workspace_subdir, - "mount": bool(details.get("mount", False)), + "protect_metadata": True, } ) @@ -1286,123 +1329,126 @@ def collect_local_sources(targets_info: list[dict[str, Any]]) -> list[dict[str, { "source_path": details["cloned_repo_path"], "workspace_subdir": workspace_subdir, - "mount": False, + "protect_metadata": False, } ) return local_sources -def directory_size_bytes(path: Path) -> int: - """Total size in bytes of regular files under ``path`` (symlinks not followed). +# Refused along with everything under them. +_FORBIDDEN_MOUNT_TREES = frozenset( + { + "/bin", + "/sbin", + "/usr", + "/etc", + "/lib", + "/lib64", + "/nix/store", + "/run/current-system/sw", + "/Applications", + "/Library", + "/System", + "/dev", + "/boot", + "/proc", + "/sys", + } +) - Best-effort: files that disappear or can't be stat'd mid-walk are skipped. - Used as a cheap (stat-only) pre-flight to estimate the cost of streaming a - local target into the sandbox before we actually try to copy it. +# Refused themselves, but they hold projects too, so their contents are fine. +_FORBIDDEN_MOUNT_ROOTS = frozenset( + { + "/", + "/private", + "/var", + "/opt", + "/home", + "/root", + "/srv", + "/Users", + "/Volumes", + } +) - Directories that can't be listed (e.g. permission denied) are logged and - skipped rather than silently dropped — so an under-count is at least - visible — but the returned total then excludes their contents. - """ +_FORBIDDEN_WINDOWS_TREE_NAMES = frozenset( + {"windows", "program files", "program files (x86)", "programdata"} +) - def _on_walk_error(error: OSError) -> None: - logger.warning("Could not read %s while measuring size: %s", error.filename, error) - - total = 0 - for root, _dirs, files in os.walk(path, followlinks=False, onerror=_on_walk_error): - for name in files: - file_path = os.path.join(root, name) # noqa: PTH118 - try: - if os.path.islink(file_path): # noqa: PTH114 - continue - total += os.path.getsize(file_path) # noqa: PTH202 - except OSError: - continue - return total +_FORBIDDEN_MOUNT_DIR_NAMES = frozenset( + { + ".ssh", + ".tsh", + ".brev", + ".gnupg", + ".aws", + ".azure", + ".kube", + ".docker", + ".config", + ".npm", + ".pki", + ".terraform.d", + } +) -def find_oversized_local_targets( - targets_info: list[dict[str, Any]], max_bytes: int -) -> list[tuple[str, int]]: - """Return ``(path, size_bytes)`` for non-mounted local targets over ``max_bytes``. - - Mounted targets are bind-mounted rather than copied, so their size is - irrelevant and they are excluded. A ``max_bytes`` of zero or less disables - the check entirely (returns no targets). - """ - if max_bytes <= 0: - return [] - oversized: list[tuple[str, int]] = [] - for target in targets_info: - if target.get("type") != "local_code": - continue - details = target.get("details") or {} - if details.get("mount"): - continue - target_path = details.get("target_path") - if not target_path: - continue - size = directory_size_bytes(Path(target_path)) - if size > max_bytes: - oversized.append((target_path, size)) - return oversized +def _is_within(path: Path, ancestor: Path) -> bool: + ancestor_parts = [part.casefold() for part in ancestor.parts] + path_parts = [part.casefold() for part in path.parts] + return path_parts[: len(ancestor_parts)] == ancestor_parts -def build_mount_targets_info(mount_paths: list[str]) -> list[dict[str, Any]]: - """Build ``targets_info`` entries for ``--mount`` directories. +def check_mountable_dir(path: Path) -> None: + resolved = path.resolve() + if not resolved.is_dir(): + raise ValueError(f"'{path}' is not an existing directory.") - Each path must be an existing local directory; it is bind-mounted into the - sandbox (read-only) instead of being copied file-by-file. Raises - ``ValueError`` for an empty path, or one that does not exist or is not a - directory. - """ - targets_info: list[dict[str, Any]] = [] - for raw in mount_paths: - if not raw or not raw.strip(): - raise ValueError("--mount path must not be empty.") - path = Path(raw).expanduser() - try: - resolved = path.resolve() - is_dir = resolved.is_dir() - except (OSError, RuntimeError) as e: - raise ValueError(f"Invalid mount path '{raw}': {e!s}") from e - if not is_dir: - raise ValueError( - f"Mount path '{raw}' is not an existing directory. " - "--mount requires a path to a local directory." - ) - targets_info.append( - { - "type": "local_code", - "details": {"target_path": str(resolved), "mount": True}, - "original": str(resolved), - } + # Both the literal and the resolved form: macOS reaches /etc through the + # /private/etc symlink, and only the resolved path is compared below. + exact = {str(Path(root)).casefold() for root in _FORBIDDEN_MOUNT_ROOTS} + exact |= {str(Path(root).resolve()).casefold() for root in _FORBIDDEN_MOUNT_ROOTS} + exact.add(str(Path.home().resolve()).casefold()) + tree_roots = set(_FORBIDDEN_MOUNT_TREES) + if os.name == "nt": + drive = Path(resolved.anchor) + tree_roots |= {str(drive / name) for name in _FORBIDDEN_WINDOWS_TREE_NAMES} + exact.add(str(drive / "Users").casefold()) + trees = [Path(root) for root in tree_roots] + [Path(root).resolve() for root in tree_roots] + if ( + str(resolved).casefold() in exact + or resolved.parent == resolved + or any(_is_within(resolved, tree) for tree in trees) + ): + raise ValueError( + f"Refusing to mount '{resolved}' into the sandbox: it is a system " + "or home directory, not a codebase. Point the target at the " + "project directory you want tested." + ) + + credential = next( + (part for part in resolved.parts if part.casefold() in _FORBIDDEN_MOUNT_DIR_NAMES), None + ) + if credential is not None: + raise ValueError( + f"Refusing to mount '{resolved}' into the sandbox: '{credential}' " + "holds credentials, not code." ) - return targets_info def dedupe_local_targets(targets_info: list[dict[str, Any]]) -> list[dict[str, Any]]: - """Collapse local_code targets that resolve to the same path. - - When a directory is supplied both as a copied ``--target`` and via - ``--mount`` (or as duplicate values of either), keep one entry and prefer - the bind-mounted one — so the same tree is never both streamed in and - mounted. Order is preserved; non-local targets pass through untouched. - """ result: list[dict[str, Any]] = [] - index_by_path: dict[str, int] = {} + seen_paths: set[str] = set() for target in targets_info: details = target.get("details") or {} path = details.get("target_path") if target.get("type") != "local_code" or not path: result.append(target) continue - existing = index_by_path.get(path) - if existing is None: - index_by_path[path] = len(result) + if path not in seen_paths: + seen_paths.add(path) result.append(target) - elif details.get("mount") and not (result[existing].get("details") or {}).get("mount"): - result[existing] = target # bind mount supersedes the copied entry return result @@ -1447,6 +1493,62 @@ def rewrite_localhost_targets(targets_info: list[dict[str, Any]], host_gateway: details["target_ip"] = host_gateway +#: API spec targets are copied into one workspace directory rather than mounted +#: from wherever they happen to live on the host. +API_SPEC_WORKSPACE_SUBDIR = "api-specs" + + +def write_fetched_collection(collection: dict[str, Any], collection_uid: str) -> str: + """Write a collection fetched from the Postman API to a local file. + + Returns the file path, so a ``postman://`` target continues as an ordinary + spec file from here on and the API key never leaves the host. + """ + staging = Path(tempfile.gettempdir()) / "strix_api_specs" / "fetched" + staging.mkdir(parents=True, exist_ok=True) + path = staging / f"{sanitize_name(collection_uid)}.postman_collection.json" + path.write_text(json.dumps(collection, indent=2), encoding="utf-8") + return str(path) + + +def stage_api_specs(targets_info: list[dict[str, Any]], run_name: str) -> list[dict[str, Any]]: + """Copy every ``api_spec`` target into one directory for the sandbox. + + A spec is a single file the agent reads, not a tree it works in, so it is + copied to a per-run staging directory that is exposed at + ``/workspace/api-specs`` instead of mounting its host location. Each target's + ``workspace_path`` records where the agent will find it. + """ + specs = [t for t in targets_info if t.get("type") == "api_spec"] + if not specs: + return [] + + staging = Path(tempfile.gettempdir()) / "strix_api_specs" / run_name + staging.mkdir(parents=True, exist_ok=True) + + used: set[str] = set() + for target in specs: + details = target["details"] + source = Path(str(details["target_spec"])) + name = source.name + stem, suffix = source.stem, source.suffix + count = 1 + while name in used: + count += 1 + name = f"{stem}-{count}{suffix}" + used.add(name) + shutil.copy2(source, staging / name) + details["workspace_path"] = f"/workspace/{API_SPEC_WORKSPACE_SUBDIR}/{name}" + + return [ + { + "source_path": str(staging), + "workspace_subdir": API_SPEC_WORKSPACE_SUBDIR, + "protect_metadata": False, + } + ] + + def clone_repository(repo_url: str, run_name: str, dest_name: str | None = None) -> str: console = Console() @@ -1484,43 +1586,13 @@ def clone_repository(repo_url: str, run_name: str, dest_name: str | None = None) return str(clone_path.absolute()) except subprocess.CalledProcessError as e: - error_text = Text() - error_text.append("REPOSITORY CLONE FAILED", style="bold red") - error_text.append("\n\n", style="white") - error_text.append(f"Could not clone repository: {repo_url}\n", style="white") - error_text.append( - f"Error: {e.stderr if hasattr(e, 'stderr') and e.stderr else str(e)}", style="dim red" - ) - - panel = Panel( - error_text, - title="[bold white]STRIX", - title_align="left", - border_style="red", - padding=(1, 2), - ) - console.print("\n") - console.print(panel) - console.print() - sys.exit(1) - except FileNotFoundError: - error_text = Text() - error_text.append("GIT NOT FOUND", style="bold red") - error_text.append("\n\n", style="white") - error_text.append("Git is not installed or not available in PATH.\n", style="white") - error_text.append("Please install Git to clone repositories.\n", style="white") - - panel = Panel( - error_text, - title="[bold white]STRIX", - title_align="left", - border_style="red", - padding=(1, 2), - ) - console.print("\n") - console.print(panel) - console.print() - sys.exit(1) + detail = e.stderr if hasattr(e, "stderr") and e.stderr else str(e) + raise ValueError(f"Could not clone repository {repo_url}: {detail}") from e + except FileNotFoundError as e: + raise ValueError( + "Git is not installed or not available in PATH. " + "Please install Git to clone repositories." + ) from e def check_docker_connection() -> Any: diff --git a/strix/interface/viewer/auth.py b/strix/interface/viewer/auth.py index a1f137bc..67a0db9d 100644 --- a/strix/interface/viewer/auth.py +++ b/strix/interface/viewer/auth.py @@ -22,6 +22,7 @@ from typing import Any import requests from strix.config.loader import load_settings +from strix.utils.secret_files import write_secret_text logger = logging.getLogger(__name__) @@ -115,15 +116,8 @@ def is_verified() -> bool: def write_auth(email: str, token: str, verified_at: str) -> None: """Atomically persist the auth record with 0600 permissions.""" - AUTH_PATH.parent.mkdir(parents=True, exist_ok=True) payload = json.dumps({"email": email, "token": token, "verified_at": verified_at}) - tmp = AUTH_PATH.with_suffix(".json.tmp") - tmp.write_text(payload, encoding="utf-8") - with contextlib.suppress(OSError): - tmp.chmod(0o600) - tmp.replace(AUTH_PATH) - with contextlib.suppress(OSError): - AUTH_PATH.chmod(0o600) + write_secret_text(AUTH_PATH, payload) def forget() -> None: @@ -148,16 +142,16 @@ def _post_json(path: str, payload: dict[str, Any], *, timeout: int) -> tuple[int """ url = f"{_app_url()}{path}" try: - response = requests.post( + with requests.post( url, json=payload, headers={"Accept": "application/json"}, timeout=timeout, - ) + ) as response: + return response.status_code, _parse_body(response.content) except requests.RequestException as exc: logger.warning("relay request to %s failed: %s", path, exc) raise RelayError("unavailable") from exc - return response.status_code, _parse_body(response.content) def _parse_body(raw: bytes) -> dict[str, Any]: diff --git a/strix/interface/viewer/frontend/src/components/live/tool-renderers/AgentCommsRenderer.tsx b/strix/interface/viewer/frontend/src/components/live/tool-renderers/AgentCommsRenderer.tsx index 49d8bfcc..5bbbeeec 100644 --- a/strix/interface/viewer/frontend/src/components/live/tool-renderers/AgentCommsRenderer.tsx +++ b/strix/interface/viewer/frontend/src/components/live/tool-renderers/AgentCommsRenderer.tsx @@ -54,7 +54,7 @@ export default function AgentCommsRenderer({ toolName, args }: ToolRendererProps ); } - if (toolName === "wait_for_message") { + if (toolName === "wait_for_agents") { const reason = (args.reason as string) ?? ""; return (
diff --git a/strix/interface/viewer/frontend/src/components/live/tool-renderers/RespondRenderer.tsx b/strix/interface/viewer/frontend/src/components/live/tool-renderers/RespondRenderer.tsx new file mode 100644 index 00000000..e963a35e --- /dev/null +++ b/strix/interface/viewer/frontend/src/components/live/tool-renderers/RespondRenderer.tsx @@ -0,0 +1,20 @@ +"use client"; + +import type { ToolRendererProps } from "@/types/events"; +import Markdown from "./Markdown"; + +/** + * `respond_to_user` carries the message the user is meant to read, so it renders + * as the agent's own prose rather than as a tool call. + */ +export default function RespondRenderer({ args }: ToolRendererProps) { + const message = (args.message as string) ?? ""; + if (!message) return null; + + return ( +
+ +
waiting for your reply
+
+ ); +} diff --git a/strix/interface/viewer/frontend/src/components/live/tool-renderers/ViewImageRenderer.tsx b/strix/interface/viewer/frontend/src/components/live/tool-renderers/ViewImageRenderer.tsx index b94282aa..d38d7b0b 100644 --- a/strix/interface/viewer/frontend/src/components/live/tool-renderers/ViewImageRenderer.tsx +++ b/strix/interface/viewer/frontend/src/components/live/tool-renderers/ViewImageRenderer.tsx @@ -3,16 +3,32 @@ import type { ToolRendererProps } from "@/types/events"; import { shortPath } from "./utils"; -/** Mirrors the OSS TUI `ViewImageRenderer`: surfaces load errors, otherwise a - * compact "view image " line. */ +const IMAGE_DATA_URI_RE = /data:image\/(png|jpe?g|gif|webp);base64,([A-Za-z0-9+/]+={0,2})/; + +function extractImageDataUri(res: unknown): string | null { + let s: string | null = null; + if (typeof res === "string") { + s = res; + } else if (res && typeof res === "object") { + const o = res as Record; + if (typeof o.image_url === "string") s = o.image_url; + else if (typeof o.url === "string") s = o.url; + } + if (!s) return null; + const m = IMAGE_DATA_URI_RE.exec(s); + if (!m || m[2].length < 100 || m[2].length % 4 !== 0) return null; + return `data:image/${m[1]};base64,${m[2]}`; +} + +/** Renders the view_image result as an inline image, like the strix-app + * renderer; falls back to the load-error text when there is no payload. */ export default function ViewImageRenderer({ args, result }: ToolRendererProps) { const path = ((args.path as string) ?? "").trim(); - const res = result as Record | string | null; + const imgSrc = extractImageDataUri(result); let error: string | null = null; - if (typeof res === "string") { - const trimmed = res.trim(); - // A string result that isn't an image payload or structured data is an error message + if (!imgSrc && typeof result === "string") { + const trimmed = result.trim(); if (trimmed && !trimmed.toLowerCase().startsWith("data:image/") && !trimmed.startsWith("{")) { error = trimmed; } @@ -24,6 +40,13 @@ export default function ViewImageRenderer({ args, result }: ToolRendererProps) { view image {path && {shortPath(path)}}
+ {imgSrc && ( + {path + )} {error &&
{error}
} ); diff --git a/strix/interface/viewer/frontend/src/components/live/tool-renderers/index.ts b/strix/interface/viewer/frontend/src/components/live/tool-renderers/index.ts index 545c8853..67f275fc 100644 --- a/strix/interface/viewer/frontend/src/components/live/tool-renderers/index.ts +++ b/strix/interface/viewer/frontend/src/components/live/tool-renderers/index.ts @@ -24,6 +24,7 @@ import NotesRenderer from "./NotesRenderer"; import TodoRenderer from "./TodoRenderer"; import FallbackRenderer from "./FallbackRenderer"; import LoadSkillRenderer from "./LoadSkillRenderer"; +import RespondRenderer from "./RespondRenderer"; /** * Tool-renderer mapping — data-driven, keyed by the engine's tool *family*. @@ -104,10 +105,10 @@ const CATEGORY_TOOLS: Record = { proxy: ["list_requests", "view_request", "repeat_request", "list_sitemap", "view_sitemap_entry", "scope_rules", "send_request"], reporting: ["create_vulnerability_report", "list_reports", "get_report"], thinking: ["think"], - agents: ["create_agent", "agent_finish", "send_message_to_agent", "wait_for_message", "view_agent_graph", "stop_agent"], + agents: ["create_agent", "agent_finish", "send_message_to_agent", "wait_for_agents", "view_agent_graph", "stop_agent"], search: ["web_search"], // scan_start_info / subagent_start_info are strix-app synthetic events; finish_scan is the engine's - lifecycle: ["scan_start_info", "subagent_start_info", "finish_scan"], + lifecycle: ["scan_start_info", "subagent_start_info", "finish_scan", "respond_to_user"], notes: ["create_note", "delete_note", "update_note", "list_notes", "get_note"], skills: ["load_skill"], todos: ["create_todo", "list_todos", "update_todo", "mark_todo_done", "mark_todo_pending", "delete_todo"], @@ -127,6 +128,7 @@ const TOOL_CATEGORY: Record = Object.fromEntries( */ const RENDERER_OVERRIDES: Partial>> = { finish_scan: FinishRenderer, + respond_to_user: RespondRenderer, apply_patch: ApplyPatchRenderer, view_image: ViewImageRenderer, list_reports: ReportListRenderer, @@ -140,7 +142,8 @@ const RENDERER_OVERRIDES: Partial> = { agent_finish: { icon: Flag, color: "text-cyan-400" }, send_message_to_agent: { icon: MessageCircle, color: "text-cyan-400" }, - wait_for_message: { icon: MessageCircle, color: "text-cyan-400" }, + wait_for_agents: { icon: MessageCircle, color: "text-cyan-400" }, + respond_to_user: { icon: MessageCircle, color: "text-emerald-400" }, view_agent_graph: { icon: Eye, color: "text-cyan-400" }, stop_agent: { icon: Ban, color: "text-red-400" }, scan_start_info: { icon: Crosshair, color: "text-emerald-400" }, diff --git a/strix/interface/viewer/static/assets/index-C3kQ5kk8.css b/strix/interface/viewer/static/assets/index-C3kQ5kk8.css deleted file mode 100644 index 1d9e3318..00000000 --- a/strix/interface/viewer/static/assets/index-C3kQ5kk8.css +++ /dev/null @@ -1,10 +0,0 @@ -pre code.hljs{display:block;overflow-x:auto;padding:1em}code.hljs{padding:3px 5px}/*! - Theme: GitHub Dark - Description: Dark theme as seen on github.com - Author: github.com - Maintainer: @Hirse - Updated: 2021-05-15 - - Outdated base version: https://github.com/primer/github-syntax-dark - Current colors taken from GitHub's CSS -*/.hljs{color:#c9d1d9;background:#0d1117}.hljs-doctag,.hljs-keyword,.hljs-meta .hljs-keyword,.hljs-template-tag,.hljs-template-variable,.hljs-type,.hljs-variable.language_{color:#ff7b72}.hljs-title,.hljs-title.class_,.hljs-title.class_.inherited__,.hljs-title.function_{color:#d2a8ff}.hljs-attr,.hljs-attribute,.hljs-literal,.hljs-meta,.hljs-number,.hljs-operator,.hljs-variable,.hljs-selector-attr,.hljs-selector-class,.hljs-selector-id{color:#79c0ff}.hljs-regexp,.hljs-string,.hljs-meta .hljs-string{color:#a5d6ff}.hljs-built_in,.hljs-symbol{color:#ffa657}.hljs-comment,.hljs-code,.hljs-formula{color:#8b949e}.hljs-name,.hljs-quote,.hljs-selector-tag,.hljs-selector-pseudo{color:#7ee787}.hljs-subst{color:#c9d1d9}.hljs-section{color:#1f6feb;font-weight:700}.hljs-bullet{color:#f2cc60}.hljs-emphasis{color:#c9d1d9;font-style:italic}.hljs-strong{color:#c9d1d9;font-weight:700}.hljs-addition{color:#aff5b4;background-color:#033a16}.hljs-deletion{color:#ffdcd7;background-color:#67060c}.react-flow{direction:ltr;--xy-edge-stroke-default: #b1b1b7;--xy-edge-stroke-width-default: 1;--xy-edge-stroke-selected-default: #555;--xy-connectionline-stroke-default: #b1b1b7;--xy-connectionline-stroke-width-default: 1;--xy-attribution-background-color-default: rgba(255, 255, 255, .5);--xy-minimap-background-color-default: #fff;--xy-minimap-mask-background-color-default: rgba(240, 240, 240, .6);--xy-minimap-mask-stroke-color-default: transparent;--xy-minimap-mask-stroke-width-default: 1;--xy-minimap-node-background-color-default: #e2e2e2;--xy-minimap-node-stroke-color-default: transparent;--xy-minimap-node-stroke-width-default: 2;--xy-background-color-default: transparent;--xy-background-pattern-dots-color-default: #91919a;--xy-background-pattern-lines-color-default: #eee;--xy-background-pattern-cross-color-default: #e2e2e2;background-color:var(--xy-background-color, var(--xy-background-color-default));--xy-node-color-default: inherit;--xy-node-border-default: 1px solid #1a192b;--xy-node-background-color-default: #fff;--xy-node-group-background-color-default: rgba(240, 240, 240, .25);--xy-node-boxshadow-hover-default: 0 1px 4px 1px rgba(0, 0, 0, .08);--xy-node-boxshadow-selected-default: 0 0 0 .5px #1a192b;--xy-node-border-radius-default: 3px;--xy-handle-background-color-default: #1a192b;--xy-handle-border-color-default: #fff;--xy-selection-background-color-default: rgba(0, 89, 220, .08);--xy-selection-border-default: 1px dotted rgba(0, 89, 220, .8);--xy-controls-button-background-color-default: #fefefe;--xy-controls-button-background-color-hover-default: #f4f4f4;--xy-controls-button-color-default: inherit;--xy-controls-button-color-hover-default: inherit;--xy-controls-button-border-color-default: #eee;--xy-controls-box-shadow-default: 0 0 2px 1px rgba(0, 0, 0, .08);--xy-edge-label-background-color-default: #ffffff;--xy-edge-label-color-default: inherit;--xy-resize-background-color-default: #3367d9}.react-flow.dark{--xy-edge-stroke-default: #3e3e3e;--xy-edge-stroke-width-default: 1;--xy-edge-stroke-selected-default: #727272;--xy-connectionline-stroke-default: #b1b1b7;--xy-connectionline-stroke-width-default: 1;--xy-attribution-background-color-default: rgba(150, 150, 150, .25);--xy-minimap-background-color-default: #141414;--xy-minimap-mask-background-color-default: rgba(60, 60, 60, .6);--xy-minimap-mask-stroke-color-default: transparent;--xy-minimap-mask-stroke-width-default: 1;--xy-minimap-node-background-color-default: #2b2b2b;--xy-minimap-node-stroke-color-default: transparent;--xy-minimap-node-stroke-width-default: 2;--xy-background-color-default: #141414;--xy-background-pattern-dots-color-default: #555;--xy-background-pattern-lines-color-default: #333;--xy-background-pattern-cross-color-default: #333;--xy-node-color-default: #f8f8f8;--xy-node-border-default: 1px solid #3c3c3c;--xy-node-background-color-default: #1e1e1e;--xy-node-group-background-color-default: rgba(240, 240, 240, .25);--xy-node-boxshadow-hover-default: 0 1px 4px 1px rgba(255, 255, 255, .08);--xy-node-boxshadow-selected-default: 0 0 0 .5px #999;--xy-handle-background-color-default: #bebebe;--xy-handle-border-color-default: #1e1e1e;--xy-selection-background-color-default: rgba(200, 200, 220, .08);--xy-selection-border-default: 1px dotted rgba(200, 200, 220, .8);--xy-controls-button-background-color-default: #2b2b2b;--xy-controls-button-background-color-hover-default: #3e3e3e;--xy-controls-button-color-default: #f8f8f8;--xy-controls-button-color-hover-default: #fff;--xy-controls-button-border-color-default: #5b5b5b;--xy-controls-box-shadow-default: 0 0 2px 1px rgba(0, 0, 0, .08);--xy-edge-label-background-color-default: #141414;--xy-edge-label-color-default: #f8f8f8}.react-flow__background{background-color:var(--xy-background-color-props, var(--xy-background-color, var(--xy-background-color-default)));pointer-events:none;z-index:-1}.react-flow__container{position:absolute;width:100%;height:100%;top:0;left:0}.react-flow__pane{z-index:1;touch-action:none}.react-flow__pane.draggable{cursor:grab}.react-flow__pane.dragging{cursor:grabbing}.react-flow__pane.selection{cursor:pointer}.react-flow__viewport{transform-origin:0 0;z-index:2;pointer-events:none}.react-flow__renderer{z-index:4}.react-flow__selection{z-index:6}.react-flow__nodesselection-rect:focus,.react-flow__nodesselection-rect:focus-visible{outline:none}.react-flow__edge-path{stroke:var(--xy-edge-stroke, var(--xy-edge-stroke-default));stroke-width:var(--xy-edge-stroke-width, var(--xy-edge-stroke-width-default));fill:none}.react-flow__connection-path{stroke:var(--xy-connectionline-stroke, var(--xy-connectionline-stroke-default));stroke-width:var(--xy-connectionline-stroke-width, var(--xy-connectionline-stroke-width-default));fill:none}.react-flow .react-flow__edges{position:absolute}.react-flow .react-flow__edges svg{overflow:visible;position:absolute;pointer-events:none}.react-flow__edge{pointer-events:visibleStroke}.react-flow__edge.selectable{cursor:pointer}.react-flow__edge.animated path{stroke-dasharray:5;animation:dashdraw .5s linear infinite}.react-flow__edge.animated path.react-flow__edge-interaction{stroke-dasharray:none;animation:none}.react-flow__edge.inactive{pointer-events:none}.react-flow__edge.selected,.react-flow__edge:focus,.react-flow__edge:focus-visible{outline:none}.react-flow__edge.selected .react-flow__edge-path,.react-flow__edge.selectable:focus .react-flow__edge-path,.react-flow__edge.selectable:focus-visible .react-flow__edge-path{stroke:var(--xy-edge-stroke-selected, var(--xy-edge-stroke-selected-default))}.react-flow__edge-textwrapper{pointer-events:all}.react-flow__edge .react-flow__edge-text{pointer-events:none;-webkit-user-select:none;-moz-user-select:none;user-select:none}.react-flow__arrowhead polyline{stroke:var(--xy-edge-stroke, var(--xy-edge-stroke-default))}.react-flow__arrowhead polyline.arrowclosed{fill:var(--xy-edge-stroke, var(--xy-edge-stroke-default))}.react-flow__connection{pointer-events:none}.react-flow__connection .animated{stroke-dasharray:5;animation:dashdraw .5s linear infinite}svg.react-flow__connectionline{z-index:1001;overflow:visible;position:absolute}.react-flow__nodes{pointer-events:none;transform-origin:0 0}.react-flow__node{position:absolute;-webkit-user-select:none;-moz-user-select:none;user-select:none;pointer-events:all;transform-origin:0 0;box-sizing:border-box;cursor:default}.react-flow__node.selectable{cursor:pointer}.react-flow__node.draggable{cursor:grab;pointer-events:all}.react-flow__node.draggable.dragging{cursor:grabbing}.react-flow__nodesselection{z-index:3;transform-origin:left top;pointer-events:none}.react-flow__nodesselection-rect{position:absolute;pointer-events:all;cursor:grab}.react-flow__handle{position:absolute;pointer-events:none;min-width:5px;min-height:5px;width:6px;height:6px;background-color:var(--xy-handle-background-color, var(--xy-handle-background-color-default));border:1px solid var(--xy-handle-border-color, var(--xy-handle-border-color-default));border-radius:100%}.react-flow__handle.connectingfrom{pointer-events:all}.react-flow__handle.connectionindicator{pointer-events:all;cursor:crosshair}.react-flow__handle-bottom{top:auto;left:50%;bottom:0;transform:translate(-50%,50%)}.react-flow__handle-top{top:0;left:50%;transform:translate(-50%,-50%)}.react-flow__handle-left{top:50%;left:0;transform:translate(-50%,-50%)}.react-flow__handle-right{top:50%;right:0;transform:translate(50%,-50%)}.react-flow__edgeupdater{cursor:move;pointer-events:all}.react-flow__pane.selection .react-flow__panel{pointer-events:none}.react-flow__panel{position:absolute;z-index:5;margin:15px}.react-flow__panel.top{top:0}.react-flow__panel.bottom{bottom:0}.react-flow__panel.top.center,.react-flow__panel.bottom.center{left:50%;transform:translate(-15px) translate(-50%)}.react-flow__panel.left{left:0}.react-flow__panel.right{right:0}.react-flow__panel.left.center,.react-flow__panel.right.center{top:50%;transform:translateY(-15px) translateY(-50%)}.react-flow__attribution{font-size:10px;background:var(--xy-attribution-background-color, var(--xy-attribution-background-color-default));padding:2px 3px;margin:0}.react-flow__attribution a{text-decoration:none;color:#999}@keyframes dashdraw{0%{stroke-dashoffset:10}}.react-flow__edgelabel-renderer{position:absolute;width:100%;height:100%;pointer-events:none;-webkit-user-select:none;-moz-user-select:none;user-select:none;left:0;top:0}.react-flow__viewport-portal{position:absolute;width:100%;height:100%;left:0;top:0;-webkit-user-select:none;-moz-user-select:none;user-select:none}.react-flow__minimap{background:var( --xy-minimap-background-color-props, var(--xy-minimap-background-color, var(--xy-minimap-background-color-default)) )}.react-flow__minimap-svg{display:block}.react-flow__minimap-mask{fill:var( --xy-minimap-mask-background-color-props, var(--xy-minimap-mask-background-color, var(--xy-minimap-mask-background-color-default)) );stroke:var( --xy-minimap-mask-stroke-color-props, var(--xy-minimap-mask-stroke-color, var(--xy-minimap-mask-stroke-color-default)) );stroke-width:var( --xy-minimap-mask-stroke-width-props, var(--xy-minimap-mask-stroke-width, var(--xy-minimap-mask-stroke-width-default)) )}.react-flow__minimap-node{fill:var( --xy-minimap-node-background-color-props, var(--xy-minimap-node-background-color, var(--xy-minimap-node-background-color-default)) );stroke:var( --xy-minimap-node-stroke-color-props, var(--xy-minimap-node-stroke-color, var(--xy-minimap-node-stroke-color-default)) );stroke-width:var( --xy-minimap-node-stroke-width-props, var(--xy-minimap-node-stroke-width, var(--xy-minimap-node-stroke-width-default)) )}.react-flow__background-pattern.dots{fill:var( --xy-background-pattern-color-props, var(--xy-background-pattern-color, var(--xy-background-pattern-dots-color-default)) )}.react-flow__background-pattern.lines{stroke:var( --xy-background-pattern-color-props, var(--xy-background-pattern-color, var(--xy-background-pattern-lines-color-default)) )}.react-flow__background-pattern.cross{stroke:var( --xy-background-pattern-color-props, var(--xy-background-pattern-color, var(--xy-background-pattern-cross-color-default)) )}.react-flow__controls{display:flex;flex-direction:column;box-shadow:var(--xy-controls-box-shadow, var(--xy-controls-box-shadow-default))}.react-flow__controls.horizontal{flex-direction:row}.react-flow__controls-button{display:flex;justify-content:center;align-items:center;height:26px;width:26px;padding:4px;border:none;background:var(--xy-controls-button-background-color, var(--xy-controls-button-background-color-default));border-bottom:1px solid var( --xy-controls-button-border-color-props, var(--xy-controls-button-border-color, var(--xy-controls-button-border-color-default)) );color:var( --xy-controls-button-color-props, var(--xy-controls-button-color, var(--xy-controls-button-color-default)) );cursor:pointer;-webkit-user-select:none;-moz-user-select:none;user-select:none}.react-flow__controls-button svg{width:100%;max-width:12px;max-height:12px;fill:currentColor}.react-flow__edge.updating .react-flow__edge-path{stroke:#777}.react-flow__edge-text{font-size:10px}.react-flow__node.selectable:focus,.react-flow__node.selectable:focus-visible{outline:none}.react-flow__node-input,.react-flow__node-default,.react-flow__node-output,.react-flow__node-group{padding:10px;border-radius:var(--xy-node-border-radius, var(--xy-node-border-radius-default));width:150px;font-size:12px;color:var(--xy-node-color, var(--xy-node-color-default));text-align:center;border:var(--xy-node-border, var(--xy-node-border-default));background-color:var(--xy-node-background-color, var(--xy-node-background-color-default))}.react-flow__node-input.selectable:hover,.react-flow__node-default.selectable:hover,.react-flow__node-output.selectable:hover,.react-flow__node-group.selectable:hover{box-shadow:var(--xy-node-boxshadow-hover, var(--xy-node-boxshadow-hover-default))}.react-flow__node-input.selectable.selected,.react-flow__node-input.selectable:focus,.react-flow__node-input.selectable:focus-visible,.react-flow__node-default.selectable.selected,.react-flow__node-default.selectable:focus,.react-flow__node-default.selectable:focus-visible,.react-flow__node-output.selectable.selected,.react-flow__node-output.selectable:focus,.react-flow__node-output.selectable:focus-visible,.react-flow__node-group.selectable.selected,.react-flow__node-group.selectable:focus,.react-flow__node-group.selectable:focus-visible{box-shadow:var(--xy-node-boxshadow-selected, var(--xy-node-boxshadow-selected-default))}.react-flow__node-group{background-color:var(--xy-node-group-background-color, var(--xy-node-group-background-color-default))}.react-flow__nodesselection-rect,.react-flow__selection{background:var(--xy-selection-background-color, var(--xy-selection-background-color-default));border:var(--xy-selection-border, var(--xy-selection-border-default))}.react-flow__nodesselection-rect:focus,.react-flow__nodesselection-rect:focus-visible,.react-flow__selection:focus,.react-flow__selection:focus-visible{outline:none}.react-flow__controls-button:hover{background:var( --xy-controls-button-background-color-hover-props, var(--xy-controls-button-background-color-hover, var(--xy-controls-button-background-color-hover-default)) );color:var( --xy-controls-button-color-hover-props, var(--xy-controls-button-color-hover, var(--xy-controls-button-color-hover-default)) )}.react-flow__controls-button:disabled{pointer-events:none}.react-flow__controls-button:disabled svg{fill-opacity:.4}.react-flow__controls-button:last-child{border-bottom:none}.react-flow__controls.horizontal .react-flow__controls-button{border-bottom:none;border-right:1px solid var( --xy-controls-button-border-color-props, var(--xy-controls-button-border-color, var(--xy-controls-button-border-color-default)) )}.react-flow__controls.horizontal .react-flow__controls-button:last-child{border-right:none}.react-flow__resize-control{position:absolute}.react-flow__resize-control.left,.react-flow__resize-control.right{cursor:ew-resize}.react-flow__resize-control.top,.react-flow__resize-control.bottom{cursor:ns-resize}.react-flow__resize-control.top.left,.react-flow__resize-control.bottom.right{cursor:nwse-resize}.react-flow__resize-control.bottom.left,.react-flow__resize-control.top.right{cursor:nesw-resize}.react-flow__resize-control.handle{width:5px;height:5px;border:1px solid #fff;border-radius:1px;background-color:var(--xy-resize-background-color, var(--xy-resize-background-color-default));translate:-50% -50%}.react-flow__resize-control.handle.left{left:0;top:50%}.react-flow__resize-control.handle.right{left:100%;top:50%}.react-flow__resize-control.handle.top{left:50%;top:0}.react-flow__resize-control.handle.bottom{left:50%;top:100%}.react-flow__resize-control.handle.top.left,.react-flow__resize-control.handle.bottom.left{left:0}.react-flow__resize-control.handle.top.right,.react-flow__resize-control.handle.bottom.right{left:100%}.react-flow__resize-control.line{border-color:var(--xy-resize-background-color, var(--xy-resize-background-color-default));border-width:0;border-style:solid}.react-flow__resize-control.line.left,.react-flow__resize-control.line.right{width:1px;transform:translate(-50%);top:0;height:100%}.react-flow__resize-control.line.left{left:0;border-left-width:1px}.react-flow__resize-control.line.right{left:100%;border-right-width:1px}.react-flow__resize-control.line.top,.react-flow__resize-control.line.bottom{height:1px;transform:translateY(-50%);left:0;width:100%}.react-flow__resize-control.line.top{top:0;border-top-width:1px}.react-flow__resize-control.line.bottom{border-bottom-width:1px;top:100%}.react-flow__edge-textbg{fill:var(--xy-edge-label-background-color, var(--xy-edge-label-background-color-default))}.react-flow__edge-text{fill:var(--xy-edge-label-color, var(--xy-edge-label-color-default))}/*! tailwindcss v4.3.3 | MIT License | https://tailwindcss.com */@layer properties{@supports (((-webkit-hyphens:none)) and (not (margin-trim:inline))) or ((-moz-orient:inline) and (not (color:rgb(from red r g b)))){*,:before,:after,::backdrop{--tw-translate-x:0;--tw-translate-y:0;--tw-translate-z:0;--tw-space-y-reverse:0;--tw-border-style:solid;--tw-gradient-position:initial;--tw-gradient-from:#0000;--tw-gradient-via:#0000;--tw-gradient-to:#0000;--tw-gradient-stops:initial;--tw-gradient-via-stops:initial;--tw-gradient-from-position:0%;--tw-gradient-via-position:50%;--tw-gradient-to-position:100%;--tw-leading:initial;--tw-font-weight:initial;--tw-tracking:initial;--tw-ordinal:initial;--tw-slashed-zero:initial;--tw-numeric-figure:initial;--tw-numeric-spacing:initial;--tw-numeric-fraction:initial;--tw-shadow:0 0 #0000;--tw-shadow-color:initial;--tw-shadow-alpha:100%;--tw-inset-shadow:0 0 #0000;--tw-inset-shadow-color:initial;--tw-inset-shadow-alpha:100%;--tw-ring-color:initial;--tw-ring-shadow:0 0 #0000;--tw-inset-ring-color:initial;--tw-inset-ring-shadow:0 0 #0000;--tw-ring-inset:initial;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-offset-shadow:0 0 #0000;--tw-blur:initial;--tw-brightness:initial;--tw-contrast:initial;--tw-grayscale:initial;--tw-hue-rotate:initial;--tw-invert:initial;--tw-opacity:initial;--tw-saturate:initial;--tw-sepia:initial;--tw-drop-shadow:initial;--tw-drop-shadow-color:initial;--tw-drop-shadow-alpha:100%;--tw-drop-shadow-size:initial;--tw-duration:initial;--tw-ease:initial}}}@layer theme{:root,:host{--color-red-300:oklch(80.8% .114 19.571);--color-red-400:oklch(70.4% .191 22.216);--color-red-500:oklch(63.7% .237 25.331);--color-orange-400:oklch(75% .183 55.934);--color-orange-500:oklch(70.5% .213 47.604);--color-amber-400:oklch(82.8% .189 84.429);--color-yellow-400:oklch(85.2% .199 91.936);--color-yellow-500:oklch(79.5% .184 86.047);--color-emerald-200:oklch(90.5% .093 164.15);--color-emerald-400:oklch(76.5% .177 163.223);--color-emerald-500:oklch(69.6% .17 162.48);--color-cyan-400:oklch(78.9% .154 211.53);--color-cyan-500:oklch(71.5% .143 215.221);--color-sky-400:oklch(74.6% .16 232.661);--color-blue-400:oklch(70.7% .165 254.624);--color-blue-500:oklch(62.3% .214 259.815);--color-purple-400:oklch(71.4% .203 305.504);--color-purple-500:oklch(62.7% .265 303.9);--color-gray-400:oklch(70.7% .022 261.325);--color-gray-500:oklch(55.1% .027 264.364);--color-neutral-200:oklch(92.2% 0 none);--color-black:#000;--color-white:#fff;--spacing:.25rem;--container-xs:20rem;--container-sm:24rem;--container-md:28rem;--container-xl:36rem;--container-6xl:72rem;--text-xs:.75rem;--text-xs--line-height:calc(1 / .75);--text-sm:.875rem;--text-sm--line-height:calc(1.25 / .875);--text-base:1rem;--text-base--line-height: 1.5 ;--text-lg:1.125rem;--text-lg--line-height:calc(1.75 / 1.125);--text-xl:1.25rem;--text-xl--line-height:calc(1.75 / 1.25);--text-2xl:1.5rem;--text-2xl--line-height:calc(2 / 1.5);--font-weight-medium:500;--font-weight-semibold:600;--font-weight-bold:700;--tracking-tight:-.025em;--tracking-wide:.025em;--tracking-wider:.05em;--leading-snug:1.375;--leading-relaxed:1.625;--radius-md:.375rem;--radius-lg:.5rem;--radius-xl:.75rem;--radius-2xl:1rem;--ease-out:cubic-bezier(0, 0, .2, 1);--animate-spin:spin 1s linear infinite;--animate-ping:ping 1s cubic-bezier(0, 0, .2, 1) infinite;--animate-pulse:pulse 2s cubic-bezier(.4, 0, .6, 1) infinite;--default-transition-duration:.15s;--default-transition-timing-function:cubic-bezier(.4, 0, .2, 1);--default-font-family:var(--font-geist-sans);--default-mono-font-family:var(--font-geist-mono)}}@layer base{*,:after,:before,::backdrop{box-sizing:border-box;border:0 solid;margin:0;padding:0}::file-selector-button{box-sizing:border-box;border:0 solid;margin:0;padding:0}html,:host{-webkit-text-size-adjust:100%;-moz-tab-size:4;tab-size:4;line-height:1.5;font-family:var(--default-font-family,-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", "Noto Sans", Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji");font-feature-settings:var(--default-font-feature-settings,normal);font-variation-settings:var(--default-font-variation-settings,normal);-webkit-tap-highlight-color:transparent}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;-webkit-text-decoration:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:var(--default-mono-font-family,ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace);font-feature-settings:var(--default-mono-font-feature-settings,normal);font-variation-settings:var(--default-mono-font-variation-settings,normal);font-size:1em}small{font-size:80%}sub,sup{vertical-align:baseline;font-size:75%;line-height:0;position:relative}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}:-moz-focusring:where(:not(iframe)){outline:auto}progress{vertical-align:baseline}summary{display:list-item}ol,ul,menu{list-style:none}img,svg,video,canvas,audio,iframe,embed,object{vertical-align:middle;display:block}img,video{max-width:100%;height:auto}button,input,select,optgroup,textarea{font:inherit;font-feature-settings:inherit;font-variation-settings:inherit;letter-spacing:inherit;color:inherit;opacity:1;background-color:#0000;border-radius:0}::file-selector-button{font:inherit;font-feature-settings:inherit;font-variation-settings:inherit;letter-spacing:inherit;color:inherit;opacity:1;background-color:#0000;border-radius:0}:where(select:is([multiple],[size])) optgroup{font-weight:bolder}:where(select:is([multiple],[size])) optgroup option{padding-inline-start:20px}::file-selector-button{margin-inline-end:4px}::placeholder{opacity:1}@supports (not ((-webkit-appearance:-apple-pay-button))) or (contain-intrinsic-size:1px){::placeholder{color:currentColor}@supports (color:color-mix(in lab,red,red)){::placeholder{color:color-mix(in oklab,currentcolor 50%,transparent)}}}textarea{resize:vertical}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-date-and-time-value{min-height:1lh;text-align:inherit}::-webkit-datetime-edit{display:inline-flex}::-webkit-datetime-edit-fields-wrapper{padding:0}::-webkit-datetime-edit{padding-block:0}::-webkit-datetime-edit-year-field{padding-block:0}::-webkit-datetime-edit-month-field{padding-block:0}::-webkit-datetime-edit-day-field{padding-block:0}::-webkit-datetime-edit-hour-field{padding-block:0}::-webkit-datetime-edit-minute-field{padding-block:0}::-webkit-datetime-edit-second-field{padding-block:0}::-webkit-datetime-edit-millisecond-field{padding-block:0}::-webkit-datetime-edit-meridiem-field{padding-block:0}::-webkit-calendar-picker-indicator{line-height:1}:-moz-ui-invalid{box-shadow:none}button,input:where([type=button],[type=reset],[type=submit]){-webkit-appearance:button;-moz-appearance:button;appearance:button}::file-selector-button{-webkit-appearance:button;-moz-appearance:button;appearance:button}::-webkit-inner-spin-button{height:auto}::-webkit-outer-spin-button{height:auto}[hidden]:where(:not([hidden=until-found])){display:none!important}}@layer components;@layer utilities{.pointer-events-none{pointer-events:none}.collapse{visibility:collapse}.visible{visibility:visible}.absolute{position:absolute}.fixed{position:fixed}.relative{position:relative}.static{position:static}.sticky{position:sticky}.inset-0{top:0;right:0;bottom:0;left:0}.inset-x-0{inset-inline:0}.top-0{top:0}.top-2{top:calc(var(--spacing) * 2)}.top-4{top:calc(var(--spacing) * 4)}.right-0{right:0}.right-2{right:calc(var(--spacing) * 2)}.right-4{right:calc(var(--spacing) * 4)}.bottom-0{bottom:0}.bottom-3{bottom:calc(var(--spacing) * 3)}.bottom-full{bottom:100%}.left-0{left:0}.left-1\/2{left:50%}.left-2{left:calc(var(--spacing) * 2)}.left-3{left:calc(var(--spacing) * 3)}.z-10{z-index:10}.z-20{z-index:20}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.z-\[60\]{z-index:60}.-mx-2{margin-inline:calc(var(--spacing) * -2)}.mx-0{margin-inline:0}.mx-auto{margin-inline:auto}.my-1{margin-block:var(--spacing)}.my-4{margin-block:calc(var(--spacing) * 4)}.-mt-0\.5{margin-top:calc(var(--spacing) * -.5)}.mt-0{margin-top:0}.mt-0\.5{margin-top:calc(var(--spacing) * .5)}.mt-1{margin-top:var(--spacing)}.mt-1\.5{margin-top:calc(var(--spacing) * 1.5)}.mt-2{margin-top:calc(var(--spacing) * 2)}.mt-3{margin-top:calc(var(--spacing) * 3)}.mt-4{margin-top:calc(var(--spacing) * 4)}.mt-5{margin-top:calc(var(--spacing) * 5)}.mt-10{margin-top:calc(var(--spacing) * 10)}.mt-\[1px\]{margin-top:1px}.-mr-0\.5{margin-right:calc(var(--spacing) * -.5)}.mr-1{margin-right:var(--spacing)}.mr-2{margin-right:calc(var(--spacing) * 2)}.mb-1{margin-bottom:var(--spacing)}.mb-1\.5{margin-bottom:calc(var(--spacing) * 1.5)}.mb-2{margin-bottom:calc(var(--spacing) * 2)}.mb-2\.5{margin-bottom:calc(var(--spacing) * 2.5)}.mb-3{margin-bottom:calc(var(--spacing) * 3)}.mb-4{margin-bottom:calc(var(--spacing) * 4)}.ml-0\.5{margin-left:calc(var(--spacing) * .5)}.ml-1{margin-left:var(--spacing)}.ml-1\.5{margin-left:calc(var(--spacing) * 1.5)}.ml-2{margin-left:calc(var(--spacing) * 2)}.ml-3{margin-left:calc(var(--spacing) * 3)}.ml-auto{margin-left:auto}.line-clamp-3{-webkit-line-clamp:3;-webkit-box-orient:vertical;display:-webkit-box;overflow:hidden}.block{display:block}.flex{display:flex}.grid{display:grid}.hidden{display:none}.inline{display:inline}.inline-flex{display:inline-flex}.\!h-1\.5{height:calc(var(--spacing) * 1.5)!important}.h-0\.5{height:calc(var(--spacing) * .5)}.h-1\.5{height:calc(var(--spacing) * 1.5)}.h-2{height:calc(var(--spacing) * 2)}.h-2\.5{height:calc(var(--spacing) * 2.5)}.h-3{height:calc(var(--spacing) * 3)}.h-3\.5{height:calc(var(--spacing) * 3.5)}.h-4{height:calc(var(--spacing) * 4)}.h-5{height:calc(var(--spacing) * 5)}.h-6{height:calc(var(--spacing) * 6)}.h-7{height:calc(var(--spacing) * 7)}.h-8{height:calc(var(--spacing) * 8)}.h-9{height:calc(var(--spacing) * 9)}.h-10{height:calc(var(--spacing) * 10)}.h-11{height:calc(var(--spacing) * 11)}.h-\[30px\]{height:30px}.h-\[60vh\]{height:60vh}.h-\[72px\]{height:72px}.h-\[480px\]{height:480px}.h-full{height:100%}.h-px{height:1px}.h-screen{height:100vh}.max-h-96{max-height:calc(var(--spacing) * 96)}.max-h-\[160px\]{max-height:160px}.max-h-\[400px\]{max-height:400px}.max-h-\[1200px\]{max-height:1200px}.min-h-screen{min-height:100vh}.\!w-1\.5{width:calc(var(--spacing) * 1.5)!important}.w-0\.5{width:calc(var(--spacing) * .5)}.w-1{width:var(--spacing)}.w-1\.5{width:calc(var(--spacing) * 1.5)}.w-2{width:calc(var(--spacing) * 2)}.w-2\.5{width:calc(var(--spacing) * 2.5)}.w-3{width:calc(var(--spacing) * 3)}.w-3\.5{width:calc(var(--spacing) * 3.5)}.w-4{width:calc(var(--spacing) * 4)}.w-5{width:calc(var(--spacing) * 5)}.w-6{width:calc(var(--spacing) * 6)}.w-7{width:calc(var(--spacing) * 7)}.w-8{width:calc(var(--spacing) * 8)}.w-9{width:calc(var(--spacing) * 9)}.w-10{width:calc(var(--spacing) * 10)}.w-11{width:calc(var(--spacing) * 11)}.w-28{width:calc(var(--spacing) * 28)}.w-96{width:calc(var(--spacing) * 96)}.w-\[1px\]{width:1px}.w-\[30px\]{width:30px}.w-\[180px\]{width:180px}.w-\[260px\]{width:260px}.w-\[calc\(100vw-4rem\)\]{width:calc(100vw - 4rem)}.w-full{width:100%}.w-max{width:max-content}.w-px{width:1px}.max-w-6xl{max-width:var(--container-6xl)}.max-w-\[75\%\]{max-width:75%}.max-w-\[80\%\]{max-width:80%}.max-w-\[88rem\]{max-width:88rem}.max-w-\[140px\]{max-width:140px}.max-w-\[240px\]{max-width:240px}.max-w-\[260px\]{max-width:260px}.max-w-md{max-width:var(--container-md)}.max-w-sm{max-width:var(--container-sm)}.max-w-xl{max-width:var(--container-xl)}.max-w-xs{max-width:var(--container-xs)}.min-w-0{min-width:0}.min-w-\[80px\]{min-width:80px}.min-w-\[112px\]{min-width:112px}.min-w-\[160px\]{min-width:160px}.flex-1{flex:1}.flex-none{flex:none}.flex-shrink-0,.shrink-0{flex-shrink:0}.border-collapse{border-collapse:collapse}.origin-left{transform-origin:0}.-translate-x-1\/2{--tw-translate-x: -50% ;translate:var(--tw-translate-x) var(--tw-translate-y)}.-rotate-90{rotate:-90deg}.animate-ping{animation:var(--animate-ping)}.animate-pulse{animation:var(--animate-pulse)}.animate-spin{animation:var(--animate-spin)}.cursor-col-resize{cursor:col-resize}.cursor-pointer{cursor:pointer}.resize{resize:both}.resize-none{resize:none}.resize-y{resize:vertical}.scrollbar-thin{scrollbar-width:thin}.grid-cols-1{grid-template-columns:repeat(1,minmax(0,1fr))}.grid-cols-\[7rem_1fr\]{grid-template-columns:7rem 1fr}.flex-col{flex-direction:column}.flex-row{flex-direction:row}.flex-wrap{flex-wrap:wrap}.place-content-center{place-content:center}.items-baseline{align-items:baseline}.items-center{align-items:center}.items-start{align-items:flex-start}.items-stretch{align-items:stretch}.justify-between{justify-content:space-between}.justify-center{justify-content:center}.gap-0\.5{gap:calc(var(--spacing) * .5)}.gap-1{gap:var(--spacing)}.gap-1\.5{gap:calc(var(--spacing) * 1.5)}.gap-2{gap:calc(var(--spacing) * 2)}.gap-2\.5{gap:calc(var(--spacing) * 2.5)}.gap-3{gap:calc(var(--spacing) * 3)}.gap-4{gap:calc(var(--spacing) * 4)}.gap-5{gap:calc(var(--spacing) * 5)}.gap-6{gap:calc(var(--spacing) * 6)}.gap-8{gap:calc(var(--spacing) * 8)}.gap-10{gap:calc(var(--spacing) * 10)}.gap-px{gap:1px}:where(.space-y-0>:not(:last-child)){--tw-space-y-reverse:0;margin-block:0}:where(.space-y-0\.5>:not(:last-child)){--tw-space-y-reverse:0;margin-block-start:calc(calc(var(--spacing) * .5) * var(--tw-space-y-reverse));margin-block-end:calc(calc(var(--spacing) * .5) * calc(1 - var(--tw-space-y-reverse)))}:where(.space-y-1>:not(:last-child)){--tw-space-y-reverse:0;margin-block-start:calc(var(--spacing) * var(--tw-space-y-reverse));margin-block-end:calc(var(--spacing) * calc(1 - var(--tw-space-y-reverse)))}:where(.space-y-2>:not(:last-child)){--tw-space-y-reverse:0;margin-block-start:calc(calc(var(--spacing) * 2) * var(--tw-space-y-reverse));margin-block-end:calc(calc(var(--spacing) * 2) * calc(1 - var(--tw-space-y-reverse)))}:where(.space-y-2\.5>:not(:last-child)){--tw-space-y-reverse:0;margin-block-start:calc(calc(var(--spacing) * 2.5) * var(--tw-space-y-reverse));margin-block-end:calc(calc(var(--spacing) * 2.5) * calc(1 - var(--tw-space-y-reverse)))}:where(.space-y-3>:not(:last-child)){--tw-space-y-reverse:0;margin-block-start:calc(calc(var(--spacing) * 3) * var(--tw-space-y-reverse));margin-block-end:calc(calc(var(--spacing) * 3) * calc(1 - var(--tw-space-y-reverse)))}:where(.space-y-4>:not(:last-child)){--tw-space-y-reverse:0;margin-block-start:calc(calc(var(--spacing) * 4) * var(--tw-space-y-reverse));margin-block-end:calc(calc(var(--spacing) * 4) * calc(1 - var(--tw-space-y-reverse)))}:where(.space-y-5>:not(:last-child)){--tw-space-y-reverse:0;margin-block-start:calc(calc(var(--spacing) * 5) * var(--tw-space-y-reverse));margin-block-end:calc(calc(var(--spacing) * 5) * calc(1 - var(--tw-space-y-reverse)))}:where(.space-y-6>:not(:last-child)){--tw-space-y-reverse:0;margin-block-start:calc(calc(var(--spacing) * 6) * var(--tw-space-y-reverse));margin-block-end:calc(calc(var(--spacing) * 6) * calc(1 - var(--tw-space-y-reverse)))}:where(.space-y-8>:not(:last-child)){--tw-space-y-reverse:0;margin-block-start:calc(calc(var(--spacing) * 8) * var(--tw-space-y-reverse));margin-block-end:calc(calc(var(--spacing) * 8) * calc(1 - var(--tw-space-y-reverse)))}.gap-x-2{column-gap:calc(var(--spacing) * 2)}.gap-x-3{column-gap:calc(var(--spacing) * 3)}.gap-x-6{column-gap:calc(var(--spacing) * 6)}.gap-x-8{column-gap:calc(var(--spacing) * 8)}.gap-y-0\.5{row-gap:calc(var(--spacing) * .5)}.gap-y-1{row-gap:var(--spacing)}.gap-y-2{row-gap:calc(var(--spacing) * 2)}.gap-y-3{row-gap:calc(var(--spacing) * 3)}.gap-y-6{row-gap:calc(var(--spacing) * 6)}.truncate{text-overflow:ellipsis;white-space:nowrap;overflow:hidden}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-x-clip{overflow-x:clip}.overflow-y-auto{overflow-y:auto}.rounded{border-radius:.25rem}.rounded-2xl{border-radius:var(--radius-2xl)}.rounded-full{border-radius:3.40282e38px}.rounded-lg{border-radius:var(--radius-lg)}.rounded-md{border-radius:var(--radius-md)}.rounded-xl{border-radius:var(--radius-xl)}.\!border-0{border-style:var(--tw-border-style)!important;border-width:0!important}.border{border-style:var(--tw-border-style);border-width:1px}.border-0{border-style:var(--tw-border-style);border-width:0}.border-2{border-style:var(--tw-border-style);border-width:2px}.border-y{border-block-style:var(--tw-border-style);border-block-width:1px}.border-t{border-top-style:var(--tw-border-style);border-top-width:1px}.border-r{border-right-style:var(--tw-border-style);border-right-width:1px}.border-b{border-bottom-style:var(--tw-border-style);border-bottom-width:1px}.\!border-none{--tw-border-style:none!important;border-style:none!important}.\!border-\[\#222\]{border-color:#222!important}.border-\[\#1a1a1a\]{border-color:#1a1a1a}.border-\[\#2a2a2a\]{border-color:#2a2a2a}.border-\[\#3a3a3a\]{border-color:#3a3a3a}.border-\[\#22c55e\]\/40{border-color:#22c55e66}.border-\[\#222\]{border-color:#222}.border-\[\#333\]{border-color:#333}.border-\[\#444\]{border-color:#444}.border-\[\#191919\]{border-color:#191919}.border-\[rgba\(255\,255\,255\,0\.08\)\]{border-color:#ffffff14}.border-blue-500\/20{border-color:#3080ff33}@supports (color:color-mix(in lab,red,red)){.border-blue-500\/20{border-color:color-mix(in oklab,var(--color-blue-500) 20%,transparent)}}.border-blue-500\/30{border-color:#3080ff4d}@supports (color:color-mix(in lab,red,red)){.border-blue-500\/30{border-color:color-mix(in oklab,var(--color-blue-500) 30%,transparent)}}.border-blue-500\/40{border-color:#3080ff66}@supports (color:color-mix(in lab,red,red)){.border-blue-500\/40{border-color:color-mix(in oklab,var(--color-blue-500) 40%,transparent)}}.border-emerald-500\/20{border-color:#00bb7f33}@supports (color:color-mix(in lab,red,red)){.border-emerald-500\/20{border-color:color-mix(in oklab,var(--color-emerald-500) 20%,transparent)}}.border-emerald-500\/25{border-color:#00bb7f40}@supports (color:color-mix(in lab,red,red)){.border-emerald-500\/25{border-color:color-mix(in oklab,var(--color-emerald-500) 25%,transparent)}}.border-emerald-500\/30{border-color:#00bb7f4d}@supports (color:color-mix(in lab,red,red)){.border-emerald-500\/30{border-color:color-mix(in oklab,var(--color-emerald-500) 30%,transparent)}}.border-gray-500\/20{border-color:#6a728233}@supports (color:color-mix(in lab,red,red)){.border-gray-500\/20{border-color:color-mix(in oklab,var(--color-gray-500) 20%,transparent)}}.border-orange-500\/20{border-color:#fe6e0033}@supports (color:color-mix(in lab,red,red)){.border-orange-500\/20{border-color:color-mix(in oklab,var(--color-orange-500) 20%,transparent)}}.border-orange-500\/30{border-color:#fe6e004d}@supports (color:color-mix(in lab,red,red)){.border-orange-500\/30{border-color:color-mix(in oklab,var(--color-orange-500) 30%,transparent)}}.border-purple-500\/20{border-color:#ac4bff33}@supports (color:color-mix(in lab,red,red)){.border-purple-500\/20{border-color:color-mix(in oklab,var(--color-purple-500) 20%,transparent)}}.border-red-500\/20{border-color:#fb2c3633}@supports (color:color-mix(in lab,red,red)){.border-red-500\/20{border-color:color-mix(in oklab,var(--color-red-500) 20%,transparent)}}.border-red-500\/25{border-color:#fb2c3640}@supports (color:color-mix(in lab,red,red)){.border-red-500\/25{border-color:color-mix(in oklab,var(--color-red-500) 25%,transparent)}}.border-red-500\/30{border-color:#fb2c364d}@supports (color:color-mix(in lab,red,red)){.border-red-500\/30{border-color:color-mix(in oklab,var(--color-red-500) 30%,transparent)}}.border-white\/10{border-color:#ffffff1a}@supports (color:color-mix(in lab,red,red)){.border-white\/10{border-color:color-mix(in oklab,var(--color-white) 10%,transparent)}}.border-white\/30{border-color:#ffffff4d}@supports (color:color-mix(in lab,red,red)){.border-white\/30{border-color:color-mix(in oklab,var(--color-white) 30%,transparent)}}.border-white\/\[0\.06\]{border-color:#ffffff0f}@supports (color:color-mix(in lab,red,red)){.border-white\/\[0\.06\]{border-color:color-mix(in oklab,var(--color-white) 6%,transparent)}}.border-white\/\[0\.08\]{border-color:#ffffff14}@supports (color:color-mix(in lab,red,red)){.border-white\/\[0\.08\]{border-color:color-mix(in oklab,var(--color-white) 8%,transparent)}}.border-white\/\[0\.18\]{border-color:#ffffff2e}@supports (color:color-mix(in lab,red,red)){.border-white\/\[0\.18\]{border-color:color-mix(in oklab,var(--color-white) 18%,transparent)}}.border-yellow-500\/20{border-color:#edb20033}@supports (color:color-mix(in lab,red,red)){.border-yellow-500\/20{border-color:color-mix(in oklab,var(--color-yellow-500) 20%,transparent)}}.border-yellow-500\/25{border-color:#edb20040}@supports (color:color-mix(in lab,red,red)){.border-yellow-500\/25{border-color:color-mix(in oklab,var(--color-yellow-500) 25%,transparent)}}.border-yellow-500\/30{border-color:#edb2004d}@supports (color:color-mix(in lab,red,red)){.border-yellow-500\/30{border-color:color-mix(in oklab,var(--color-yellow-500) 30%,transparent)}}.border-t-white{border-top-color:var(--color-white)}.\!bg-\[\#0a0a0a\]{background-color:#0a0a0a!important}.\!bg-\[\#444\]{background-color:#444!important}.\!bg-transparent{background-color:#0000!important}.bg-\[\#0a0a0a\]{background-color:#0a0a0a}.bg-\[\#1a1a1a\]{background-color:#1a1a1a}.bg-\[\#1e1e1e\]{background-color:#1e1e1e}.bg-\[\#2a2a2a\]{background-color:#2a2a2a}.bg-\[\#22c55e\]\/10{background-color:#22c55e1a}.bg-\[\#111\]{background-color:#111}.bg-\[\#222\]{background-color:#222}.bg-\[\#555\]{background-color:#555}.bg-\[\#888\]{background-color:#888}.bg-\[\#050505\]{background-color:#050505}.bg-\[\#252525\]{background-color:#252525}.bg-\[rgba\(255\,255\,255\,0\.02\)\]{background-color:#ffffff05}.bg-\[rgba\(255\,255\,255\,0\.3\)\]{background-color:#ffffff4d}.bg-\[rgba\(255\,255\,255\,0\.04\)\]{background-color:#ffffff0a}.bg-\[rgba\(255\,255\,255\,0\.05\)\]{background-color:#ffffff0d}.bg-\[rgba\(255\,255\,255\,0\.08\)\]{background-color:#ffffff14}.bg-\[rgba\(255\,255\,255\,0\.12\)\]{background-color:#ffffff1f}.bg-black{background-color:var(--color-black)}.bg-black\/80{background-color:#000c}@supports (color:color-mix(in lab,red,red)){.bg-black\/80{background-color:color-mix(in oklab,var(--color-black) 80%,transparent)}}.bg-blue-400{background-color:var(--color-blue-400)}.bg-blue-500{background-color:var(--color-blue-500)}.bg-blue-500\/10{background-color:#3080ff1a}@supports (color:color-mix(in lab,red,red)){.bg-blue-500\/10{background-color:color-mix(in oklab,var(--color-blue-500) 10%,transparent)}}.bg-blue-500\/20{background-color:#3080ff33}@supports (color:color-mix(in lab,red,red)){.bg-blue-500\/20{background-color:color-mix(in oklab,var(--color-blue-500) 20%,transparent)}}.bg-blue-500\/\[0\.12\]{background-color:#3080ff1f}@supports (color:color-mix(in lab,red,red)){.bg-blue-500\/\[0\.12\]{background-color:color-mix(in oklab,var(--color-blue-500) 12%,transparent)}}.bg-emerald-400{background-color:var(--color-emerald-400)}.bg-emerald-500{background-color:var(--color-emerald-500)}.bg-emerald-500\/5{background-color:#00bb7f0d}@supports (color:color-mix(in lab,red,red)){.bg-emerald-500\/5{background-color:color-mix(in oklab,var(--color-emerald-500) 5%,transparent)}}.bg-emerald-500\/10{background-color:#00bb7f1a}@supports (color:color-mix(in lab,red,red)){.bg-emerald-500\/10{background-color:color-mix(in oklab,var(--color-emerald-500) 10%,transparent)}}.bg-emerald-500\/\[0\.06\]{background-color:#00bb7f0f}@supports (color:color-mix(in lab,red,red)){.bg-emerald-500\/\[0\.06\]{background-color:color-mix(in oklab,var(--color-emerald-500) 6%,transparent)}}.bg-gray-500{background-color:var(--color-gray-500)}.bg-gray-500\/10{background-color:#6a72821a}@supports (color:color-mix(in lab,red,red)){.bg-gray-500\/10{background-color:color-mix(in oklab,var(--color-gray-500) 10%,transparent)}}.bg-orange-500{background-color:var(--color-orange-500)}.bg-orange-500\/10{background-color:#fe6e001a}@supports (color:color-mix(in lab,red,red)){.bg-orange-500\/10{background-color:color-mix(in oklab,var(--color-orange-500) 10%,transparent)}}.bg-orange-500\/20{background-color:#fe6e0033}@supports (color:color-mix(in lab,red,red)){.bg-orange-500\/20{background-color:color-mix(in oklab,var(--color-orange-500) 20%,transparent)}}.bg-purple-500{background-color:var(--color-purple-500)}.bg-purple-500\/10{background-color:#ac4bff1a}@supports (color:color-mix(in lab,red,red)){.bg-purple-500\/10{background-color:color-mix(in oklab,var(--color-purple-500) 10%,transparent)}}.bg-purple-500\/\[0\.08\]{background-color:#ac4bff14}@supports (color:color-mix(in lab,red,red)){.bg-purple-500\/\[0\.08\]{background-color:color-mix(in oklab,var(--color-purple-500) 8%,transparent)}}.bg-red-400{background-color:var(--color-red-400)}.bg-red-500{background-color:var(--color-red-500)}.bg-red-500\/5{background-color:#fb2c360d}@supports (color:color-mix(in lab,red,red)){.bg-red-500\/5{background-color:color-mix(in oklab,var(--color-red-500) 5%,transparent)}}.bg-red-500\/10{background-color:#fb2c361a}@supports (color:color-mix(in lab,red,red)){.bg-red-500\/10{background-color:color-mix(in oklab,var(--color-red-500) 10%,transparent)}}.bg-red-500\/15{background-color:#fb2c3626}@supports (color:color-mix(in lab,red,red)){.bg-red-500\/15{background-color:color-mix(in oklab,var(--color-red-500) 15%,transparent)}}.bg-red-500\/20{background-color:#fb2c3633}@supports (color:color-mix(in lab,red,red)){.bg-red-500\/20{background-color:color-mix(in oklab,var(--color-red-500) 20%,transparent)}}.bg-red-500\/\[0\.12\]{background-color:#fb2c361f}@supports (color:color-mix(in lab,red,red)){.bg-red-500\/\[0\.12\]{background-color:color-mix(in oklab,var(--color-red-500) 12%,transparent)}}.bg-transparent{background-color:#0000}.bg-white{background-color:var(--color-white)}.bg-white\/8{background-color:#ffffff14}@supports (color:color-mix(in lab,red,red)){.bg-white\/8{background-color:color-mix(in oklab,var(--color-white) 8%,transparent)}}.bg-white\/60{background-color:#fff9}@supports (color:color-mix(in lab,red,red)){.bg-white\/60{background-color:color-mix(in oklab,var(--color-white) 60%,transparent)}}.bg-white\/\[0\.03\]{background-color:#ffffff08}@supports (color:color-mix(in lab,red,red)){.bg-white\/\[0\.03\]{background-color:color-mix(in oklab,var(--color-white) 3%,transparent)}}.bg-white\/\[0\.08\]{background-color:#ffffff14}@supports (color:color-mix(in lab,red,red)){.bg-white\/\[0\.08\]{background-color:color-mix(in oklab,var(--color-white) 8%,transparent)}}.bg-white\/\[0\.015\]{background-color:#ffffff04}@supports (color:color-mix(in lab,red,red)){.bg-white\/\[0\.015\]{background-color:color-mix(in oklab,var(--color-white) 1.5%,transparent)}}.bg-yellow-400{background-color:var(--color-yellow-400)}.bg-yellow-500{background-color:var(--color-yellow-500)}.bg-yellow-500\/10{background-color:#edb2001a}@supports (color:color-mix(in lab,red,red)){.bg-yellow-500\/10{background-color:color-mix(in oklab,var(--color-yellow-500) 10%,transparent)}}.bg-yellow-500\/15{background-color:#edb20026}@supports (color:color-mix(in lab,red,red)){.bg-yellow-500\/15{background-color:color-mix(in oklab,var(--color-yellow-500) 15%,transparent)}}.bg-yellow-500\/20{background-color:#edb20033}@supports (color:color-mix(in lab,red,red)){.bg-yellow-500\/20{background-color:color-mix(in oklab,var(--color-yellow-500) 20%,transparent)}}.bg-gradient-to-br{--tw-gradient-position:to bottom right in oklab;background-image:linear-gradient(var(--tw-gradient-stops))}.from-emerald-400{--tw-gradient-from:var(--color-emerald-400);--tw-gradient-stops:var(--tw-gradient-via-stops,var(--tw-gradient-position), var(--tw-gradient-from) var(--tw-gradient-from-position), var(--tw-gradient-to) var(--tw-gradient-to-position))}.to-cyan-500{--tw-gradient-to:var(--color-cyan-500);--tw-gradient-stops:var(--tw-gradient-via-stops,var(--tw-gradient-position), var(--tw-gradient-from) var(--tw-gradient-from-position), var(--tw-gradient-to) var(--tw-gradient-to-position))}.object-cover{object-fit:cover}.p-0{padding:0}.p-0\.5{padding:calc(var(--spacing) * .5)}.p-1{padding:var(--spacing)}.p-2{padding:calc(var(--spacing) * 2)}.p-3{padding:calc(var(--spacing) * 3)}.p-3\.5{padding:calc(var(--spacing) * 3.5)}.p-4{padding:calc(var(--spacing) * 4)}.p-5{padding:calc(var(--spacing) * 5)}.p-6{padding:calc(var(--spacing) * 6)}.p-8{padding:calc(var(--spacing) * 8)}.p-10{padding:calc(var(--spacing) * 10)}.px-0{padding-inline:0}.px-1\.5{padding-inline:calc(var(--spacing) * 1.5)}.px-2{padding-inline:calc(var(--spacing) * 2)}.px-2\.5{padding-inline:calc(var(--spacing) * 2.5)}.px-3{padding-inline:calc(var(--spacing) * 3)}.px-4{padding-inline:calc(var(--spacing) * 4)}.px-5{padding-inline:calc(var(--spacing) * 5)}.py-0\.5{padding-block:calc(var(--spacing) * .5)}.py-1{padding-block:var(--spacing)}.py-1\.5{padding-block:calc(var(--spacing) * 1.5)}.py-2{padding-block:calc(var(--spacing) * 2)}.py-2\.5{padding-block:calc(var(--spacing) * 2.5)}.py-3{padding-block:calc(var(--spacing) * 3)}.py-3\.5{padding-block:calc(var(--spacing) * 3.5)}.py-4{padding-block:calc(var(--spacing) * 4)}.py-8{padding-block:calc(var(--spacing) * 8)}.pt-1{padding-top:var(--spacing)}.pt-2{padding-top:calc(var(--spacing) * 2)}.pt-4{padding-top:calc(var(--spacing) * 4)}.pt-6{padding-top:calc(var(--spacing) * 6)}.pt-10{padding-top:calc(var(--spacing) * 10)}.pt-\[5px\]{padding-top:5px}.pr-1{padding-right:var(--spacing)}.pr-1\.5{padding-right:calc(var(--spacing) * 1.5)}.pr-4{padding-right:calc(var(--spacing) * 4)}.pb-2\.5{padding-bottom:calc(var(--spacing) * 2.5)}.pb-3{padding-bottom:calc(var(--spacing) * 3)}.pb-4{padding-bottom:calc(var(--spacing) * 4)}.pb-6{padding-bottom:calc(var(--spacing) * 6)}.pb-10{padding-bottom:calc(var(--spacing) * 10)}.pl-1\.5{padding-left:calc(var(--spacing) * 1.5)}.pl-2\.5{padding-left:calc(var(--spacing) * 2.5)}.pl-4{padding-left:calc(var(--spacing) * 4)}.pl-5{padding-left:calc(var(--spacing) * 5)}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.align-top{vertical-align:top}.font-mono{font-family:var(--font-geist-mono)}.text-2xl{font-size:var(--text-2xl);line-height:var(--tw-leading,var(--text-2xl--line-height))}.text-base{font-size:var(--text-base);line-height:var(--tw-leading,var(--text-base--line-height))}.text-lg{font-size:var(--text-lg);line-height:var(--tw-leading,var(--text-lg--line-height))}.text-sm{font-size:var(--text-sm);line-height:var(--tw-leading,var(--text-sm--line-height))}.text-xl{font-size:var(--text-xl);line-height:var(--tw-leading,var(--text-xl--line-height))}.text-xs{font-size:var(--text-xs);line-height:var(--tw-leading,var(--text-xs--line-height))}.text-\[9px\]{font-size:9px}.text-\[10px\]{font-size:10px}.text-\[11px\]{font-size:11px}.text-\[12px\]{font-size:12px}.text-\[13px\]{font-size:13px}.text-\[14px\]{font-size:14px}.text-\[15px\]{font-size:15px}.text-\[16px\]{font-size:16px}.leading-6{--tw-leading:calc(var(--spacing) * 6);line-height:calc(var(--spacing) * 6)}.leading-\[22px\]{--tw-leading:22px;line-height:22px}.leading-none{--tw-leading:1;line-height:1}.leading-relaxed{--tw-leading:var(--leading-relaxed);line-height:var(--leading-relaxed)}.leading-snug{--tw-leading:var(--leading-snug);line-height:var(--leading-snug)}.font-bold{--tw-font-weight:var(--font-weight-bold);font-weight:var(--font-weight-bold)}.font-medium{--tw-font-weight:var(--font-weight-medium);font-weight:var(--font-weight-medium)}.font-semibold{--tw-font-weight:var(--font-weight-semibold);font-weight:var(--font-weight-semibold)}.tracking-\[0\.4em\]{--tw-tracking:.4em;letter-spacing:.4em}.tracking-tight{--tw-tracking:var(--tracking-tight);letter-spacing:var(--tracking-tight)}.tracking-wide{--tw-tracking:var(--tracking-wide);letter-spacing:var(--tracking-wide)}.tracking-wider{--tw-tracking:var(--tracking-wider);letter-spacing:var(--tracking-wider)}.break-words{overflow-wrap:break-word}.break-all{word-break:break-all}.whitespace-nowrap{white-space:nowrap}.whitespace-pre{white-space:pre}.whitespace-pre-wrap{white-space:pre-wrap}.text-\[\#22c55e\]{color:#22c55e}.text-\[\#333\]{color:#333}.text-\[\#444\]{color:#444}.text-\[\#555\]{color:#555}.text-\[\#666\]{color:#666}.text-\[\#777\]{color:#777}.text-\[\#888\]{color:#888}.text-\[\#999\]{color:#999}.text-\[\#aaa\]{color:#aaa}.text-\[\#bbb\]{color:#bbb}.text-\[\#ddd\]{color:#ddd}.text-\[\#e5e5e5\]{color:#e5e5e5}.text-\[\#ededed\]{color:#ededed}.text-amber-400{color:var(--color-amber-400)}.text-amber-400\/80{color:#fcbb00cc}@supports (color:color-mix(in lab,red,red)){.text-amber-400\/80{color:color-mix(in oklab,var(--color-amber-400) 80%,transparent)}}.text-black{color:var(--color-black)}.text-blue-400{color:var(--color-blue-400)}.text-blue-400\/80{color:#54a2ffcc}@supports (color:color-mix(in lab,red,red)){.text-blue-400\/80{color:color-mix(in oklab,var(--color-blue-400) 80%,transparent)}}.text-blue-500{color:var(--color-blue-500)}.text-cyan-400{color:var(--color-cyan-400)}.text-cyan-400\/80{color:#00d2efcc}@supports (color:color-mix(in lab,red,red)){.text-cyan-400\/80{color:color-mix(in oklab,var(--color-cyan-400) 80%,transparent)}}.text-emerald-200{color:var(--color-emerald-200)}.text-emerald-400{color:var(--color-emerald-400)}.text-emerald-400\/30{color:#00d2944d}@supports (color:color-mix(in lab,red,red)){.text-emerald-400\/30{color:color-mix(in oklab,var(--color-emerald-400) 30%,transparent)}}.text-emerald-400\/60{color:#00d29499}@supports (color:color-mix(in lab,red,red)){.text-emerald-400\/60{color:color-mix(in oklab,var(--color-emerald-400) 60%,transparent)}}.text-emerald-400\/70{color:#00d294b3}@supports (color:color-mix(in lab,red,red)){.text-emerald-400\/70{color:color-mix(in oklab,var(--color-emerald-400) 70%,transparent)}}.text-emerald-400\/80{color:#00d294cc}@supports (color:color-mix(in lab,red,red)){.text-emerald-400\/80{color:color-mix(in oklab,var(--color-emerald-400) 80%,transparent)}}.text-gray-400{color:var(--color-gray-400)}.text-orange-400{color:var(--color-orange-400)}.text-orange-400\/60{color:#ff8b1a99}@supports (color:color-mix(in lab,red,red)){.text-orange-400\/60{color:color-mix(in oklab,var(--color-orange-400) 60%,transparent)}}.text-orange-400\/80{color:#ff8b1acc}@supports (color:color-mix(in lab,red,red)){.text-orange-400\/80{color:color-mix(in oklab,var(--color-orange-400) 80%,transparent)}}.text-orange-500{color:var(--color-orange-500)}.text-purple-400{color:var(--color-purple-400)}.text-purple-400\/60{color:#c07eff99}@supports (color:color-mix(in lab,red,red)){.text-purple-400\/60{color:color-mix(in oklab,var(--color-purple-400) 60%,transparent)}}.text-purple-400\/70{color:#c07effb3}@supports (color:color-mix(in lab,red,red)){.text-purple-400\/70{color:color-mix(in oklab,var(--color-purple-400) 70%,transparent)}}.text-purple-400\/80{color:#c07effcc}@supports (color:color-mix(in lab,red,red)){.text-purple-400\/80{color:color-mix(in oklab,var(--color-purple-400) 80%,transparent)}}.text-red-300{color:var(--color-red-300)}.text-red-400{color:var(--color-red-400)}.text-red-400\/30{color:#ff65684d}@supports (color:color-mix(in lab,red,red)){.text-red-400\/30{color:color-mix(in oklab,var(--color-red-400) 30%,transparent)}}.text-red-400\/50{color:#ff656880}@supports (color:color-mix(in lab,red,red)){.text-red-400\/50{color:color-mix(in oklab,var(--color-red-400) 50%,transparent)}}.text-red-400\/60{color:#ff656899}@supports (color:color-mix(in lab,red,red)){.text-red-400\/60{color:color-mix(in oklab,var(--color-red-400) 60%,transparent)}}.text-red-400\/70{color:#ff6568b3}@supports (color:color-mix(in lab,red,red)){.text-red-400\/70{color:color-mix(in oklab,var(--color-red-400) 70%,transparent)}}.text-red-400\/80{color:#ff6568cc}@supports (color:color-mix(in lab,red,red)){.text-red-400\/80{color:color-mix(in oklab,var(--color-red-400) 80%,transparent)}}.text-red-500{color:var(--color-red-500)}.text-sky-400{color:var(--color-sky-400)}.text-sky-400\/80{color:#00bcfecc}@supports (color:color-mix(in lab,red,red)){.text-sky-400\/80{color:color-mix(in oklab,var(--color-sky-400) 80%,transparent)}}.text-white{color:var(--color-white)}.text-white\/80{color:#fffc}@supports (color:color-mix(in lab,red,red)){.text-white\/80{color:color-mix(in oklab,var(--color-white) 80%,transparent)}}.text-yellow-400{color:var(--color-yellow-400)}.text-yellow-400\/80{color:#fac800cc}@supports (color:color-mix(in lab,red,red)){.text-yellow-400\/80{color:color-mix(in oklab,var(--color-yellow-400) 80%,transparent)}}.text-yellow-500{color:var(--color-yellow-500)}.capitalize{text-transform:capitalize}.uppercase{text-transform:uppercase}.italic{font-style:italic}.tabular-nums{--tw-numeric-spacing:tabular-nums;font-variant-numeric:var(--tw-ordinal,) var(--tw-slashed-zero,) var(--tw-numeric-figure,) var(--tw-numeric-spacing,) var(--tw-numeric-fraction,)}.line-through{text-decoration-line:line-through}.opacity-0{opacity:0}.opacity-70{opacity:.7}.opacity-75{opacity:.75}.opacity-90{opacity:.9}.opacity-100{opacity:1}.\!shadow-none{--tw-shadow:0 0 #0000!important;box-shadow:var(--tw-inset-shadow),var(--tw-inset-ring-shadow),var(--tw-ring-offset-shadow),var(--tw-ring-shadow),var(--tw-shadow)!important}.shadow-2xl{--tw-shadow:0 25px 50px -12px var(--tw-shadow-color,#00000040);box-shadow:var(--tw-inset-shadow),var(--tw-inset-ring-shadow),var(--tw-ring-offset-shadow),var(--tw-ring-shadow),var(--tw-shadow)}.shadow-lg{--tw-shadow:0 10px 15px -3px var(--tw-shadow-color,#0000001a), 0 4px 6px -4px var(--tw-shadow-color,#0000001a);box-shadow:var(--tw-inset-shadow),var(--tw-inset-ring-shadow),var(--tw-ring-offset-shadow),var(--tw-ring-shadow),var(--tw-shadow)}.shadow-xl{--tw-shadow:0 20px 25px -5px var(--tw-shadow-color,#0000001a), 0 8px 10px -6px var(--tw-shadow-color,#0000001a);box-shadow:var(--tw-inset-shadow),var(--tw-inset-ring-shadow),var(--tw-ring-offset-shadow),var(--tw-ring-shadow),var(--tw-shadow)}.filter{filter:var(--tw-blur,) var(--tw-brightness,) var(--tw-contrast,) var(--tw-grayscale,) var(--tw-hue-rotate,) var(--tw-invert,) var(--tw-saturate,) var(--tw-sepia,) var(--tw-drop-shadow,)}.transition{transition-property:color,background-color,border-color,outline-color,text-decoration-color,fill,stroke,--tw-gradient-from,--tw-gradient-via,--tw-gradient-to,opacity,box-shadow,transform,translate,scale,rotate,filter,-webkit-backdrop-filter,backdrop-filter,display,content-visibility,overlay,pointer-events;transition-timing-function:var(--tw-ease,var(--default-transition-timing-function));transition-duration:var(--tw-duration,var(--default-transition-duration))}.transition-\[width\]{transition-property:width;transition-timing-function:var(--tw-ease,var(--default-transition-timing-function));transition-duration:var(--tw-duration,var(--default-transition-duration))}.transition-all{transition-property:all;transition-timing-function:var(--tw-ease,var(--default-transition-timing-function));transition-duration:var(--tw-duration,var(--default-transition-duration))}.transition-colors{transition-property:color,background-color,border-color,outline-color,text-decoration-color,fill,stroke,--tw-gradient-from,--tw-gradient-via,--tw-gradient-to;transition-timing-function:var(--tw-ease,var(--default-transition-timing-function));transition-duration:var(--tw-duration,var(--default-transition-duration))}.transition-opacity{transition-property:opacity;transition-timing-function:var(--tw-ease,var(--default-transition-timing-function));transition-duration:var(--tw-duration,var(--default-transition-duration))}.transition-transform{transition-property:transform,translate,scale,rotate;transition-timing-function:var(--tw-ease,var(--default-transition-timing-function));transition-duration:var(--tw-duration,var(--default-transition-duration))}.duration-100{--tw-duration:.1s;transition-duration:.1s}.duration-200{--tw-duration:.2s;transition-duration:.2s}.duration-300{--tw-duration:.3s;transition-duration:.3s}.duration-500{--tw-duration:.5s;transition-duration:.5s}.ease-out{--tw-ease:var(--ease-out);transition-timing-function:var(--ease-out)}.outline-none{--tw-outline-style:none;outline-style:none}.select-none{-webkit-user-select:none;user-select:none}.\[font-variant-ligatures\:none\]{font-variant-ligatures:none}@media(hover:hover){.group-hover\:bg-\[rgba\(255\,255\,255\,0\.2\)\]:is(:where(.group):hover *){background-color:#fff3}.group-hover\:text-\[\#aaa\]:is(:where(.group):hover *){color:#aaa}.group-hover\:text-white:is(:where(.group):hover *){color:var(--color-white)}.group-hover\:opacity-90:is(:where(.group):hover *){opacity:.9}.group-hover\/code\:opacity-100:is(:where(.group\/code):hover *){opacity:1}}.placeholder\:text-\[\#444\]::placeholder{color:#444}@media(hover:hover){.hover\:border-\[\#333\]:hover{border-color:#333}.hover\:border-\[\#444\]:hover{border-color:#444}.hover\:border-\[\#555\]:hover{border-color:#555}.hover\:border-emerald-500\/40:hover{border-color:#00bb7f66}@supports (color:color-mix(in lab,red,red)){.hover\:border-emerald-500\/40:hover{border-color:color-mix(in oklab,var(--color-emerald-500) 40%,transparent)}}.hover\:border-white\/\[0\.12\]:hover{border-color:#ffffff1f}@supports (color:color-mix(in lab,red,red)){.hover\:border-white\/\[0\.12\]:hover{border-color:color-mix(in oklab,var(--color-white) 12%,transparent)}}.hover\:border-white\/\[0\.16\]:hover{border-color:#ffffff29}@supports (color:color-mix(in lab,red,red)){.hover\:border-white\/\[0\.16\]:hover{border-color:color-mix(in oklab,var(--color-white) 16%,transparent)}}.hover\:bg-\[\#1a1a1a\]:hover{background-color:#1a1a1a}.hover\:bg-\[\#2a2a2a\]:hover{background-color:#2a2a2a}.hover\:bg-\[rgba\(255\,255\,255\,0\.06\)\]:hover{background-color:#ffffff0f}.hover\:bg-\[rgba\(255\,255\,255\,0\.08\)\]:hover{background-color:#ffffff14}.hover\:bg-\[rgba\(255\,255\,255\,0\.09\)\]:hover{background-color:#ffffff17}.hover\:bg-neutral-200:hover{background-color:var(--color-neutral-200)}.hover\:bg-white\/\[0\.06\]:hover{background-color:#ffffff0f}@supports (color:color-mix(in lab,red,red)){.hover\:bg-white\/\[0\.06\]:hover{background-color:color-mix(in oklab,var(--color-white) 6%,transparent)}}.hover\:text-\[\#888\]:hover{color:#888}.hover\:text-\[\#aaa\]:hover{color:#aaa}.hover\:text-\[\#ccc\]:hover{color:#ccc}.hover\:text-\[\#ededed\]:hover{color:#ededed}.hover\:text-red-400:hover{color:var(--color-red-400)}.hover\:text-white:hover{color:var(--color-white)}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-90:hover{opacity:.9}.hover\:opacity-100:hover{opacity:1}}.focus\:border-\[\#444\]:focus{border-color:#444}.focus\:border-white\/50:focus{border-color:#ffffff80}@supports (color:color-mix(in lab,red,red)){.focus\:border-white\/50:focus{border-color:color-mix(in oklab,var(--color-white) 50%,transparent)}}.focus\:ring-2:focus{--tw-ring-shadow:var(--tw-ring-inset,) 0 0 0 calc(2px + var(--tw-ring-offset-width)) var(--tw-ring-color,currentcolor);box-shadow:var(--tw-inset-shadow),var(--tw-inset-ring-shadow),var(--tw-ring-offset-shadow),var(--tw-ring-shadow),var(--tw-shadow)}.focus\:ring-white\/10:focus{--tw-ring-color:#ffffff1a}@supports (color:color-mix(in lab,red,red)){.focus\:ring-white\/10:focus{--tw-ring-color:color-mix(in oklab, var(--color-white) 10%, transparent)}}.focus\:outline-none:focus{--tw-outline-style:none;outline-style:none}.focus-visible\:ring-2:focus-visible{--tw-ring-shadow:var(--tw-ring-inset,) 0 0 0 calc(2px + var(--tw-ring-offset-width)) var(--tw-ring-color,currentcolor);box-shadow:var(--tw-inset-shadow),var(--tw-inset-ring-shadow),var(--tw-ring-offset-shadow),var(--tw-ring-shadow),var(--tw-shadow)}.focus-visible\:ring-white\/20:focus-visible{--tw-ring-color:#fff3}@supports (color:color-mix(in lab,red,red)){.focus-visible\:ring-white\/20:focus-visible{--tw-ring-color:color-mix(in oklab, var(--color-white) 20%, transparent)}}.focus-visible\:outline-none:focus-visible{--tw-outline-style:none;outline-style:none}.disabled\:opacity-60:disabled{opacity:.6}@media(min-width:40rem){.sm\:rounded-lg{border-radius:var(--radius-lg)}.sm\:p-8{padding:calc(var(--spacing) * 8)}.sm\:px-6{padding-inline:calc(var(--spacing) * 6)}.sm\:py-12{padding-block:calc(var(--spacing) * 12)}}@media(min-width:48rem){.md\:grid-cols-2{grid-template-columns:repeat(2,minmax(0,1fr))}}@media(min-width:64rem){.lg\:sticky{position:sticky}.lg\:top-6{top:calc(var(--spacing) * 6)}.lg\:block{display:block}.lg\:flex{display:flex}.lg\:hidden{display:none}.lg\:max-h-\[calc\(100vh-3rem\)\]{max-height:calc(100vh - 3rem)}.lg\:grid-cols-\[1fr_340px\]{grid-template-columns:1fr 340px}.lg\:overflow-y-auto{overflow-y:auto}.lg\:border-l{border-left-style:var(--tw-border-style);border-left-width:1px}.lg\:border-\[\#2a2a2a\]{border-color:#2a2a2a}.lg\:pl-6{padding-left:calc(var(--spacing) * 6)}}.\[\&_svg\]\:h-3\.5 svg{height:calc(var(--spacing) * 3.5)}.\[\&_svg\]\:w-3\.5 svg{width:calc(var(--spacing) * 3.5)}}:root{--font-geist-sans:ui-sans-serif, system-ui, -apple-system, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;--font-geist-mono:ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace}html,body{color:#fff;font-family:var(--font-geist-sans);background:#000}.scrollbar-thin{scrollbar-width:thin;scrollbar-color:#ffffff26 transparent}.scrollbar-thin::-webkit-scrollbar{width:6px;height:6px}.scrollbar-thin::-webkit-scrollbar-thumb{background:#ffffff26;border-radius:3px}.scrollbar-thin::-webkit-scrollbar-track{background:0 0}@keyframes page-in{0%{opacity:0;filter:blur(8px);transform:translateY(8px)}to{opacity:1;filter:blur();transform:translateY(0)}}.animate-page-in{animation:.15s ease-out page-in}@keyframes fade-in{0%{opacity:0}to{opacity:1}}.animate-fade-in{animation:.35s ease-out fade-in}@keyframes cardIn{0%{opacity:0;filter:blur(4px);transform:translateY(8px)scale(.97)}to{opacity:1;filter:blur();transform:translateY(0)scale(1)}}.animate-card-in{opacity:0;animation:.3s cubic-bezier(.16,1,.3,1) forwards cardIn}.animate-card-in:first-child{animation-delay:0s}.animate-card-in:nth-child(2){animation-delay:50ms}.animate-card-in:nth-child(3){animation-delay:.1s}.animate-card-in:nth-child(4){animation-delay:.15s}@keyframes shimmer{0%{transform:translate(-100%)}to{transform:translate(400%)}}.animate-shimmer{animation:2s infinite shimmer}@keyframes dialog-overlay-in{0%{opacity:0}to{opacity:1}}@keyframes dialog-overlay-out{0%{opacity:1}to{opacity:0}}@keyframes dialog-panel-in{0%{opacity:0;transform:scale(.95)}to{opacity:1;transform:scale(1)}}@keyframes dialog-panel-out{0%{opacity:1;transform:scale(1)}to{opacity:0;transform:scale(.95)}}.dialog-overlay[data-state=open]{animation:.2s dialog-overlay-in}.dialog-overlay[data-state=closed]{animation:.2s forwards dialog-overlay-out}.dialog-panel[data-state=open]{animation:.2s dialog-panel-in}.dialog-panel[data-state=closed]{animation:.2s forwards dialog-panel-out}.agent-modal[data-state=open]{animation:.14s dialog-overlay-in}.agent-modal[data-state=closed]{animation:.14s forwards dialog-overlay-out}@keyframes tab-in{0%{opacity:0;filter:blur(4px);transform:translateY(6px)}to{opacity:1;filter:blur();transform:translateY(0)}}.animate-tab-in{animation:.2s ease-out tab-in}.prose-markdown{color:#999;word-wrap:break-word;overflow-wrap:break-word;font-size:14px;line-height:1.7}.prose-markdown p{margin-bottom:.75em}.prose-markdown p:last-child{margin-bottom:0}.prose-markdown strong{color:#ccc;font-weight:600}.prose-markdown em{font-style:italic}.prose-markdown code{color:#ccc;font-variant-ligatures:none;background:#0a0a0a;border:1px solid #111;border-radius:4px;padding:.15em .4em;font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;font-size:.9em}.prose-markdown pre{font-variant-ligatures:none;background:0 0;border:none;border-radius:0;margin:0;padding:0}.prose-markdown pre code{color:inherit;background:0 0;border:none;padding:0;font-size:13px}.prose-markdown ul,.prose-markdown ol{margin-bottom:.75em;padding-left:1.5em}.prose-markdown ul{list-style-type:disc}.prose-markdown ol{list-style-type:decimal}.prose-markdown li{margin-bottom:.25em}.prose-markdown li>ul,.prose-markdown li>ol{margin-top:.25em;margin-bottom:.25em;padding-left:1.5em}.prose-markdown ol+ul{margin-top:-.5em;padding-left:3em}.prose-markdown h1,.prose-markdown h2,.prose-markdown h3,.prose-markdown h4,.prose-markdown h5,.prose-markdown h6{color:#ddd;margin-top:1em;margin-bottom:.5em;font-weight:600}.prose-markdown a{color:inherit;pointer-events:none;text-decoration:none}.prose-markdown blockquote{color:#777;border-left:3px solid #333;margin:.75em 0;padding-left:1em}.prose-markdown hr{border:none;border-top:1px solid #222;margin:1em 0}.prose-markdown>table{border-collapse:collapse;width:100%;margin:.75em 0}.prose-markdown>table th,.prose-markdown>table td{text-align:left;border:1px solid #333;padding:.4em .75em;font-size:13px}.prose-markdown>table th{color:#ccc;background:#1a1a1a;font-weight:600}@property --tw-translate-x{syntax:"*";inherits:false;initial-value:0}@property --tw-translate-y{syntax:"*";inherits:false;initial-value:0}@property --tw-translate-z{syntax:"*";inherits:false;initial-value:0}@property --tw-space-y-reverse{syntax:"*";inherits:false;initial-value:0}@property --tw-border-style{syntax:"*";inherits:false;initial-value:solid}@property --tw-gradient-position{syntax:"*";inherits:false}@property --tw-gradient-from{syntax:"";inherits:false;initial-value:#0000}@property --tw-gradient-via{syntax:"";inherits:false;initial-value:#0000}@property --tw-gradient-to{syntax:"";inherits:false;initial-value:#0000}@property --tw-gradient-stops{syntax:"*";inherits:false}@property --tw-gradient-via-stops{syntax:"*";inherits:false}@property --tw-gradient-from-position{syntax:"";inherits:false;initial-value:0%}@property --tw-gradient-via-position{syntax:"";inherits:false;initial-value:50%}@property --tw-gradient-to-position{syntax:"";inherits:false;initial-value:100%}@property --tw-leading{syntax:"*";inherits:false}@property --tw-font-weight{syntax:"*";inherits:false}@property --tw-tracking{syntax:"*";inherits:false}@property --tw-ordinal{syntax:"*";inherits:false}@property --tw-slashed-zero{syntax:"*";inherits:false}@property --tw-numeric-figure{syntax:"*";inherits:false}@property --tw-numeric-spacing{syntax:"*";inherits:false}@property --tw-numeric-fraction{syntax:"*";inherits:false}@property --tw-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-shadow-color{syntax:"*";inherits:false}@property --tw-shadow-alpha{syntax:"";inherits:false;initial-value:100%}@property --tw-inset-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-inset-shadow-color{syntax:"*";inherits:false}@property --tw-inset-shadow-alpha{syntax:"";inherits:false;initial-value:100%}@property --tw-ring-color{syntax:"*";inherits:false}@property --tw-ring-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-inset-ring-color{syntax:"*";inherits:false}@property --tw-inset-ring-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-ring-inset{syntax:"*";inherits:false}@property --tw-ring-offset-width{syntax:"";inherits:false;initial-value:0}@property --tw-ring-offset-color{syntax:"*";inherits:false;initial-value:#fff}@property --tw-ring-offset-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-blur{syntax:"*";inherits:false}@property --tw-brightness{syntax:"*";inherits:false}@property --tw-contrast{syntax:"*";inherits:false}@property --tw-grayscale{syntax:"*";inherits:false}@property --tw-hue-rotate{syntax:"*";inherits:false}@property --tw-invert{syntax:"*";inherits:false}@property --tw-opacity{syntax:"*";inherits:false}@property --tw-saturate{syntax:"*";inherits:false}@property --tw-sepia{syntax:"*";inherits:false}@property --tw-drop-shadow{syntax:"*";inherits:false}@property --tw-drop-shadow-color{syntax:"*";inherits:false}@property --tw-drop-shadow-alpha{syntax:"";inherits:false;initial-value:100%}@property --tw-drop-shadow-size{syntax:"*";inherits:false}@property --tw-duration{syntax:"*";inherits:false}@property --tw-ease{syntax:"*";inherits:false}@keyframes spin{to{transform:rotate(360deg)}}@keyframes ping{75%,to{opacity:0;transform:scale(2)}}@keyframes pulse{50%{opacity:.5}} diff --git a/strix/interface/viewer/static/assets/index-CbkcEEWn.js b/strix/interface/viewer/static/assets/index-DBJ-RJqo.js similarity index 76% rename from strix/interface/viewer/static/assets/index-CbkcEEWn.js rename to strix/interface/viewer/static/assets/index-DBJ-RJqo.js index 303d91b6..ecdc0fcf 100644 --- a/strix/interface/viewer/static/assets/index-CbkcEEWn.js +++ b/strix/interface/viewer/static/assets/index-DBJ-RJqo.js @@ -6,7 +6,7 @@ * * This source code is licensed under the MIT license found in the * LICENSE file in the root directory of this source tree. - */var G0;function yk(){if(G0)return Yl;G0=1;var e=Symbol.for("react.transitional.element"),t=Symbol.for("react.fragment");function r(a,s,o){var c=null;if(o!==void 0&&(c=""+o),s.key!==void 0&&(c=""+s.key),"key"in s){o={};for(var d in s)d!=="key"&&(o[d]=s[d])}else o=s;return s=o.ref,{$$typeof:e,type:a,key:c,ref:s!==void 0?s:null,props:o}}return Yl.Fragment=t,Yl.jsx=r,Yl.jsxs=r,Yl}var V0;function vk(){return V0||(V0=1,oh.exports=yk()),oh.exports}var g=vk(),ch={exports:{}},Ve={};/** + */var V0;function yk(){if(V0)return Yl;V0=1;var e=Symbol.for("react.transitional.element"),t=Symbol.for("react.fragment");function r(a,s,o){var c=null;if(o!==void 0&&(c=""+o),s.key!==void 0&&(c=""+s.key),"key"in s){o={};for(var d in s)d!=="key"&&(o[d]=s[d])}else o=s;return s=o.ref,{$$typeof:e,type:a,key:c,ref:s!==void 0?s:null,props:o}}return Yl.Fragment=t,Yl.jsx=r,Yl.jsxs=r,Yl}var Y0;function vk(){return Y0||(Y0=1,oh.exports=yk()),oh.exports}var g=vk(),ch={exports:{}},Ve={};/** * @license React * react.production.js * @@ -14,7 +14,7 @@ * * This source code is licensed under the MIT license found in the * LICENSE file in the root directory of this source tree. - */var Y0;function _k(){if(Y0)return Ve;Y0=1;var e=Symbol.for("react.transitional.element"),t=Symbol.for("react.portal"),r=Symbol.for("react.fragment"),a=Symbol.for("react.strict_mode"),s=Symbol.for("react.profiler"),o=Symbol.for("react.consumer"),c=Symbol.for("react.context"),d=Symbol.for("react.forward_ref"),h=Symbol.for("react.suspense"),f=Symbol.for("react.memo"),m=Symbol.for("react.lazy"),p=Symbol.for("react.activity"),y=Symbol.iterator;function x(D){return D===null||typeof D!="object"?null:(D=y&&D[y]||D["@@iterator"],typeof D=="function"?D:null)}var _={isMounted:function(){return!1},enqueueForceUpdate:function(){},enqueueReplaceState:function(){},enqueueSetState:function(){}},N=Object.assign,S={};function w(D,Y,L){this.props=D,this.context=Y,this.refs=S,this.updater=L||_}w.prototype.isReactComponent={},w.prototype.setState=function(D,Y){if(typeof D!="object"&&typeof D!="function"&&D!=null)throw Error("takes an object of state variables to update or a function which returns an object of state variables.");this.updater.enqueueSetState(this,D,Y,"setState")},w.prototype.forceUpdate=function(D){this.updater.enqueueForceUpdate(this,D,"forceUpdate")};function k(){}k.prototype=w.prototype;function E(D,Y,L){this.props=D,this.context=Y,this.refs=S,this.updater=L||_}var M=E.prototype=new k;M.constructor=E,N(M,w.prototype),M.isPureReactComponent=!0;var I=Array.isArray;function R(){}var $={H:null,A:null,T:null,S:null},B=Object.prototype.hasOwnProperty;function Z(D,Y,L){var F=L.ref;return{$$typeof:e,type:D,key:Y,ref:F!==void 0?F:null,props:L}}function j(D,Y){return Z(D.type,Y,D.props)}function z(D){return typeof D=="object"&&D!==null&&D.$$typeof===e}function G(D){var Y={"=":"=0",":":"=2"};return"$"+D.replace(/[=:]/g,function(L){return Y[L]})}var V=/\/+/g;function T(D,Y){return typeof D=="object"&&D!==null&&D.key!=null?G(""+D.key):Y.toString(36)}function U(D){switch(D.status){case"fulfilled":return D.value;case"rejected":throw D.reason;default:switch(typeof D.status=="string"?D.then(R,R):(D.status="pending",D.then(function(Y){D.status==="pending"&&(D.status="fulfilled",D.value=Y)},function(Y){D.status==="pending"&&(D.status="rejected",D.reason=Y)})),D.status){case"fulfilled":return D.value;case"rejected":throw D.reason}}throw D}function O(D,Y,L,F,q){var Q=typeof D;(Q==="undefined"||Q==="boolean")&&(D=null);var J=!1;if(D===null)J=!0;else switch(Q){case"bigint":case"string":case"number":J=!0;break;case"object":switch(D.$$typeof){case e:case t:J=!0;break;case m:return J=D._init,O(J(D._payload),Y,L,F,q)}}if(J)return q=q(D),J=F===""?"."+T(D,0):F,I(q)?(L="",J!=null&&(L=J.replace(V,"$&/")+"/"),O(q,Y,L,"",function(ce){return ce})):q!=null&&(z(q)&&(q=j(q,L+(q.key==null||D&&D.key===q.key?"":(""+q.key).replace(V,"$&/")+"/")+J)),Y.push(q)),1;J=0;var W=F===""?".":F+":";if(I(D))for(var te=0;te>>1,C=O[K];if(0>>1;Ks(L,X))Fs(q,L)?(O[K]=q,O[F]=X,K=F):(O[K]=L,O[Y]=X,K=Y);else if(Fs(q,X))O[K]=q,O[F]=X,K=F;else break e}}return H}function s(O,H){var X=O.sortIndex-H.sortIndex;return X!==0?X:O.id-H.id}if(e.unstable_now=void 0,typeof performance=="object"&&typeof performance.now=="function"){var o=performance;e.unstable_now=function(){return o.now()}}else{var c=Date,d=c.now();e.unstable_now=function(){return c.now()-d}}var h=[],f=[],m=1,p=null,y=3,x=!1,_=!1,N=!1,S=!1,w=typeof setTimeout=="function"?setTimeout:null,k=typeof clearTimeout=="function"?clearTimeout:null,E=typeof setImmediate<"u"?setImmediate:null;function M(O){for(var H=r(f);H!==null;){if(H.callback===null)a(f);else if(H.startTime<=O)a(f),H.sortIndex=H.expirationTime,t(h,H);else break;H=r(f)}}function I(O){if(N=!1,M(O),!_)if(r(h)!==null)_=!0,R||(R=!0,G());else{var H=r(f);H!==null&&U(I,H.startTime-O)}}var R=!1,$=-1,B=5,Z=-1;function j(){return S?!0:!(e.unstable_now()-ZO&&j());){var K=p.callback;if(typeof K=="function"){p.callback=null,y=p.priorityLevel;var C=K(p.expirationTime<=O);if(O=e.unstable_now(),typeof C=="function"){p.callback=C,M(O),H=!0;break t}p===r(h)&&a(h),M(O)}else a(h);p=r(h)}if(p!==null)H=!0;else{var D=r(f);D!==null&&U(I,D.startTime-O),H=!1}}break e}finally{p=null,y=X,x=!1}H=void 0}}finally{H?G():R=!1}}}var G;if(typeof E=="function")G=function(){E(z)};else if(typeof MessageChannel<"u"){var V=new MessageChannel,T=V.port2;V.port1.onmessage=z,G=function(){T.postMessage(null)}}else G=function(){w(z,0)};function U(O,H){$=w(function(){O(e.unstable_now())},H)}e.unstable_IdlePriority=5,e.unstable_ImmediatePriority=1,e.unstable_LowPriority=4,e.unstable_NormalPriority=3,e.unstable_Profiling=null,e.unstable_UserBlockingPriority=2,e.unstable_cancelCallback=function(O){O.callback=null},e.unstable_forceFrameRate=function(O){0>O||125K?(O.sortIndex=X,t(f,O),r(h)===null&&O===r(f)&&(N?(k($),$=-1):N=!0,U(I,X-K))):(O.sortIndex=C,t(h,O),_||x||(_=!0,R||(R=!0,G()))),O},e.unstable_shouldYield=j,e.unstable_wrapCallback=function(O){var H=y;return function(){var X=y;y=H;try{return O.apply(this,arguments)}finally{y=X}}}})(fh)),fh}var Z0;function Ek(){return Z0||(Z0=1,dh.exports=wk()),dh.exports}var hh={exports:{}},Cn={};/** + */var Z0;function wk(){return Z0||(Z0=1,(function(e){function t(O,H){var X=O.length;O.push(H);e:for(;0>>1,C=O[K];if(0>>1;Ks(L,X))Gs(q,L)?(O[K]=q,O[G]=X,K=G):(O[K]=L,O[Y]=X,K=Y);else if(Gs(q,X))O[K]=q,O[G]=X,K=G;else break e}}return H}function s(O,H){var X=O.sortIndex-H.sortIndex;return X!==0?X:O.id-H.id}if(e.unstable_now=void 0,typeof performance=="object"&&typeof performance.now=="function"){var o=performance;e.unstable_now=function(){return o.now()}}else{var c=Date,d=c.now();e.unstable_now=function(){return c.now()-d}}var h=[],f=[],m=1,p=null,y=3,x=!1,_=!1,N=!1,S=!1,w=typeof setTimeout=="function"?setTimeout:null,k=typeof clearTimeout=="function"?clearTimeout:null,E=typeof setImmediate<"u"?setImmediate:null;function M(O){for(var H=r(f);H!==null;){if(H.callback===null)a(f);else if(H.startTime<=O)a(f),H.sortIndex=H.expirationTime,t(h,H);else break;H=r(f)}}function I(O){if(N=!1,M(O),!_)if(r(h)!==null)_=!0,R||(R=!0,V());else{var H=r(f);H!==null&&$(I,H.startTime-O)}}var R=!1,U=-1,B=5,Z=-1;function j(){return S?!0:!(e.unstable_now()-ZO&&j());){var K=p.callback;if(typeof K=="function"){p.callback=null,y=p.priorityLevel;var C=K(p.expirationTime<=O);if(O=e.unstable_now(),typeof C=="function"){p.callback=C,M(O),H=!0;break t}p===r(h)&&a(h),M(O)}else a(h);p=r(h)}if(p!==null)H=!0;else{var D=r(f);D!==null&&$(I,D.startTime-O),H=!1}}break e}finally{p=null,y=X,x=!1}H=void 0}}finally{H?V():R=!1}}}var V;if(typeof E=="function")V=function(){E(z)};else if(typeof MessageChannel<"u"){var P=new MessageChannel,T=P.port2;P.port1.onmessage=z,V=function(){T.postMessage(null)}}else V=function(){w(z,0)};function $(O,H){U=w(function(){O(e.unstable_now())},H)}e.unstable_IdlePriority=5,e.unstable_ImmediatePriority=1,e.unstable_LowPriority=4,e.unstable_NormalPriority=3,e.unstable_Profiling=null,e.unstable_UserBlockingPriority=2,e.unstable_cancelCallback=function(O){O.callback=null},e.unstable_forceFrameRate=function(O){0>O||125K?(O.sortIndex=X,t(f,O),r(h)===null&&O===r(f)&&(N?(k(U),U=-1):N=!0,$(I,X-K))):(O.sortIndex=C,t(h,O),_||x||(_=!0,R||(R=!0,V()))),O},e.unstable_shouldYield=j,e.unstable_wrapCallback=function(O){var H=y;return function(){var X=y;y=H;try{return O.apply(this,arguments)}finally{y=X}}}})(fh)),fh}var Q0;function Ek(){return Q0||(Q0=1,dh.exports=wk()),dh.exports}var hh={exports:{}},Cn={};/** * @license React * react-dom.production.js * @@ -30,7 +30,7 @@ * * This source code is licensed under the MIT license found in the * LICENSE file in the root directory of this source tree. - */var Q0;function Nk(){if(Q0)return Cn;Q0=1;var e=To();function t(h){var f="https://react.dev/errors/"+h;if(1"u"||typeof __REACT_DEVTOOLS_GLOBAL_HOOK__.checkDCE!="function"))try{__REACT_DEVTOOLS_GLOBAL_HOOK__.checkDCE(e)}catch(t){console.error(t)}}return e(),hh.exports=Nk(),hh.exports}/** + */var W0;function Nk(){if(W0)return Cn;W0=1;var e=To();function t(h){var f="https://react.dev/errors/"+h;if(1"u"||typeof __REACT_DEVTOOLS_GLOBAL_HOOK__.checkDCE!="function"))try{__REACT_DEVTOOLS_GLOBAL_HOOK__.checkDCE(e)}catch(t){console.error(t)}}return e(),hh.exports=Nk(),hh.exports}/** * @license React * react-dom-client.production.js * @@ -38,15 +38,15 @@ * * This source code is licensed under the MIT license found in the * LICENSE file in the root directory of this source tree. - */var J0;function Sk(){if(J0)return Xl;J0=1;var e=Ek(),t=To(),r=k_();function a(n){var i="https://react.dev/errors/"+n;if(1C||(n.current=K[C],K[C]=null,C--)}function L(n,i){C++,K[C]=n.current,n.current=i}var F=D(null),q=D(null),Q=D(null),J=D(null);function W(n,i){switch(L(Q,i),L(q,n),L(F,null),i.nodeType){case 9:case 11:n=(n=i.documentElement)&&(n=n.namespaceURI)?m0(n):0;break;default:if(n=i.tagName,i=i.namespaceURI)i=m0(i),n=p0(i,n);else switch(n){case"svg":n=1;break;case"math":n=2;break;default:n=0}}Y(F),L(F,n)}function te(){Y(F),Y(q),Y(Q)}function ce(n){n.memoizedState!==null&&L(J,n);var i=F.current,l=p0(i,n.type);i!==l&&(L(q,n),L(F,l))}function fe(n){q.current===n&&(Y(F),Y(q)),J.current===n&&(Y(J),Pl._currentValue=X)}var be,we;function Ne(n){if(be===void 0)try{throw Error()}catch(l){var i=l.stack.trim().match(/\n( *(at )?)/);be=i&&i[1]||"",we=-1C||(n.current=K[C],K[C]=null,C--)}function L(n,i){C++,K[C]=n.current,n.current=i}var G=D(null),q=D(null),Q=D(null),J=D(null);function W(n,i){switch(L(Q,i),L(q,n),L(G,null),i.nodeType){case 9:case 11:n=(n=i.documentElement)&&(n=n.namespaceURI)?p0(n):0;break;default:if(n=i.tagName,i=i.namespaceURI)i=p0(i),n=g0(i,n);else switch(n){case"svg":n=1;break;case"math":n=2;break;default:n=0}}Y(G),L(G,n)}function te(){Y(G),Y(q),Y(Q)}function ce(n){n.memoizedState!==null&&L(J,n);var i=G.current,l=g0(i,n.type);i!==l&&(L(q,n),L(G,l))}function fe(n){q.current===n&&(Y(G),Y(q)),J.current===n&&(Y(J),Pl._currentValue=X)}var be,we;function Ne(n){if(be===void 0)try{throw Error()}catch(l){var i=l.stack.trim().match(/\n( *(at )?)/);be=i&&i[1]||"",we=-1)":-1b||ne[u]!==le[b]){var he=` `+ne[u].replace(" at new "," at ");return n.displayName&&he.includes("")&&(he=he.replace("",n.displayName)),he}while(1<=u&&0<=b);break}}}finally{De=!1,Error.prepareStackTrace=l}return(l=n?n.displayName||n.name:"")?Ne(l):""}function st(n,i){switch(n.tag){case 26:case 27:case 5:return Ne(n.type);case 16:return Ne("Lazy");case 13:return n.child!==i&&i!==null?Ne("Suspense Fallback"):Ne("Suspense");case 19:return Ne("SuspenseList");case 0:case 15:return $e(n.type,!1);case 11:return $e(n.type.render,!1);case 1:return $e(n.type,!0);case 31:return Ne("Activity");default:return""}}function Rt(n){try{var i="",l=null;do i+=st(n,l),l=n,n=n.return;while(n);return i}catch(u){return` Error generating stack: `+u.message+` -`+u.stack}}var Yt=Object.prototype.hasOwnProperty,Pt=e.unstable_scheduleCallback,Xt=e.unstable_cancelCallback,Xn=e.unstable_shouldYield,En=e.unstable_requestPaint,ct=e.unstable_now,It=e.unstable_getCurrentPriorityLevel,ue=e.unstable_ImmediatePriority,xe=e.unstable_UserBlockingPriority,Oe=e.unstable_NormalPriority,Fe=e.unstable_LowPriority,Ze=e.unstable_IdlePriority,on=e.log,Nn=e.unstable_setDisableYieldValue,Kt=null,At=null;function Wt(n){if(typeof on=="function"&&Nn(n),At&&typeof At.setStrictMode=="function")try{At.setStrictMode(Kt,n)}catch{}}var ut=Math.clz32?Math.clz32:Ni,In=Math.log,cn=Math.LN2;function Ni(n){return n>>>=0,n===0?32:31-(In(n)/cn|0)|0}var nt=256,Kn=262144,On=4194304;function hn(n){var i=n&42;if(i!==0)return i;switch(n&-n){case 1:return 1;case 2:return 2;case 4:return 4;case 8:return 8;case 16:return 16;case 32:return 32;case 64:return 64;case 128:return 128;case 256:case 512:case 1024:case 2048:case 4096:case 8192:case 16384:case 32768:case 65536:case 131072:return n&261888;case 262144:case 524288:case 1048576:case 2097152:return n&3932160;case 4194304:case 8388608:case 16777216:case 33554432:return n&62914560;case 67108864:return 67108864;case 134217728:return 134217728;case 268435456:return 268435456;case 536870912:return 536870912;case 1073741824:return 0;default:return n}}function re(n,i,l){var u=n.pendingLanes;if(u===0)return 0;var b=0,v=n.suspendedLanes,A=n.pingedLanes;n=n.warmLanes;var P=u&134217727;return P!==0?(u=P&~v,u!==0?b=hn(u):(A&=P,A!==0?b=hn(A):l||(l=P&~n,l!==0&&(b=hn(l))))):(P=u&~v,P!==0?b=hn(P):A!==0?b=hn(A):l||(l=u&~n,l!==0&&(b=hn(l)))),b===0?0:i!==0&&i!==b&&(i&v)===0&&(v=b&-b,l=i&-i,v>=l||v===32&&(l&4194048)!==0)?i:b}function me(n,i){return(n.pendingLanes&~(n.suspendedLanes&~n.pingedLanes)&i)===0}function Ee(n,i){switch(n){case 1:case 2:case 4:case 8:case 64:return i+250;case 16:case 32:case 128:case 256:case 512:case 1024:case 2048:case 4096:case 8192:case 16384:case 32768:case 65536:case 131072:case 262144:case 524288:case 1048576:case 2097152:return i+5e3;case 4194304:case 8388608:case 16777216:case 33554432:return-1;case 67108864:case 134217728:case 268435456:case 536870912:case 1073741824:return-1;default:return-1}}function Pe(){var n=On;return On<<=1,(On&62914560)===0&&(On=4194304),n}function St(n){for(var i=[],l=0;31>l;l++)i.push(n);return i}function gt(n,i){n.pendingLanes|=i,i!==268435456&&(n.suspendedLanes=0,n.pingedLanes=0,n.warmLanes=0)}function Ae(n,i,l,u,b,v){var A=n.pendingLanes;n.pendingLanes=l,n.suspendedLanes=0,n.pingedLanes=0,n.warmLanes=0,n.expiredLanes&=l,n.entangledLanes&=l,n.errorRecoveryDisabledLanes&=l,n.shellSuspendCounter=0;var P=n.entanglements,ne=n.expirationTimes,le=n.hiddenUpdates;for(l=A&~l;0"u")return null;try{return n.activeElement||n.body}catch{return n.body}}var rs=/[\n"\\]/g;function kn(n){return n.replace(rs,function(i){return"\\"+i.charCodeAt(0).toString(16)+" "})}function ba(n,i,l,u,b,v,A,P){n.name="",A!=null&&typeof A!="function"&&typeof A!="symbol"&&typeof A!="boolean"?n.type=A:n.removeAttribute("type"),i!=null?A==="number"?(i===0&&n.value===""||n.value!=i)&&(n.value=""+_t(i)):n.value!==""+_t(i)&&(n.value=""+_t(i)):A!=="submit"&&A!=="reset"||n.removeAttribute("value"),i!=null?Oi(n,A,_t(i)):l!=null?Oi(n,A,_t(l)):u!=null&&n.removeAttribute("value"),b==null&&v!=null&&(n.defaultChecked=!!v),b!=null&&(n.checked=b&&typeof b!="function"&&typeof b!="symbol"),P!=null&&typeof P!="function"&&typeof P!="symbol"&&typeof P!="boolean"?n.name=""+_t(P):n.removeAttribute("name")}function Er(n,i,l,u,b,v,A,P){if(v!=null&&typeof v!="function"&&typeof v!="symbol"&&typeof v!="boolean"&&(n.type=v),i!=null||l!=null){if(!(v!=="submit"&&v!=="reset"||i!=null)){Ai(n);return}l=l!=null?""+_t(l):"",i=i!=null?""+_t(i):l,P||i===n.value||(n.value=i),n.defaultValue=i}u=u??b,u=typeof u!="function"&&typeof u!="symbol"&&!!u,n.checked=P?n.checked:!!u,n.defaultChecked=!!u,A!=null&&typeof A!="function"&&typeof A!="symbol"&&typeof A!="boolean"&&(n.name=A),Ai(n)}function Oi(n,i,l){i==="number"&&Mi(n.ownerDocument)===n||n.defaultValue===""+l||(n.defaultValue=""+l)}function un(n,i,l,u){if(n=n.options,i){i={};for(var b=0;b"u"||typeof window.document>"u"||typeof window.document.createElement>"u"),ld=!1;if(ti)try{var ll={};Object.defineProperty(ll,"passive",{get:function(){ld=!0}}),window.addEventListener("test",ll,ll),window.removeEventListener("test",ll,ll)}catch{ld=!1}var Di=null,od=null,qo=null;function pg(){if(qo)return qo;var n,i=od,l=i.length,u,b="value"in Di?Di.value:Di.textContent,v=b.length;for(n=0;n=ul),_g=" ",wg=!1;function Eg(n,i){switch(n){case"keyup":return $S.indexOf(i.keyCode)!==-1;case"keydown":return i.keyCode!==229;case"keypress":case"mousedown":case"focusout":return!0;default:return!1}}function Ng(n){return n=n.detail,typeof n=="object"&&"data"in n?n.data:null}var as=!1;function PS(n,i){switch(n){case"compositionend":return Ng(i);case"keypress":return i.which!==32?null:(wg=!0,_g);case"textInput":return n=i.data,n===_g&&wg?null:n;default:return null}}function FS(n,i){if(as)return n==="compositionend"||!hd&&Eg(n,i)?(n=pg(),qo=od=Di=null,as=!1,n):null;switch(n){case"paste":return null;case"keypress":if(!(i.ctrlKey||i.altKey||i.metaKey)||i.ctrlKey&&i.altKey){if(i.char&&1=i)return{node:l,offset:i-n};n=u}e:{for(;l;){if(l.nextSibling){l=l.nextSibling;break e}l=l.parentNode}l=void 0}l=Rg(l)}}function Dg(n,i){return n&&i?n===i?!0:n&&n.nodeType===3?!1:i&&i.nodeType===3?Dg(n,i.parentNode):"contains"in n?n.contains(i):n.compareDocumentPosition?!!(n.compareDocumentPosition(i)&16):!1:!1}function Lg(n){n=n!=null&&n.ownerDocument!=null&&n.ownerDocument.defaultView!=null?n.ownerDocument.defaultView:window;for(var i=Mi(n.document);i instanceof n.HTMLIFrameElement;){try{var l=typeof i.contentWindow.location.href=="string"}catch{l=!1}if(l)n=i.contentWindow;else break;i=Mi(n.document)}return i}function gd(n){var i=n&&n.nodeName&&n.nodeName.toLowerCase();return i&&(i==="input"&&(n.type==="text"||n.type==="search"||n.type==="tel"||n.type==="url"||n.type==="password")||i==="textarea"||n.contentEditable==="true")}var WS=ti&&"documentMode"in document&&11>=document.documentMode,ss=null,bd=null,ml=null,xd=!1;function zg(n,i,l){var u=l.window===l?l.document:l.nodeType===9?l:l.ownerDocument;xd||ss==null||ss!==Mi(u)||(u=ss,"selectionStart"in u&&gd(u)?u={start:u.selectionStart,end:u.selectionEnd}:(u=(u.ownerDocument&&u.ownerDocument.defaultView||window).getSelection(),u={anchorNode:u.anchorNode,anchorOffset:u.anchorOffset,focusNode:u.focusNode,focusOffset:u.focusOffset}),ml&&hl(ml,u)||(ml=u,u=Lc(bd,"onSelect"),0>=A,b-=A,Hr=1<<32-ut(i)+b|l<Ke?(at=je,je=null):at=je.sibling;var mt=oe(ae,je,se[Ke],pe);if(mt===null){je===null&&(je=at);break}n&&je&&mt.alternate===null&&i(ae,je),ie=v(mt,ie,Ke),ht===null?Ie=mt:ht.sibling=mt,ht=mt,je=at}if(Ke===se.length)return l(ae,je),lt&&ri(ae,Ke),Ie;if(je===null){for(;KeKe?(at=je,je=null):at=je.sibling;var na=oe(ae,je,mt.value,pe);if(na===null){je===null&&(je=at);break}n&&je&&na.alternate===null&&i(ae,je),ie=v(na,ie,Ke),ht===null?Ie=na:ht.sibling=na,ht=na,je=at}if(mt.done)return l(ae,je),lt&&ri(ae,Ke),Ie;if(je===null){for(;!mt.done;Ke++,mt=se.next())mt=ge(ae,mt.value,pe),mt!==null&&(ie=v(mt,ie,Ke),ht===null?Ie=mt:ht.sibling=mt,ht=mt);return lt&&ri(ae,Ke),Ie}for(je=u(je);!mt.done;Ke++,mt=se.next())mt=de(je,ae,Ke,mt.value,pe),mt!==null&&(n&&mt.alternate!==null&&je.delete(mt.key===null?Ke:mt.key),ie=v(mt,ie,Ke),ht===null?Ie=mt:ht.sibling=mt,ht=mt);return n&&je.forEach(function(xk){return i(ae,xk)}),lt&&ri(ae,Ke),Ie}function Nt(ae,ie,se,pe){if(typeof se=="object"&&se!==null&&se.type===N&&se.key===null&&(se=se.props.children),typeof se=="object"&&se!==null){switch(se.$$typeof){case x:e:{for(var Ie=se.key;ie!==null;){if(ie.key===Ie){if(Ie=se.type,Ie===N){if(ie.tag===7){l(ae,ie.sibling),pe=b(ie,se.props.children),pe.return=ae,ae=pe;break e}}else if(ie.elementType===Ie||typeof Ie=="object"&&Ie!==null&&Ie.$$typeof===B&&Ta(Ie)===ie.type){l(ae,ie.sibling),pe=b(ie,se.props),vl(pe,se),pe.return=ae,ae=pe;break e}l(ae,ie);break}else i(ae,ie);ie=ie.sibling}se.type===N?(pe=Ea(se.props.children,ae.mode,pe,se.key),pe.return=ae,ae=pe):(pe=Wo(se.type,se.key,se.props,null,ae.mode,pe),vl(pe,se),pe.return=ae,ae=pe)}return A(ae);case _:e:{for(Ie=se.key;ie!==null;){if(ie.key===Ie)if(ie.tag===4&&ie.stateNode.containerInfo===se.containerInfo&&ie.stateNode.implementation===se.implementation){l(ae,ie.sibling),pe=b(ie,se.children||[]),pe.return=ae,ae=pe;break e}else{l(ae,ie);break}else i(ae,ie);ie=ie.sibling}pe=Sd(se,ae.mode,pe),pe.return=ae,ae=pe}return A(ae);case B:return se=Ta(se),Nt(ae,ie,se,pe)}if(U(se))return Te(ae,ie,se,pe);if(G(se)){if(Ie=G(se),typeof Ie!="function")throw Error(a(150));return se=Ie.call(se),He(ae,ie,se,pe)}if(typeof se.then=="function")return Nt(ae,ie,ac(se),pe);if(se.$$typeof===E)return Nt(ae,ie,tc(ae,se),pe);sc(ae,se)}return typeof se=="string"&&se!==""||typeof se=="number"||typeof se=="bigint"?(se=""+se,ie!==null&&ie.tag===6?(l(ae,ie.sibling),pe=b(ie,se),pe.return=ae,ae=pe):(l(ae,ie),pe=Nd(se,ae.mode,pe),pe.return=ae,ae=pe),A(ae)):l(ae,ie)}return function(ae,ie,se,pe){try{yl=0;var Ie=Nt(ae,ie,se,pe);return bs=null,Ie}catch(je){if(je===gs||je===rc)throw je;var ht=Qn(29,je,null,ae.mode);return ht.lanes=pe,ht.return=ae,ht}finally{}}}var Ma=ab(!0),sb=ab(!1),Ui=!1;function Id(n){n.updateQueue={baseState:n.memoizedState,firstBaseUpdate:null,lastBaseUpdate:null,shared:{pending:null,lanes:0,hiddenCallbacks:null},callbacks:null}}function Bd(n,i){n=n.updateQueue,i.updateQueue===n&&(i.updateQueue={baseState:n.baseState,firstBaseUpdate:n.firstBaseUpdate,lastBaseUpdate:n.lastBaseUpdate,shared:n.shared,callbacks:null})}function Hi(n){return{lane:n,tag:0,payload:null,callback:null,next:null}}function $i(n,i,l){var u=n.updateQueue;if(u===null)return null;if(u=u.shared,(pt&2)!==0){var b=u.pending;return b===null?i.next=i:(i.next=b.next,b.next=i),u.pending=i,i=Qo(n),Pg(n,null,l),i}return Zo(n,u,i,l),Qo(n)}function _l(n,i,l){if(i=i.updateQueue,i!==null&&(i=i.shared,(l&4194048)!==0)){var u=i.lanes;u&=n.pendingLanes,l|=u,i.lanes=l,Ue(n,l)}}function Ud(n,i){var l=n.updateQueue,u=n.alternate;if(u!==null&&(u=u.updateQueue,l===u)){var b=null,v=null;if(l=l.firstBaseUpdate,l!==null){do{var A={lane:l.lane,tag:l.tag,payload:l.payload,callback:null,next:null};v===null?b=v=A:v=v.next=A,l=l.next}while(l!==null);v===null?b=v=i:v=v.next=i}else b=v=i;l={baseState:u.baseState,firstBaseUpdate:b,lastBaseUpdate:v,shared:u.shared,callbacks:u.callbacks},n.updateQueue=l;return}n=l.lastBaseUpdate,n===null?l.firstBaseUpdate=i:n.next=i,l.lastBaseUpdate=i}var Hd=!1;function wl(){if(Hd){var n=ps;if(n!==null)throw n}}function El(n,i,l,u){Hd=!1;var b=n.updateQueue;Ui=!1;var v=b.firstBaseUpdate,A=b.lastBaseUpdate,P=b.shared.pending;if(P!==null){b.shared.pending=null;var ne=P,le=ne.next;ne.next=null,A===null?v=le:A.next=le,A=ne;var he=n.alternate;he!==null&&(he=he.updateQueue,P=he.lastBaseUpdate,P!==A&&(P===null?he.firstBaseUpdate=le:P.next=le,he.lastBaseUpdate=ne))}if(v!==null){var ge=b.baseState;A=0,he=le=ne=null,P=v;do{var oe=P.lane&-536870913,de=oe!==P.lane;if(de?(it&oe)===oe:(u&oe)===oe){oe!==0&&oe===ms&&(Hd=!0),he!==null&&(he=he.next={lane:0,tag:P.tag,payload:P.payload,callback:null,next:null});e:{var Te=n,He=P;oe=i;var Nt=l;switch(He.tag){case 1:if(Te=He.payload,typeof Te=="function"){ge=Te.call(Nt,ge,oe);break e}ge=Te;break e;case 3:Te.flags=Te.flags&-65537|128;case 0:if(Te=He.payload,oe=typeof Te=="function"?Te.call(Nt,ge,oe):Te,oe==null)break e;ge=p({},ge,oe);break e;case 2:Ui=!0}}oe=P.callback,oe!==null&&(n.flags|=64,de&&(n.flags|=8192),de=b.callbacks,de===null?b.callbacks=[oe]:de.push(oe))}else de={lane:oe,tag:P.tag,payload:P.payload,callback:P.callback,next:null},he===null?(le=he=de,ne=ge):he=he.next=de,A|=oe;if(P=P.next,P===null){if(P=b.shared.pending,P===null)break;de=P,P=de.next,de.next=null,b.lastBaseUpdate=de,b.shared.pending=null}}while(!0);he===null&&(ne=ge),b.baseState=ne,b.firstBaseUpdate=le,b.lastBaseUpdate=he,v===null&&(b.shared.lanes=0),Vi|=A,n.lanes=A,n.memoizedState=ge}}function lb(n,i){if(typeof n!="function")throw Error(a(191,n));n.call(i)}function ob(n,i){var l=n.callbacks;if(l!==null)for(n.callbacks=null,n=0;nv?v:8;var A=O.T,P={};O.T=P,sf(n,!1,i,l);try{var ne=b(),le=O.S;if(le!==null&&le(P,ne),ne!==null&&typeof ne=="object"&&typeof ne.then=="function"){var he=l2(ne,u);kl(n,i,he,nr(n))}else kl(n,i,u,nr(n))}catch(ge){kl(n,i,{then:function(){},status:"rejected",reason:ge},nr())}finally{H.p=v,A!==null&&P.types!==null&&(A.types=P.types),O.T=A}}function h2(){}function rf(n,i,l,u){if(n.tag!==5)throw Error(a(476));var b=Hb(n).queue;Ub(n,b,i,X,l===null?h2:function(){return $b(n),l(u)})}function Hb(n){var i=n.memoizedState;if(i!==null)return i;i={memoizedState:X,baseState:X,baseQueue:null,queue:{pending:null,lanes:0,dispatch:null,lastRenderedReducer:li,lastRenderedState:X},next:null};var l={};return i.next={memoizedState:l,baseState:l,baseQueue:null,queue:{pending:null,lanes:0,dispatch:null,lastRenderedReducer:li,lastRenderedState:l},next:null},n.memoizedState=i,n=n.alternate,n!==null&&(n.memoizedState=i),i}function $b(n){var i=Hb(n);i.next===null&&(i=n.alternate.memoizedState),kl(n,i.next.queue,{},nr())}function af(){return yn(Pl)}function qb(){return Qt().memoizedState}function Pb(){return Qt().memoizedState}function m2(n){for(var i=n.return;i!==null;){switch(i.tag){case 24:case 3:var l=nr();n=Hi(l);var u=$i(i,n,l);u!==null&&(Pn(u,i,l),_l(u,i,l)),i={cache:jd()},n.payload=i;return}i=i.return}}function p2(n,i,l){var u=nr();l={lane:u,revertLane:0,gesture:null,action:l,hasEagerState:!1,eagerState:null,next:null},gc(n)?Gb(i,l):(l=wd(n,i,l,u),l!==null&&(Pn(l,n,u),Vb(l,i,u)))}function Fb(n,i,l){var u=nr();kl(n,i,l,u)}function kl(n,i,l,u){var b={lane:u,revertLane:0,gesture:null,action:l,hasEagerState:!1,eagerState:null,next:null};if(gc(n))Gb(i,b);else{var v=n.alternate;if(n.lanes===0&&(v===null||v.lanes===0)&&(v=i.lastRenderedReducer,v!==null))try{var A=i.lastRenderedState,P=v(A,l);if(b.hasEagerState=!0,b.eagerState=P,Zn(P,A))return Zo(n,i,b,0),kt===null&&Ko(),!1}catch{}finally{}if(l=wd(n,i,b,u),l!==null)return Pn(l,n,u),Vb(l,i,u),!0}return!1}function sf(n,i,l,u){if(u={lane:2,revertLane:Bf(),gesture:null,action:u,hasEagerState:!1,eagerState:null,next:null},gc(n)){if(i)throw Error(a(479))}else i=wd(n,l,u,2),i!==null&&Pn(i,n,2)}function gc(n){var i=n.alternate;return n===Xe||i!==null&&i===Xe}function Gb(n,i){ys=cc=!0;var l=n.pending;l===null?i.next=i:(i.next=l.next,l.next=i),n.pending=i}function Vb(n,i,l){if((l&4194048)!==0){var u=i.lanes;u&=n.pendingLanes,l|=u,i.lanes=l,Ue(n,l)}}var Cl={readContext:yn,use:fc,useCallback:Gt,useContext:Gt,useEffect:Gt,useImperativeHandle:Gt,useLayoutEffect:Gt,useInsertionEffect:Gt,useMemo:Gt,useReducer:Gt,useRef:Gt,useState:Gt,useDebugValue:Gt,useDeferredValue:Gt,useTransition:Gt,useSyncExternalStore:Gt,useId:Gt,useHostTransitionStatus:Gt,useFormState:Gt,useActionState:Gt,useOptimistic:Gt,useMemoCache:Gt,useCacheRefresh:Gt};Cl.useEffectEvent=Gt;var Yb={readContext:yn,use:fc,useCallback:function(n,i){return Dn().memoizedState=[n,i===void 0?null:i],n},useContext:yn,useEffect:Mb,useImperativeHandle:function(n,i,l){l=l!=null?l.concat([n]):null,mc(4194308,4,Db.bind(null,i,n),l)},useLayoutEffect:function(n,i){return mc(4194308,4,n,i)},useInsertionEffect:function(n,i){mc(4,2,n,i)},useMemo:function(n,i){var l=Dn();i=i===void 0?null:i;var u=n();if(Oa){Wt(!0);try{n()}finally{Wt(!1)}}return l.memoizedState=[u,i],u},useReducer:function(n,i,l){var u=Dn();if(l!==void 0){var b=l(i);if(Oa){Wt(!0);try{l(i)}finally{Wt(!1)}}}else b=i;return u.memoizedState=u.baseState=b,n={pending:null,lanes:0,dispatch:null,lastRenderedReducer:n,lastRenderedState:b},u.queue=n,n=n.dispatch=p2.bind(null,Xe,n),[u.memoizedState,n]},useRef:function(n){var i=Dn();return n={current:n},i.memoizedState=n},useState:function(n){n=Wd(n);var i=n.queue,l=Fb.bind(null,Xe,i);return i.dispatch=l,[n.memoizedState,l]},useDebugValue:tf,useDeferredValue:function(n,i){var l=Dn();return nf(l,n,i)},useTransition:function(){var n=Wd(!1);return n=Ub.bind(null,Xe,n.queue,!0,!1),Dn().memoizedState=n,[!1,n]},useSyncExternalStore:function(n,i,l){var u=Xe,b=Dn();if(lt){if(l===void 0)throw Error(a(407));l=l()}else{if(l=i(),kt===null)throw Error(a(349));(it&127)!==0||mb(u,i,l)}b.memoizedState=l;var v={value:l,getSnapshot:i};return b.queue=v,Mb(gb.bind(null,u,v,n),[n]),u.flags|=2048,_s(9,{destroy:void 0},pb.bind(null,u,v,l,i),null),l},useId:function(){var n=Dn(),i=kt.identifierPrefix;if(lt){var l=$r,u=Hr;l=(u&~(1<<32-ut(u)-1)).toString(32)+l,i="_"+i+"R_"+l,l=uc++,0<\/script>",v=v.removeChild(v.firstChild);break;case"select":v=typeof u.is=="string"?A.createElement("select",{is:u.is}):A.createElement("select"),u.multiple?v.multiple=!0:u.size&&(v.size=u.size);break;default:v=typeof u.is=="string"?A.createElement(b,{is:u.is}):A.createElement(b)}}v[Ut]=i,v[mn]=u;e:for(A=i.child;A!==null;){if(A.tag===5||A.tag===6)v.appendChild(A.stateNode);else if(A.tag!==4&&A.tag!==27&&A.child!==null){A.child.return=A,A=A.child;continue}if(A===i)break e;for(;A.sibling===null;){if(A.return===null||A.return===i)break e;A=A.return}A.sibling.return=A.return,A=A.sibling}i.stateNode=v;e:switch(_n(v,b,u),b){case"button":case"input":case"select":case"textarea":u=!!u.autoFocus;break e;case"img":u=!0;break e;default:u=!1}u&&ci(i)}}return Dt(i),vf(i,i.type,n===null?null:n.memoizedProps,i.pendingProps,l),null;case 6:if(n&&i.stateNode!=null)n.memoizedProps!==u&&ci(i);else{if(typeof u!="string"&&i.stateNode===null)throw Error(a(166));if(n=Q.current,fs(i)){if(n=i.stateNode,l=i.memoizedProps,u=null,b=xn,b!==null)switch(b.tag){case 27:case 5:u=b.memoizedProps}n[Ut]=i,n=!!(n.nodeValue===l||u!==null&&u.suppressHydrationWarning===!0||f0(n.nodeValue,l)),n||Ii(i,!0)}else n=zc(n).createTextNode(u),n[Ut]=i,i.stateNode=n}return Dt(i),null;case 31:if(l=i.memoizedState,n===null||n.memoizedState!==null){if(u=fs(i),l!==null){if(n===null){if(!u)throw Error(a(318));if(n=i.memoizedState,n=n!==null?n.dehydrated:null,!n)throw Error(a(557));n[Ut]=i}else Na(),(i.flags&128)===0&&(i.memoizedState=null),i.flags|=4;Dt(i),n=!1}else l=Ad(),n!==null&&n.memoizedState!==null&&(n.memoizedState.hydrationErrors=l),n=!0;if(!n)return i.flags&256?(Jn(i),i):(Jn(i),null);if((i.flags&128)!==0)throw Error(a(558))}return Dt(i),null;case 13:if(u=i.memoizedState,n===null||n.memoizedState!==null&&n.memoizedState.dehydrated!==null){if(b=fs(i),u!==null&&u.dehydrated!==null){if(n===null){if(!b)throw Error(a(318));if(b=i.memoizedState,b=b!==null?b.dehydrated:null,!b)throw Error(a(317));b[Ut]=i}else Na(),(i.flags&128)===0&&(i.memoizedState=null),i.flags|=4;Dt(i),b=!1}else b=Ad(),n!==null&&n.memoizedState!==null&&(n.memoizedState.hydrationErrors=b),b=!0;if(!b)return i.flags&256?(Jn(i),i):(Jn(i),null)}return Jn(i),(i.flags&128)!==0?(i.lanes=l,i):(l=u!==null,n=n!==null&&n.memoizedState!==null,l&&(u=i.child,b=null,u.alternate!==null&&u.alternate.memoizedState!==null&&u.alternate.memoizedState.cachePool!==null&&(b=u.alternate.memoizedState.cachePool.pool),v=null,u.memoizedState!==null&&u.memoizedState.cachePool!==null&&(v=u.memoizedState.cachePool.pool),v!==b&&(u.flags|=2048)),l!==n&&l&&(i.child.flags|=8192),_c(i,i.updateQueue),Dt(i),null);case 4:return te(),n===null&&qf(i.stateNode.containerInfo),Dt(i),null;case 10:return ai(i.type),Dt(i),null;case 19:if(Y(Zt),u=i.memoizedState,u===null)return Dt(i),null;if(b=(i.flags&128)!==0,v=u.rendering,v===null)if(b)Al(u,!1);else{if(Vt!==0||n!==null&&(n.flags&128)!==0)for(n=i.child;n!==null;){if(v=oc(n),v!==null){for(i.flags|=128,Al(u,!1),n=v.updateQueue,i.updateQueue=n,_c(i,n),i.subtreeFlags=0,n=l,l=i.child;l!==null;)Fg(l,n),l=l.sibling;return L(Zt,Zt.current&1|2),lt&&ri(i,u.treeForkCount),i.child}n=n.sibling}u.tail!==null&&ct()>kc&&(i.flags|=128,b=!0,Al(u,!1),i.lanes=4194304)}else{if(!b)if(n=oc(v),n!==null){if(i.flags|=128,b=!0,n=n.updateQueue,i.updateQueue=n,_c(i,n),Al(u,!0),u.tail===null&&u.tailMode==="hidden"&&!v.alternate&&!lt)return Dt(i),null}else 2*ct()-u.renderingStartTime>kc&&l!==536870912&&(i.flags|=128,b=!0,Al(u,!1),i.lanes=4194304);u.isBackwards?(v.sibling=i.child,i.child=v):(n=u.last,n!==null?n.sibling=v:i.child=v,u.last=v)}return u.tail!==null?(n=u.tail,u.rendering=n,u.tail=n.sibling,u.renderingStartTime=ct(),n.sibling=null,l=Zt.current,L(Zt,b?l&1|2:l&1),lt&&ri(i,u.treeForkCount),n):(Dt(i),null);case 22:case 23:return Jn(i),qd(),u=i.memoizedState!==null,n!==null?n.memoizedState!==null!==u&&(i.flags|=8192):u&&(i.flags|=8192),u?(l&536870912)!==0&&(i.flags&128)===0&&(Dt(i),i.subtreeFlags&6&&(i.flags|=8192)):Dt(i),l=i.updateQueue,l!==null&&_c(i,l.retryQueue),l=null,n!==null&&n.memoizedState!==null&&n.memoizedState.cachePool!==null&&(l=n.memoizedState.cachePool.pool),u=null,i.memoizedState!==null&&i.memoizedState.cachePool!==null&&(u=i.memoizedState.cachePool.pool),u!==l&&(i.flags|=2048),n!==null&&Y(Ca),null;case 24:return l=null,n!==null&&(l=n.memoizedState.cache),i.memoizedState.cache!==l&&(i.flags|=2048),ai(en),Dt(i),null;case 25:return null;case 30:return null}throw Error(a(156,i.tag))}function v2(n,i){switch(Cd(i),i.tag){case 1:return n=i.flags,n&65536?(i.flags=n&-65537|128,i):null;case 3:return ai(en),te(),n=i.flags,(n&65536)!==0&&(n&128)===0?(i.flags=n&-65537|128,i):null;case 26:case 27:case 5:return fe(i),null;case 31:if(i.memoizedState!==null){if(Jn(i),i.alternate===null)throw Error(a(340));Na()}return n=i.flags,n&65536?(i.flags=n&-65537|128,i):null;case 13:if(Jn(i),n=i.memoizedState,n!==null&&n.dehydrated!==null){if(i.alternate===null)throw Error(a(340));Na()}return n=i.flags,n&65536?(i.flags=n&-65537|128,i):null;case 19:return Y(Zt),null;case 4:return te(),null;case 10:return ai(i.type),null;case 22:case 23:return Jn(i),qd(),n!==null&&Y(Ca),n=i.flags,n&65536?(i.flags=n&-65537|128,i):null;case 24:return ai(en),null;case 25:return null;default:return null}}function bx(n,i){switch(Cd(i),i.tag){case 3:ai(en),te();break;case 26:case 27:case 5:fe(i);break;case 4:te();break;case 31:i.memoizedState!==null&&Jn(i);break;case 13:Jn(i);break;case 19:Y(Zt);break;case 10:ai(i.type);break;case 22:case 23:Jn(i),qd(),n!==null&&Y(Ca);break;case 24:ai(en)}}function Ml(n,i){try{var l=i.updateQueue,u=l!==null?l.lastEffect:null;if(u!==null){var b=u.next;l=b;do{if((l.tag&n)===n){u=void 0;var v=l.create,A=l.inst;u=v(),A.destroy=u}l=l.next}while(l!==b)}}catch(P){yt(i,i.return,P)}}function Fi(n,i,l){try{var u=i.updateQueue,b=u!==null?u.lastEffect:null;if(b!==null){var v=b.next;u=v;do{if((u.tag&n)===n){var A=u.inst,P=A.destroy;if(P!==void 0){A.destroy=void 0,b=i;var ne=l,le=P;try{le()}catch(he){yt(b,ne,he)}}}u=u.next}while(u!==v)}}catch(he){yt(i,i.return,he)}}function xx(n){var i=n.updateQueue;if(i!==null){var l=n.stateNode;try{ob(i,l)}catch(u){yt(n,n.return,u)}}}function yx(n,i,l){l.props=Ra(n.type,n.memoizedProps),l.state=n.memoizedState;try{l.componentWillUnmount()}catch(u){yt(n,i,u)}}function Ol(n,i){try{var l=n.ref;if(l!==null){switch(n.tag){case 26:case 27:case 5:var u=n.stateNode;break;case 30:u=n.stateNode;break;default:u=n.stateNode}typeof l=="function"?n.refCleanup=l(u):l.current=u}}catch(b){yt(n,i,b)}}function qr(n,i){var l=n.ref,u=n.refCleanup;if(l!==null)if(typeof u=="function")try{u()}catch(b){yt(n,i,b)}finally{n.refCleanup=null,n=n.alternate,n!=null&&(n.refCleanup=null)}else if(typeof l=="function")try{l(null)}catch(b){yt(n,i,b)}else l.current=null}function vx(n){var i=n.type,l=n.memoizedProps,u=n.stateNode;try{e:switch(i){case"button":case"input":case"select":case"textarea":l.autoFocus&&u.focus();break e;case"img":l.src?u.src=l.src:l.srcSet&&(u.srcset=l.srcSet)}}catch(b){yt(n,n.return,b)}}function _f(n,i,l){try{var u=n.stateNode;q2(u,n.type,l,i),u[mn]=i}catch(b){yt(n,n.return,b)}}function _x(n){return n.tag===5||n.tag===3||n.tag===26||n.tag===27&&Qi(n.type)||n.tag===4}function wf(n){e:for(;;){for(;n.sibling===null;){if(n.return===null||_x(n.return))return null;n=n.return}for(n.sibling.return=n.return,n=n.sibling;n.tag!==5&&n.tag!==6&&n.tag!==18;){if(n.tag===27&&Qi(n.type)||n.flags&2||n.child===null||n.tag===4)continue e;n.child.return=n,n=n.child}if(!(n.flags&2))return n.stateNode}}function Ef(n,i,l){var u=n.tag;if(u===5||u===6)n=n.stateNode,i?(l.nodeType===9?l.body:l.nodeName==="HTML"?l.ownerDocument.body:l).insertBefore(n,i):(i=l.nodeType===9?l.body:l.nodeName==="HTML"?l.ownerDocument.body:l,i.appendChild(n),l=l._reactRootContainer,l!=null||i.onclick!==null||(i.onclick=_e));else if(u!==4&&(u===27&&Qi(n.type)&&(l=n.stateNode,i=null),n=n.child,n!==null))for(Ef(n,i,l),n=n.sibling;n!==null;)Ef(n,i,l),n=n.sibling}function wc(n,i,l){var u=n.tag;if(u===5||u===6)n=n.stateNode,i?l.insertBefore(n,i):l.appendChild(n);else if(u!==4&&(u===27&&Qi(n.type)&&(l=n.stateNode),n=n.child,n!==null))for(wc(n,i,l),n=n.sibling;n!==null;)wc(n,i,l),n=n.sibling}function wx(n){var i=n.stateNode,l=n.memoizedProps;try{for(var u=n.type,b=i.attributes;b.length;)i.removeAttributeNode(b[0]);_n(i,u,l),i[Ut]=n,i[mn]=l}catch(v){yt(n,n.return,v)}}var ui=!1,rn=!1,Nf=!1,Ex=typeof WeakSet=="function"?WeakSet:Set,gn=null;function _2(n,i){if(n=n.containerInfo,Gf=Pc,n=Lg(n),gd(n)){if("selectionStart"in n)var l={start:n.selectionStart,end:n.selectionEnd};else e:{l=(l=n.ownerDocument)&&l.defaultView||window;var u=l.getSelection&&l.getSelection();if(u&&u.rangeCount!==0){l=u.anchorNode;var b=u.anchorOffset,v=u.focusNode;u=u.focusOffset;try{l.nodeType,v.nodeType}catch{l=null;break e}var A=0,P=-1,ne=-1,le=0,he=0,ge=n,oe=null;t:for(;;){for(var de;ge!==l||b!==0&&ge.nodeType!==3||(P=A+b),ge!==v||u!==0&&ge.nodeType!==3||(ne=A+u),ge.nodeType===3&&(A+=ge.nodeValue.length),(de=ge.firstChild)!==null;)oe=ge,ge=de;for(;;){if(ge===n)break t;if(oe===l&&++le===b&&(P=A),oe===v&&++he===u&&(ne=A),(de=ge.nextSibling)!==null)break;ge=oe,oe=ge.parentNode}ge=de}l=P===-1||ne===-1?null:{start:P,end:ne}}else l=null}l=l||{start:0,end:0}}else l=null;for(Vf={focusedElem:n,selectionRange:l},Pc=!1,gn=i;gn!==null;)if(i=gn,n=i.child,(i.subtreeFlags&1028)!==0&&n!==null)n.return=i,gn=n;else for(;gn!==null;){switch(i=gn,v=i.alternate,n=i.flags,i.tag){case 0:if((n&4)!==0&&(n=i.updateQueue,n=n!==null?n.events:null,n!==null))for(l=0;l title"))),_n(v,u,l),v[Ut]=n,Ft(v),u=v;break e;case"link":var A=A0("link","href",b).get(u+(l.href||""));if(A){for(var P=0;PNt&&(A=Nt,Nt=He,He=A);var ae=jg(P,He),ie=jg(P,Nt);if(ae&&ie&&(de.rangeCount!==1||de.anchorNode!==ae.node||de.anchorOffset!==ae.offset||de.focusNode!==ie.node||de.focusOffset!==ie.offset)){var se=ge.createRange();se.setStart(ae.node,ae.offset),de.removeAllRanges(),He>Nt?(de.addRange(se),de.extend(ie.node,ie.offset)):(se.setEnd(ie.node,ie.offset),de.addRange(se))}}}}for(ge=[],de=P;de=de.parentNode;)de.nodeType===1&&ge.push({element:de,left:de.scrollLeft,top:de.scrollTop});for(typeof P.focus=="function"&&P.focus(),P=0;Pl?32:l,O.T=null,l=Of,Of=null;var v=Xi,A=pi;if(dn=0,ks=Xi=null,pi=0,(pt&6)!==0)throw Error(a(331));var P=pt;if(pt|=4,Dx(v.current),Ox(v,v.current,A,l),pt=P,Il(0,!1),At&&typeof At.onPostCommitFiberRoot=="function")try{At.onPostCommitFiberRoot(Kt,v)}catch{}return!0}finally{H.p=b,O.T=u,Wx(n,i)}}function e0(n,i,l){i=ur(l,i),i=uf(n.stateNode,i,2),n=$i(n,i,2),n!==null&&(gt(n,2),Pr(n))}function yt(n,i,l){if(n.tag===3)e0(n,n,l);else for(;i!==null;){if(i.tag===3){e0(i,n,l);break}else if(i.tag===1){var u=i.stateNode;if(typeof i.type.getDerivedStateFromError=="function"||typeof u.componentDidCatch=="function"&&(Yi===null||!Yi.has(u))){n=ur(l,n),l=tx(2),u=$i(i,l,2),u!==null&&(nx(l,u,i,n),gt(u,2),Pr(u));break}}i=i.return}}function Lf(n,i,l){var u=n.pingCache;if(u===null){u=n.pingCache=new N2;var b=new Set;u.set(i,b)}else b=u.get(i),b===void 0&&(b=new Set,u.set(i,b));b.has(l)||(Cf=!0,b.add(l),n=A2.bind(null,n,i,l),i.then(n,n))}function A2(n,i,l){var u=n.pingCache;u!==null&&u.delete(i),n.pingedLanes|=n.suspendedLanes&l,n.warmLanes&=~l,kt===n&&(it&l)===l&&(Vt===4||Vt===3&&(it&62914560)===it&&300>ct()-Sc?(pt&2)===0&&Cs(n,0):Tf|=l,Ss===it&&(Ss=0)),Pr(n)}function t0(n,i){i===0&&(i=Pe()),n=wa(n,i),n!==null&&(gt(n,i),Pr(n))}function M2(n){var i=n.memoizedState,l=0;i!==null&&(l=i.retryLane),t0(n,l)}function O2(n,i){var l=0;switch(n.tag){case 31:case 13:var u=n.stateNode,b=n.memoizedState;b!==null&&(l=b.retryLane);break;case 19:u=n.stateNode;break;case 22:u=n.stateNode._retryCache;break;default:throw Error(a(314))}u!==null&&u.delete(i),t0(n,l)}function R2(n,i){return Pt(n,i)}var Rc=null,As=null,zf=!1,jc=!1,If=!1,Zi=0;function Pr(n){n!==As&&n.next===null&&(As===null?Rc=As=n:As=As.next=n),jc=!0,zf||(zf=!0,D2())}function Il(n,i){if(!If&&jc){If=!0;do for(var l=!1,u=Rc;u!==null;){if(n!==0){var b=u.pendingLanes;if(b===0)var v=0;else{var A=u.suspendedLanes,P=u.pingedLanes;v=(1<<31-ut(42|n)+1)-1,v&=b&~(A&~P),v=v&201326741?v&201326741|1:v?v|2:0}v!==0&&(l=!0,a0(u,v))}else v=it,v=re(u,u===kt?v:0,u.cancelPendingCommit!==null||u.timeoutHandle!==-1),(v&3)===0||me(u,v)||(l=!0,a0(u,v));u=u.next}while(l);If=!1}}function j2(){n0()}function n0(){jc=zf=!1;var n=0;Zi!==0&&F2()&&(n=Zi);for(var i=ct(),l=null,u=Rc;u!==null;){var b=u.next,v=r0(u,i);v===0?(u.next=null,l===null?Rc=b:l.next=b,b===null&&(As=l)):(l=u,(n!==0||(v&3)!==0)&&(jc=!0)),u=b}dn!==0&&dn!==5||Il(n),Zi!==0&&(Zi=0)}function r0(n,i){for(var l=n.suspendedLanes,u=n.pingedLanes,b=n.expirationTimes,v=n.pendingLanes&-62914561;0P)break;var he=ne.transferSize,ge=ne.initiatorType;he&&h0(ge)&&(ne=ne.responseEnd,A+=he*(ne"u"?null:document;function S0(n,i,l){var u=Ms;if(u&&typeof i=="string"&&i){var b=kn(i);b='link[rel="'+n+'"][href="'+b+'"]',typeof l=="string"&&(b+='[crossorigin="'+l+'"]'),N0.has(b)||(N0.add(b),n={rel:n,crossOrigin:l,href:i},u.querySelector(b)===null&&(i=u.createElement("link"),_n(i,"link",n),Ft(i),u.head.appendChild(i)))}}function J2(n){gi.D(n),S0("dns-prefetch",n,null)}function ek(n,i){gi.C(n,i),S0("preconnect",n,i)}function tk(n,i,l){gi.L(n,i,l);var u=Ms;if(u&&n&&i){var b='link[rel="preload"][as="'+kn(i)+'"]';i==="image"&&l&&l.imageSrcSet?(b+='[imagesrcset="'+kn(l.imageSrcSet)+'"]',typeof l.imageSizes=="string"&&(b+='[imagesizes="'+kn(l.imageSizes)+'"]')):b+='[href="'+kn(n)+'"]';var v=b;switch(i){case"style":v=Os(n);break;case"script":v=Rs(n)}gr.has(v)||(n=p({rel:"preload",href:i==="image"&&l&&l.imageSrcSet?void 0:n,as:i},l),gr.set(v,n),u.querySelector(b)!==null||i==="style"&&u.querySelector($l(v))||i==="script"&&u.querySelector(ql(v))||(i=u.createElement("link"),_n(i,"link",n),Ft(i),u.head.appendChild(i)))}}function nk(n,i){gi.m(n,i);var l=Ms;if(l&&n){var u=i&&typeof i.as=="string"?i.as:"script",b='link[rel="modulepreload"][as="'+kn(u)+'"][href="'+kn(n)+'"]',v=b;switch(u){case"audioworklet":case"paintworklet":case"serviceworker":case"sharedworker":case"worker":case"script":v=Rs(n)}if(!gr.has(v)&&(n=p({rel:"modulepreload",href:n},i),gr.set(v,n),l.querySelector(b)===null)){switch(u){case"audioworklet":case"paintworklet":case"serviceworker":case"sharedworker":case"worker":case"script":if(l.querySelector(ql(v)))return}u=l.createElement("link"),_n(u,"link",n),Ft(u),l.head.appendChild(u)}}}function rk(n,i,l){gi.S(n,i,l);var u=Ms;if(u&&n){var b=Br(u).hoistableStyles,v=Os(n);i=i||"default";var A=b.get(v);if(!A){var P={loading:0,preload:null};if(A=u.querySelector($l(v)))P.loading=5;else{n=p({rel:"stylesheet",href:n,"data-precedence":i},l),(l=gr.get(v))&&Jf(n,l);var ne=A=u.createElement("link");Ft(ne),_n(ne,"link",n),ne._p=new Promise(function(le,he){ne.onload=le,ne.onerror=he}),ne.addEventListener("load",function(){P.loading|=1}),ne.addEventListener("error",function(){P.loading|=2}),P.loading|=4,Bc(A,i,u)}A={type:"stylesheet",instance:A,count:1,state:P},b.set(v,A)}}}function ik(n,i){gi.X(n,i);var l=Ms;if(l&&n){var u=Br(l).hoistableScripts,b=Rs(n),v=u.get(b);v||(v=l.querySelector(ql(b)),v||(n=p({src:n,async:!0},i),(i=gr.get(b))&&eh(n,i),v=l.createElement("script"),Ft(v),_n(v,"link",n),l.head.appendChild(v)),v={type:"script",instance:v,count:1,state:null},u.set(b,v))}}function ak(n,i){gi.M(n,i);var l=Ms;if(l&&n){var u=Br(l).hoistableScripts,b=Rs(n),v=u.get(b);v||(v=l.querySelector(ql(b)),v||(n=p({src:n,async:!0,type:"module"},i),(i=gr.get(b))&&eh(n,i),v=l.createElement("script"),Ft(v),_n(v,"link",n),l.head.appendChild(v)),v={type:"script",instance:v,count:1,state:null},u.set(b,v))}}function k0(n,i,l,u){var b=(b=Q.current)?Ic(b):null;if(!b)throw Error(a(446));switch(n){case"meta":case"title":return null;case"style":return typeof l.precedence=="string"&&typeof l.href=="string"?(i=Os(l.href),l=Br(b).hoistableStyles,u=l.get(i),u||(u={type:"style",instance:null,count:0,state:null},l.set(i,u)),u):{type:"void",instance:null,count:0,state:null};case"link":if(l.rel==="stylesheet"&&typeof l.href=="string"&&typeof l.precedence=="string"){n=Os(l.href);var v=Br(b).hoistableStyles,A=v.get(n);if(A||(b=b.ownerDocument||b,A={type:"stylesheet",instance:null,count:0,state:{loading:0,preload:null}},v.set(n,A),(v=b.querySelector($l(n)))&&!v._p&&(A.instance=v,A.state.loading=5),gr.has(n)||(l={rel:"preload",as:"style",href:l.href,crossOrigin:l.crossOrigin,integrity:l.integrity,media:l.media,hrefLang:l.hrefLang,referrerPolicy:l.referrerPolicy},gr.set(n,l),v||sk(b,n,l,A.state))),i&&u===null)throw Error(a(528,""));return A}if(i&&u!==null)throw Error(a(529,""));return null;case"script":return i=l.async,l=l.src,typeof l=="string"&&i&&typeof i!="function"&&typeof i!="symbol"?(i=Rs(l),l=Br(b).hoistableScripts,u=l.get(i),u||(u={type:"script",instance:null,count:0,state:null},l.set(i,u)),u):{type:"void",instance:null,count:0,state:null};default:throw Error(a(444,n))}}function Os(n){return'href="'+kn(n)+'"'}function $l(n){return'link[rel="stylesheet"]['+n+"]"}function C0(n){return p({},n,{"data-precedence":n.precedence,precedence:null})}function sk(n,i,l,u){n.querySelector('link[rel="preload"][as="style"]['+i+"]")?u.loading=1:(i=n.createElement("link"),u.preload=i,i.addEventListener("load",function(){return u.loading|=1}),i.addEventListener("error",function(){return u.loading|=2}),_n(i,"link",l),Ft(i),n.head.appendChild(i))}function Rs(n){return'[src="'+kn(n)+'"]'}function ql(n){return"script[async]"+n}function T0(n,i,l){if(i.count++,i.instance===null)switch(i.type){case"style":var u=n.querySelector('style[data-href~="'+kn(l.href)+'"]');if(u)return i.instance=u,Ft(u),u;var b=p({},l,{"data-href":l.href,"data-precedence":l.precedence,href:null,precedence:null});return u=(n.ownerDocument||n).createElement("style"),Ft(u),_n(u,"style",b),Bc(u,l.precedence,n),i.instance=u;case"stylesheet":b=Os(l.href);var v=n.querySelector($l(b));if(v)return i.state.loading|=4,i.instance=v,Ft(v),v;u=C0(l),(b=gr.get(b))&&Jf(u,b),v=(n.ownerDocument||n).createElement("link"),Ft(v);var A=v;return A._p=new Promise(function(P,ne){A.onload=P,A.onerror=ne}),_n(v,"link",u),i.state.loading|=4,Bc(v,l.precedence,n),i.instance=v;case"script":return v=Rs(l.src),(b=n.querySelector(ql(v)))?(i.instance=b,Ft(b),b):(u=l,(b=gr.get(v))&&(u=p({},l),eh(u,b)),n=n.ownerDocument||n,b=n.createElement("script"),Ft(b),_n(b,"link",u),n.head.appendChild(b),i.instance=b);case"void":return null;default:throw Error(a(443,i.type))}else i.type==="stylesheet"&&(i.state.loading&4)===0&&(u=i.instance,i.state.loading|=4,Bc(u,l.precedence,n));return i.instance}function Bc(n,i,l){for(var u=l.querySelectorAll('link[rel="stylesheet"][data-precedence],style[data-precedence]'),b=u.length?u[u.length-1]:null,v=b,A=0;A title"):null)}function lk(n,i,l){if(l===1||i.itemProp!=null)return!1;switch(n){case"meta":case"title":return!0;case"style":if(typeof i.precedence!="string"||typeof i.href!="string"||i.href==="")break;return!0;case"link":if(typeof i.rel!="string"||typeof i.href!="string"||i.href===""||i.onLoad||i.onError)break;switch(i.rel){case"stylesheet":return n=i.disabled,typeof i.precedence=="string"&&n==null;default:return!0}case"script":if(i.async&&typeof i.async!="function"&&typeof i.async!="symbol"&&!i.onLoad&&!i.onError&&i.src&&typeof i.src=="string")return!0}return!1}function O0(n){return!(n.type==="stylesheet"&&(n.state.loading&3)===0)}function ok(n,i,l,u){if(l.type==="stylesheet"&&(typeof u.media!="string"||matchMedia(u.media).matches!==!1)&&(l.state.loading&4)===0){if(l.instance===null){var b=Os(u.href),v=i.querySelector($l(b));if(v){i=v._p,i!==null&&typeof i=="object"&&typeof i.then=="function"&&(n.count++,n=Hc.bind(n),i.then(n,n)),l.state.loading|=4,l.instance=v,Ft(v);return}v=i.ownerDocument||i,u=C0(u),(b=gr.get(b))&&Jf(u,b),v=v.createElement("link"),Ft(v);var A=v;A._p=new Promise(function(P,ne){A.onload=P,A.onerror=ne}),_n(v,"link",u),l.instance=v}n.stylesheets===null&&(n.stylesheets=new Map),n.stylesheets.set(l,i),(i=l.state.preload)&&(l.state.loading&3)===0&&(n.count++,l=Hc.bind(n),i.addEventListener("load",l),i.addEventListener("error",l))}}var th=0;function ck(n,i){return n.stylesheets&&n.count===0&&qc(n,n.stylesheets),0th?50:800)+i);return n.unsuspend=l,function(){n.unsuspend=null,clearTimeout(u),clearTimeout(b)}}:null}function Hc(){if(this.count--,this.count===0&&(this.imgCount===0||!this.waitingForImages)){if(this.stylesheets)qc(this,this.stylesheets);else if(this.unsuspend){var n=this.unsuspend;this.unsuspend=null,n()}}}var $c=null;function qc(n,i){n.stylesheets=null,n.unsuspend!==null&&(n.count++,$c=new Map,i.forEach(uk,n),$c=null,Hc.call(n))}function uk(n,i){if(!(i.state.loading&4)){var l=$c.get(n);if(l)var u=l.get(null);else{l=new Map,$c.set(n,l);for(var b=n.querySelectorAll("link[data-precedence],style[data-precedence]"),v=0;v"u"||typeof __REACT_DEVTOOLS_GLOBAL_HOOK__.checkDCE!="function"))try{__REACT_DEVTOOLS_GLOBAL_HOOK__.checkDCE(e)}catch(t){console.error(t)}}return e(),uh.exports=Sk(),uh.exports}var Ck=kk();/** +`+u.stack}}var Yt=Object.prototype.hasOwnProperty,Pt=e.unstable_scheduleCallback,Xt=e.unstable_cancelCallback,Yn=e.unstable_shouldYield,En=e.unstable_requestPaint,ct=e.unstable_now,It=e.unstable_getCurrentPriorityLevel,ue=e.unstable_ImmediatePriority,xe=e.unstable_UserBlockingPriority,Oe=e.unstable_NormalPriority,Fe=e.unstable_LowPriority,Ze=e.unstable_IdlePriority,on=e.log,Nn=e.unstable_setDisableYieldValue,Kt=null,At=null;function Wt(n){if(typeof on=="function"&&Nn(n),At&&typeof At.setStrictMode=="function")try{At.setStrictMode(Kt,n)}catch{}}var ut=Math.clz32?Math.clz32:Ni,In=Math.log,cn=Math.LN2;function Ni(n){return n>>>=0,n===0?32:31-(In(n)/cn|0)|0}var nt=256,Xn=262144,On=4194304;function hn(n){var i=n&42;if(i!==0)return i;switch(n&-n){case 1:return 1;case 2:return 2;case 4:return 4;case 8:return 8;case 16:return 16;case 32:return 32;case 64:return 64;case 128:return 128;case 256:case 512:case 1024:case 2048:case 4096:case 8192:case 16384:case 32768:case 65536:case 131072:return n&261888;case 262144:case 524288:case 1048576:case 2097152:return n&3932160;case 4194304:case 8388608:case 16777216:case 33554432:return n&62914560;case 67108864:return 67108864;case 134217728:return 134217728;case 268435456:return 268435456;case 536870912:return 536870912;case 1073741824:return 0;default:return n}}function re(n,i,l){var u=n.pendingLanes;if(u===0)return 0;var b=0,v=n.suspendedLanes,A=n.pingedLanes;n=n.warmLanes;var F=u&134217727;return F!==0?(u=F&~v,u!==0?b=hn(u):(A&=F,A!==0?b=hn(A):l||(l=F&~n,l!==0&&(b=hn(l))))):(F=u&~v,F!==0?b=hn(F):A!==0?b=hn(A):l||(l=u&~n,l!==0&&(b=hn(l)))),b===0?0:i!==0&&i!==b&&(i&v)===0&&(v=b&-b,l=i&-i,v>=l||v===32&&(l&4194048)!==0)?i:b}function me(n,i){return(n.pendingLanes&~(n.suspendedLanes&~n.pingedLanes)&i)===0}function Ee(n,i){switch(n){case 1:case 2:case 4:case 8:case 64:return i+250;case 16:case 32:case 128:case 256:case 512:case 1024:case 2048:case 4096:case 8192:case 16384:case 32768:case 65536:case 131072:case 262144:case 524288:case 1048576:case 2097152:return i+5e3;case 4194304:case 8388608:case 16777216:case 33554432:return-1;case 67108864:case 134217728:case 268435456:case 536870912:case 1073741824:return-1;default:return-1}}function Pe(){var n=On;return On<<=1,(On&62914560)===0&&(On=4194304),n}function St(n){for(var i=[],l=0;31>l;l++)i.push(n);return i}function gt(n,i){n.pendingLanes|=i,i!==268435456&&(n.suspendedLanes=0,n.pingedLanes=0,n.warmLanes=0)}function Ae(n,i,l,u,b,v){var A=n.pendingLanes;n.pendingLanes=l,n.suspendedLanes=0,n.pingedLanes=0,n.warmLanes=0,n.expiredLanes&=l,n.entangledLanes&=l,n.errorRecoveryDisabledLanes&=l,n.shellSuspendCounter=0;var F=n.entanglements,ne=n.expirationTimes,le=n.hiddenUpdates;for(l=A&~l;0"u")return null;try{return n.activeElement||n.body}catch{return n.body}}var rs=/[\n"\\]/g;function kn(n){return n.replace(rs,function(i){return"\\"+i.charCodeAt(0).toString(16)+" "})}function xa(n,i,l,u,b,v,A,F){n.name="",A!=null&&typeof A!="function"&&typeof A!="symbol"&&typeof A!="boolean"?n.type=A:n.removeAttribute("type"),i!=null?A==="number"?(i===0&&n.value===""||n.value!=i)&&(n.value=""+_t(i)):n.value!==""+_t(i)&&(n.value=""+_t(i)):A!=="submit"&&A!=="reset"||n.removeAttribute("value"),i!=null?Oi(n,A,_t(i)):l!=null?Oi(n,A,_t(l)):u!=null&&n.removeAttribute("value"),b==null&&v!=null&&(n.defaultChecked=!!v),b!=null&&(n.checked=b&&typeof b!="function"&&typeof b!="symbol"),F!=null&&typeof F!="function"&&typeof F!="symbol"&&typeof F!="boolean"?n.name=""+_t(F):n.removeAttribute("name")}function Er(n,i,l,u,b,v,A,F){if(v!=null&&typeof v!="function"&&typeof v!="symbol"&&typeof v!="boolean"&&(n.type=v),i!=null||l!=null){if(!(v!=="submit"&&v!=="reset"||i!=null)){Ai(n);return}l=l!=null?""+_t(l):"",i=i!=null?""+_t(i):l,F||i===n.value||(n.value=i),n.defaultValue=i}u=u??b,u=typeof u!="function"&&typeof u!="symbol"&&!!u,n.checked=F?n.checked:!!u,n.defaultChecked=!!u,A!=null&&typeof A!="function"&&typeof A!="symbol"&&typeof A!="boolean"&&(n.name=A),Ai(n)}function Oi(n,i,l){i==="number"&&Mi(n.ownerDocument)===n||n.defaultValue===""+l||(n.defaultValue=""+l)}function un(n,i,l,u){if(n=n.options,i){i={};for(var b=0;b"u"||typeof window.document>"u"||typeof window.document.createElement>"u"),ld=!1;if(ti)try{var ll={};Object.defineProperty(ll,"passive",{get:function(){ld=!0}}),window.addEventListener("test",ll,ll),window.removeEventListener("test",ll,ll)}catch{ld=!1}var Di=null,od=null,qo=null;function gg(){if(qo)return qo;var n,i=od,l=i.length,u,b="value"in Di?Di.value:Di.textContent,v=b.length;for(n=0;n=ul),wg=" ",Eg=!1;function Ng(n,i){switch(n){case"keyup":return $S.indexOf(i.keyCode)!==-1;case"keydown":return i.keyCode!==229;case"keypress":case"mousedown":case"focusout":return!0;default:return!1}}function Sg(n){return n=n.detail,typeof n=="object"&&"data"in n?n.data:null}var as=!1;function PS(n,i){switch(n){case"compositionend":return Sg(i);case"keypress":return i.which!==32?null:(Eg=!0,wg);case"textInput":return n=i.data,n===wg&&Eg?null:n;default:return null}}function FS(n,i){if(as)return n==="compositionend"||!hd&&Ng(n,i)?(n=gg(),qo=od=Di=null,as=!1,n):null;switch(n){case"paste":return null;case"keypress":if(!(i.ctrlKey||i.altKey||i.metaKey)||i.ctrlKey&&i.altKey){if(i.char&&1=i)return{node:l,offset:i-n};n=u}e:{for(;l;){if(l.nextSibling){l=l.nextSibling;break e}l=l.parentNode}l=void 0}l=jg(l)}}function Lg(n,i){return n&&i?n===i?!0:n&&n.nodeType===3?!1:i&&i.nodeType===3?Lg(n,i.parentNode):"contains"in n?n.contains(i):n.compareDocumentPosition?!!(n.compareDocumentPosition(i)&16):!1:!1}function zg(n){n=n!=null&&n.ownerDocument!=null&&n.ownerDocument.defaultView!=null?n.ownerDocument.defaultView:window;for(var i=Mi(n.document);i instanceof n.HTMLIFrameElement;){try{var l=typeof i.contentWindow.location.href=="string"}catch{l=!1}if(l)n=i.contentWindow;else break;i=Mi(n.document)}return i}function gd(n){var i=n&&n.nodeName&&n.nodeName.toLowerCase();return i&&(i==="input"&&(n.type==="text"||n.type==="search"||n.type==="tel"||n.type==="url"||n.type==="password")||i==="textarea"||n.contentEditable==="true")}var WS=ti&&"documentMode"in document&&11>=document.documentMode,ss=null,bd=null,ml=null,xd=!1;function Ig(n,i,l){var u=l.window===l?l.document:l.nodeType===9?l:l.ownerDocument;xd||ss==null||ss!==Mi(u)||(u=ss,"selectionStart"in u&&gd(u)?u={start:u.selectionStart,end:u.selectionEnd}:(u=(u.ownerDocument&&u.ownerDocument.defaultView||window).getSelection(),u={anchorNode:u.anchorNode,anchorOffset:u.anchorOffset,focusNode:u.focusNode,focusOffset:u.focusOffset}),ml&&hl(ml,u)||(ml=u,u=Lc(bd,"onSelect"),0>=A,b-=A,Hr=1<<32-ut(i)+b|l<Ke?(at=je,je=null):at=je.sibling;var mt=oe(ae,je,se[Ke],pe);if(mt===null){je===null&&(je=at);break}n&&je&&mt.alternate===null&&i(ae,je),ie=v(mt,ie,Ke),ht===null?Ie=mt:ht.sibling=mt,ht=mt,je=at}if(Ke===se.length)return l(ae,je),lt&&ri(ae,Ke),Ie;if(je===null){for(;KeKe?(at=je,je=null):at=je.sibling;var na=oe(ae,je,mt.value,pe);if(na===null){je===null&&(je=at);break}n&&je&&na.alternate===null&&i(ae,je),ie=v(na,ie,Ke),ht===null?Ie=na:ht.sibling=na,ht=na,je=at}if(mt.done)return l(ae,je),lt&&ri(ae,Ke),Ie;if(je===null){for(;!mt.done;Ke++,mt=se.next())mt=ge(ae,mt.value,pe),mt!==null&&(ie=v(mt,ie,Ke),ht===null?Ie=mt:ht.sibling=mt,ht=mt);return lt&&ri(ae,Ke),Ie}for(je=u(je);!mt.done;Ke++,mt=se.next())mt=de(je,ae,Ke,mt.value,pe),mt!==null&&(n&&mt.alternate!==null&&je.delete(mt.key===null?Ke:mt.key),ie=v(mt,ie,Ke),ht===null?Ie=mt:ht.sibling=mt,ht=mt);return n&&je.forEach(function(xk){return i(ae,xk)}),lt&&ri(ae,Ke),Ie}function Nt(ae,ie,se,pe){if(typeof se=="object"&&se!==null&&se.type===N&&se.key===null&&(se=se.props.children),typeof se=="object"&&se!==null){switch(se.$$typeof){case x:e:{for(var Ie=se.key;ie!==null;){if(ie.key===Ie){if(Ie=se.type,Ie===N){if(ie.tag===7){l(ae,ie.sibling),pe=b(ie,se.props.children),pe.return=ae,ae=pe;break e}}else if(ie.elementType===Ie||typeof Ie=="object"&&Ie!==null&&Ie.$$typeof===B&&Aa(Ie)===ie.type){l(ae,ie.sibling),pe=b(ie,se.props),vl(pe,se),pe.return=ae,ae=pe;break e}l(ae,ie);break}else i(ae,ie);ie=ie.sibling}se.type===N?(pe=Na(se.props.children,ae.mode,pe,se.key),pe.return=ae,ae=pe):(pe=Wo(se.type,se.key,se.props,null,ae.mode,pe),vl(pe,se),pe.return=ae,ae=pe)}return A(ae);case _:e:{for(Ie=se.key;ie!==null;){if(ie.key===Ie)if(ie.tag===4&&ie.stateNode.containerInfo===se.containerInfo&&ie.stateNode.implementation===se.implementation){l(ae,ie.sibling),pe=b(ie,se.children||[]),pe.return=ae,ae=pe;break e}else{l(ae,ie);break}else i(ae,ie);ie=ie.sibling}pe=Sd(se,ae.mode,pe),pe.return=ae,ae=pe}return A(ae);case B:return se=Aa(se),Nt(ae,ie,se,pe)}if($(se))return Te(ae,ie,se,pe);if(V(se)){if(Ie=V(se),typeof Ie!="function")throw Error(a(150));return se=Ie.call(se),He(ae,ie,se,pe)}if(typeof se.then=="function")return Nt(ae,ie,ac(se),pe);if(se.$$typeof===E)return Nt(ae,ie,tc(ae,se),pe);sc(ae,se)}return typeof se=="string"&&se!==""||typeof se=="number"||typeof se=="bigint"?(se=""+se,ie!==null&&ie.tag===6?(l(ae,ie.sibling),pe=b(ie,se),pe.return=ae,ae=pe):(l(ae,ie),pe=Nd(se,ae.mode,pe),pe.return=ae,ae=pe),A(ae)):l(ae,ie)}return function(ae,ie,se,pe){try{yl=0;var Ie=Nt(ae,ie,se,pe);return bs=null,Ie}catch(je){if(je===gs||je===rc)throw je;var ht=Zn(29,je,null,ae.mode);return ht.lanes=pe,ht.return=ae,ht}finally{}}}var Oa=sb(!0),lb=sb(!1),Ui=!1;function Id(n){n.updateQueue={baseState:n.memoizedState,firstBaseUpdate:null,lastBaseUpdate:null,shared:{pending:null,lanes:0,hiddenCallbacks:null},callbacks:null}}function Bd(n,i){n=n.updateQueue,i.updateQueue===n&&(i.updateQueue={baseState:n.baseState,firstBaseUpdate:n.firstBaseUpdate,lastBaseUpdate:n.lastBaseUpdate,shared:n.shared,callbacks:null})}function Hi(n){return{lane:n,tag:0,payload:null,callback:null,next:null}}function $i(n,i,l){var u=n.updateQueue;if(u===null)return null;if(u=u.shared,(pt&2)!==0){var b=u.pending;return b===null?i.next=i:(i.next=b.next,b.next=i),u.pending=i,i=Qo(n),Fg(n,null,l),i}return Zo(n,u,i,l),Qo(n)}function _l(n,i,l){if(i=i.updateQueue,i!==null&&(i=i.shared,(l&4194048)!==0)){var u=i.lanes;u&=n.pendingLanes,l|=u,i.lanes=l,Ue(n,l)}}function Ud(n,i){var l=n.updateQueue,u=n.alternate;if(u!==null&&(u=u.updateQueue,l===u)){var b=null,v=null;if(l=l.firstBaseUpdate,l!==null){do{var A={lane:l.lane,tag:l.tag,payload:l.payload,callback:null,next:null};v===null?b=v=A:v=v.next=A,l=l.next}while(l!==null);v===null?b=v=i:v=v.next=i}else b=v=i;l={baseState:u.baseState,firstBaseUpdate:b,lastBaseUpdate:v,shared:u.shared,callbacks:u.callbacks},n.updateQueue=l;return}n=l.lastBaseUpdate,n===null?l.firstBaseUpdate=i:n.next=i,l.lastBaseUpdate=i}var Hd=!1;function wl(){if(Hd){var n=ps;if(n!==null)throw n}}function El(n,i,l,u){Hd=!1;var b=n.updateQueue;Ui=!1;var v=b.firstBaseUpdate,A=b.lastBaseUpdate,F=b.shared.pending;if(F!==null){b.shared.pending=null;var ne=F,le=ne.next;ne.next=null,A===null?v=le:A.next=le,A=ne;var he=n.alternate;he!==null&&(he=he.updateQueue,F=he.lastBaseUpdate,F!==A&&(F===null?he.firstBaseUpdate=le:F.next=le,he.lastBaseUpdate=ne))}if(v!==null){var ge=b.baseState;A=0,he=le=ne=null,F=v;do{var oe=F.lane&-536870913,de=oe!==F.lane;if(de?(it&oe)===oe:(u&oe)===oe){oe!==0&&oe===ms&&(Hd=!0),he!==null&&(he=he.next={lane:0,tag:F.tag,payload:F.payload,callback:null,next:null});e:{var Te=n,He=F;oe=i;var Nt=l;switch(He.tag){case 1:if(Te=He.payload,typeof Te=="function"){ge=Te.call(Nt,ge,oe);break e}ge=Te;break e;case 3:Te.flags=Te.flags&-65537|128;case 0:if(Te=He.payload,oe=typeof Te=="function"?Te.call(Nt,ge,oe):Te,oe==null)break e;ge=p({},ge,oe);break e;case 2:Ui=!0}}oe=F.callback,oe!==null&&(n.flags|=64,de&&(n.flags|=8192),de=b.callbacks,de===null?b.callbacks=[oe]:de.push(oe))}else de={lane:oe,tag:F.tag,payload:F.payload,callback:F.callback,next:null},he===null?(le=he=de,ne=ge):he=he.next=de,A|=oe;if(F=F.next,F===null){if(F=b.shared.pending,F===null)break;de=F,F=de.next,de.next=null,b.lastBaseUpdate=de,b.shared.pending=null}}while(!0);he===null&&(ne=ge),b.baseState=ne,b.firstBaseUpdate=le,b.lastBaseUpdate=he,v===null&&(b.shared.lanes=0),Vi|=A,n.lanes=A,n.memoizedState=ge}}function ob(n,i){if(typeof n!="function")throw Error(a(191,n));n.call(i)}function cb(n,i){var l=n.callbacks;if(l!==null)for(n.callbacks=null,n=0;nv?v:8;var A=O.T,F={};O.T=F,sf(n,!1,i,l);try{var ne=b(),le=O.S;if(le!==null&&le(F,ne),ne!==null&&typeof ne=="object"&&typeof ne.then=="function"){var he=l2(ne,u);kl(n,i,he,tr(n))}else kl(n,i,u,tr(n))}catch(ge){kl(n,i,{then:function(){},status:"rejected",reason:ge},tr())}finally{H.p=v,A!==null&&F.types!==null&&(A.types=F.types),O.T=A}}function h2(){}function rf(n,i,l,u){if(n.tag!==5)throw Error(a(476));var b=$b(n).queue;Hb(n,b,i,X,l===null?h2:function(){return qb(n),l(u)})}function $b(n){var i=n.memoizedState;if(i!==null)return i;i={memoizedState:X,baseState:X,baseQueue:null,queue:{pending:null,lanes:0,dispatch:null,lastRenderedReducer:li,lastRenderedState:X},next:null};var l={};return i.next={memoizedState:l,baseState:l,baseQueue:null,queue:{pending:null,lanes:0,dispatch:null,lastRenderedReducer:li,lastRenderedState:l},next:null},n.memoizedState=i,n=n.alternate,n!==null&&(n.memoizedState=i),i}function qb(n){var i=$b(n);i.next===null&&(i=n.alternate.memoizedState),kl(n,i.next.queue,{},tr())}function af(){return yn(Pl)}function Pb(){return Qt().memoizedState}function Fb(){return Qt().memoizedState}function m2(n){for(var i=n.return;i!==null;){switch(i.tag){case 24:case 3:var l=tr();n=Hi(l);var u=$i(i,n,l);u!==null&&(Pn(u,i,l),_l(u,i,l)),i={cache:jd()},n.payload=i;return}i=i.return}}function p2(n,i,l){var u=tr();l={lane:u,revertLane:0,gesture:null,action:l,hasEagerState:!1,eagerState:null,next:null},gc(n)?Vb(i,l):(l=wd(n,i,l,u),l!==null&&(Pn(l,n,u),Yb(l,i,u)))}function Gb(n,i,l){var u=tr();kl(n,i,l,u)}function kl(n,i,l,u){var b={lane:u,revertLane:0,gesture:null,action:l,hasEagerState:!1,eagerState:null,next:null};if(gc(n))Vb(i,b);else{var v=n.alternate;if(n.lanes===0&&(v===null||v.lanes===0)&&(v=i.lastRenderedReducer,v!==null))try{var A=i.lastRenderedState,F=v(A,l);if(b.hasEagerState=!0,b.eagerState=F,Kn(F,A))return Zo(n,i,b,0),kt===null&&Ko(),!1}catch{}finally{}if(l=wd(n,i,b,u),l!==null)return Pn(l,n,u),Yb(l,i,u),!0}return!1}function sf(n,i,l,u){if(u={lane:2,revertLane:Bf(),gesture:null,action:u,hasEagerState:!1,eagerState:null,next:null},gc(n)){if(i)throw Error(a(479))}else i=wd(n,l,u,2),i!==null&&Pn(i,n,2)}function gc(n){var i=n.alternate;return n===Xe||i!==null&&i===Xe}function Vb(n,i){ys=cc=!0;var l=n.pending;l===null?i.next=i:(i.next=l.next,l.next=i),n.pending=i}function Yb(n,i,l){if((l&4194048)!==0){var u=i.lanes;u&=n.pendingLanes,l|=u,i.lanes=l,Ue(n,l)}}var Cl={readContext:yn,use:fc,useCallback:Gt,useContext:Gt,useEffect:Gt,useImperativeHandle:Gt,useLayoutEffect:Gt,useInsertionEffect:Gt,useMemo:Gt,useReducer:Gt,useRef:Gt,useState:Gt,useDebugValue:Gt,useDeferredValue:Gt,useTransition:Gt,useSyncExternalStore:Gt,useId:Gt,useHostTransitionStatus:Gt,useFormState:Gt,useActionState:Gt,useOptimistic:Gt,useMemoCache:Gt,useCacheRefresh:Gt};Cl.useEffectEvent=Gt;var Xb={readContext:yn,use:fc,useCallback:function(n,i){return Dn().memoizedState=[n,i===void 0?null:i],n},useContext:yn,useEffect:Ob,useImperativeHandle:function(n,i,l){l=l!=null?l.concat([n]):null,mc(4194308,4,Lb.bind(null,i,n),l)},useLayoutEffect:function(n,i){return mc(4194308,4,n,i)},useInsertionEffect:function(n,i){mc(4,2,n,i)},useMemo:function(n,i){var l=Dn();i=i===void 0?null:i;var u=n();if(Ra){Wt(!0);try{n()}finally{Wt(!1)}}return l.memoizedState=[u,i],u},useReducer:function(n,i,l){var u=Dn();if(l!==void 0){var b=l(i);if(Ra){Wt(!0);try{l(i)}finally{Wt(!1)}}}else b=i;return u.memoizedState=u.baseState=b,n={pending:null,lanes:0,dispatch:null,lastRenderedReducer:n,lastRenderedState:b},u.queue=n,n=n.dispatch=p2.bind(null,Xe,n),[u.memoizedState,n]},useRef:function(n){var i=Dn();return n={current:n},i.memoizedState=n},useState:function(n){n=Wd(n);var i=n.queue,l=Gb.bind(null,Xe,i);return i.dispatch=l,[n.memoizedState,l]},useDebugValue:tf,useDeferredValue:function(n,i){var l=Dn();return nf(l,n,i)},useTransition:function(){var n=Wd(!1);return n=Hb.bind(null,Xe,n.queue,!0,!1),Dn().memoizedState=n,[!1,n]},useSyncExternalStore:function(n,i,l){var u=Xe,b=Dn();if(lt){if(l===void 0)throw Error(a(407));l=l()}else{if(l=i(),kt===null)throw Error(a(349));(it&127)!==0||pb(u,i,l)}b.memoizedState=l;var v={value:l,getSnapshot:i};return b.queue=v,Ob(bb.bind(null,u,v,n),[n]),u.flags|=2048,_s(9,{destroy:void 0},gb.bind(null,u,v,l,i),null),l},useId:function(){var n=Dn(),i=kt.identifierPrefix;if(lt){var l=$r,u=Hr;l=(u&~(1<<32-ut(u)-1)).toString(32)+l,i="_"+i+"R_"+l,l=uc++,0<\/script>",v=v.removeChild(v.firstChild);break;case"select":v=typeof u.is=="string"?A.createElement("select",{is:u.is}):A.createElement("select"),u.multiple?v.multiple=!0:u.size&&(v.size=u.size);break;default:v=typeof u.is=="string"?A.createElement(b,{is:u.is}):A.createElement(b)}}v[Ut]=i,v[mn]=u;e:for(A=i.child;A!==null;){if(A.tag===5||A.tag===6)v.appendChild(A.stateNode);else if(A.tag!==4&&A.tag!==27&&A.child!==null){A.child.return=A,A=A.child;continue}if(A===i)break e;for(;A.sibling===null;){if(A.return===null||A.return===i)break e;A=A.return}A.sibling.return=A.return,A=A.sibling}i.stateNode=v;e:switch(_n(v,b,u),b){case"button":case"input":case"select":case"textarea":u=!!u.autoFocus;break e;case"img":u=!0;break e;default:u=!1}u&&ci(i)}}return Dt(i),vf(i,i.type,n===null?null:n.memoizedProps,i.pendingProps,l),null;case 6:if(n&&i.stateNode!=null)n.memoizedProps!==u&&ci(i);else{if(typeof u!="string"&&i.stateNode===null)throw Error(a(166));if(n=Q.current,fs(i)){if(n=i.stateNode,l=i.memoizedProps,u=null,b=xn,b!==null)switch(b.tag){case 27:case 5:u=b.memoizedProps}n[Ut]=i,n=!!(n.nodeValue===l||u!==null&&u.suppressHydrationWarning===!0||h0(n.nodeValue,l)),n||Ii(i,!0)}else n=zc(n).createTextNode(u),n[Ut]=i,i.stateNode=n}return Dt(i),null;case 31:if(l=i.memoizedState,n===null||n.memoizedState!==null){if(u=fs(i),l!==null){if(n===null){if(!u)throw Error(a(318));if(n=i.memoizedState,n=n!==null?n.dehydrated:null,!n)throw Error(a(557));n[Ut]=i}else Sa(),(i.flags&128)===0&&(i.memoizedState=null),i.flags|=4;Dt(i),n=!1}else l=Ad(),n!==null&&n.memoizedState!==null&&(n.memoizedState.hydrationErrors=l),n=!0;if(!n)return i.flags&256?(Wn(i),i):(Wn(i),null);if((i.flags&128)!==0)throw Error(a(558))}return Dt(i),null;case 13:if(u=i.memoizedState,n===null||n.memoizedState!==null&&n.memoizedState.dehydrated!==null){if(b=fs(i),u!==null&&u.dehydrated!==null){if(n===null){if(!b)throw Error(a(318));if(b=i.memoizedState,b=b!==null?b.dehydrated:null,!b)throw Error(a(317));b[Ut]=i}else Sa(),(i.flags&128)===0&&(i.memoizedState=null),i.flags|=4;Dt(i),b=!1}else b=Ad(),n!==null&&n.memoizedState!==null&&(n.memoizedState.hydrationErrors=b),b=!0;if(!b)return i.flags&256?(Wn(i),i):(Wn(i),null)}return Wn(i),(i.flags&128)!==0?(i.lanes=l,i):(l=u!==null,n=n!==null&&n.memoizedState!==null,l&&(u=i.child,b=null,u.alternate!==null&&u.alternate.memoizedState!==null&&u.alternate.memoizedState.cachePool!==null&&(b=u.alternate.memoizedState.cachePool.pool),v=null,u.memoizedState!==null&&u.memoizedState.cachePool!==null&&(v=u.memoizedState.cachePool.pool),v!==b&&(u.flags|=2048)),l!==n&&l&&(i.child.flags|=8192),_c(i,i.updateQueue),Dt(i),null);case 4:return te(),n===null&&qf(i.stateNode.containerInfo),Dt(i),null;case 10:return ai(i.type),Dt(i),null;case 19:if(Y(Zt),u=i.memoizedState,u===null)return Dt(i),null;if(b=(i.flags&128)!==0,v=u.rendering,v===null)if(b)Al(u,!1);else{if(Vt!==0||n!==null&&(n.flags&128)!==0)for(n=i.child;n!==null;){if(v=oc(n),v!==null){for(i.flags|=128,Al(u,!1),n=v.updateQueue,i.updateQueue=n,_c(i,n),i.subtreeFlags=0,n=l,l=i.child;l!==null;)Gg(l,n),l=l.sibling;return L(Zt,Zt.current&1|2),lt&&ri(i,u.treeForkCount),i.child}n=n.sibling}u.tail!==null&&ct()>kc&&(i.flags|=128,b=!0,Al(u,!1),i.lanes=4194304)}else{if(!b)if(n=oc(v),n!==null){if(i.flags|=128,b=!0,n=n.updateQueue,i.updateQueue=n,_c(i,n),Al(u,!0),u.tail===null&&u.tailMode==="hidden"&&!v.alternate&&!lt)return Dt(i),null}else 2*ct()-u.renderingStartTime>kc&&l!==536870912&&(i.flags|=128,b=!0,Al(u,!1),i.lanes=4194304);u.isBackwards?(v.sibling=i.child,i.child=v):(n=u.last,n!==null?n.sibling=v:i.child=v,u.last=v)}return u.tail!==null?(n=u.tail,u.rendering=n,u.tail=n.sibling,u.renderingStartTime=ct(),n.sibling=null,l=Zt.current,L(Zt,b?l&1|2:l&1),lt&&ri(i,u.treeForkCount),n):(Dt(i),null);case 22:case 23:return Wn(i),qd(),u=i.memoizedState!==null,n!==null?n.memoizedState!==null!==u&&(i.flags|=8192):u&&(i.flags|=8192),u?(l&536870912)!==0&&(i.flags&128)===0&&(Dt(i),i.subtreeFlags&6&&(i.flags|=8192)):Dt(i),l=i.updateQueue,l!==null&&_c(i,l.retryQueue),l=null,n!==null&&n.memoizedState!==null&&n.memoizedState.cachePool!==null&&(l=n.memoizedState.cachePool.pool),u=null,i.memoizedState!==null&&i.memoizedState.cachePool!==null&&(u=i.memoizedState.cachePool.pool),u!==l&&(i.flags|=2048),n!==null&&Y(Ta),null;case 24:return l=null,n!==null&&(l=n.memoizedState.cache),i.memoizedState.cache!==l&&(i.flags|=2048),ai(en),Dt(i),null;case 25:return null;case 30:return null}throw Error(a(156,i.tag))}function v2(n,i){switch(Cd(i),i.tag){case 1:return n=i.flags,n&65536?(i.flags=n&-65537|128,i):null;case 3:return ai(en),te(),n=i.flags,(n&65536)!==0&&(n&128)===0?(i.flags=n&-65537|128,i):null;case 26:case 27:case 5:return fe(i),null;case 31:if(i.memoizedState!==null){if(Wn(i),i.alternate===null)throw Error(a(340));Sa()}return n=i.flags,n&65536?(i.flags=n&-65537|128,i):null;case 13:if(Wn(i),n=i.memoizedState,n!==null&&n.dehydrated!==null){if(i.alternate===null)throw Error(a(340));Sa()}return n=i.flags,n&65536?(i.flags=n&-65537|128,i):null;case 19:return Y(Zt),null;case 4:return te(),null;case 10:return ai(i.type),null;case 22:case 23:return Wn(i),qd(),n!==null&&Y(Ta),n=i.flags,n&65536?(i.flags=n&-65537|128,i):null;case 24:return ai(en),null;case 25:return null;default:return null}}function xx(n,i){switch(Cd(i),i.tag){case 3:ai(en),te();break;case 26:case 27:case 5:fe(i);break;case 4:te();break;case 31:i.memoizedState!==null&&Wn(i);break;case 13:Wn(i);break;case 19:Y(Zt);break;case 10:ai(i.type);break;case 22:case 23:Wn(i),qd(),n!==null&&Y(Ta);break;case 24:ai(en)}}function Ml(n,i){try{var l=i.updateQueue,u=l!==null?l.lastEffect:null;if(u!==null){var b=u.next;l=b;do{if((l.tag&n)===n){u=void 0;var v=l.create,A=l.inst;u=v(),A.destroy=u}l=l.next}while(l!==b)}}catch(F){yt(i,i.return,F)}}function Fi(n,i,l){try{var u=i.updateQueue,b=u!==null?u.lastEffect:null;if(b!==null){var v=b.next;u=v;do{if((u.tag&n)===n){var A=u.inst,F=A.destroy;if(F!==void 0){A.destroy=void 0,b=i;var ne=l,le=F;try{le()}catch(he){yt(b,ne,he)}}}u=u.next}while(u!==v)}}catch(he){yt(i,i.return,he)}}function yx(n){var i=n.updateQueue;if(i!==null){var l=n.stateNode;try{cb(i,l)}catch(u){yt(n,n.return,u)}}}function vx(n,i,l){l.props=ja(n.type,n.memoizedProps),l.state=n.memoizedState;try{l.componentWillUnmount()}catch(u){yt(n,i,u)}}function Ol(n,i){try{var l=n.ref;if(l!==null){switch(n.tag){case 26:case 27:case 5:var u=n.stateNode;break;case 30:u=n.stateNode;break;default:u=n.stateNode}typeof l=="function"?n.refCleanup=l(u):l.current=u}}catch(b){yt(n,i,b)}}function qr(n,i){var l=n.ref,u=n.refCleanup;if(l!==null)if(typeof u=="function")try{u()}catch(b){yt(n,i,b)}finally{n.refCleanup=null,n=n.alternate,n!=null&&(n.refCleanup=null)}else if(typeof l=="function")try{l(null)}catch(b){yt(n,i,b)}else l.current=null}function _x(n){var i=n.type,l=n.memoizedProps,u=n.stateNode;try{e:switch(i){case"button":case"input":case"select":case"textarea":l.autoFocus&&u.focus();break e;case"img":l.src?u.src=l.src:l.srcSet&&(u.srcset=l.srcSet)}}catch(b){yt(n,n.return,b)}}function _f(n,i,l){try{var u=n.stateNode;q2(u,n.type,l,i),u[mn]=i}catch(b){yt(n,n.return,b)}}function wx(n){return n.tag===5||n.tag===3||n.tag===26||n.tag===27&&Qi(n.type)||n.tag===4}function wf(n){e:for(;;){for(;n.sibling===null;){if(n.return===null||wx(n.return))return null;n=n.return}for(n.sibling.return=n.return,n=n.sibling;n.tag!==5&&n.tag!==6&&n.tag!==18;){if(n.tag===27&&Qi(n.type)||n.flags&2||n.child===null||n.tag===4)continue e;n.child.return=n,n=n.child}if(!(n.flags&2))return n.stateNode}}function Ef(n,i,l){var u=n.tag;if(u===5||u===6)n=n.stateNode,i?(l.nodeType===9?l.body:l.nodeName==="HTML"?l.ownerDocument.body:l).insertBefore(n,i):(i=l.nodeType===9?l.body:l.nodeName==="HTML"?l.ownerDocument.body:l,i.appendChild(n),l=l._reactRootContainer,l!=null||i.onclick!==null||(i.onclick=_e));else if(u!==4&&(u===27&&Qi(n.type)&&(l=n.stateNode,i=null),n=n.child,n!==null))for(Ef(n,i,l),n=n.sibling;n!==null;)Ef(n,i,l),n=n.sibling}function wc(n,i,l){var u=n.tag;if(u===5||u===6)n=n.stateNode,i?l.insertBefore(n,i):l.appendChild(n);else if(u!==4&&(u===27&&Qi(n.type)&&(l=n.stateNode),n=n.child,n!==null))for(wc(n,i,l),n=n.sibling;n!==null;)wc(n,i,l),n=n.sibling}function Ex(n){var i=n.stateNode,l=n.memoizedProps;try{for(var u=n.type,b=i.attributes;b.length;)i.removeAttributeNode(b[0]);_n(i,u,l),i[Ut]=n,i[mn]=l}catch(v){yt(n,n.return,v)}}var ui=!1,rn=!1,Nf=!1,Nx=typeof WeakSet=="function"?WeakSet:Set,gn=null;function _2(n,i){if(n=n.containerInfo,Gf=Pc,n=zg(n),gd(n)){if("selectionStart"in n)var l={start:n.selectionStart,end:n.selectionEnd};else e:{l=(l=n.ownerDocument)&&l.defaultView||window;var u=l.getSelection&&l.getSelection();if(u&&u.rangeCount!==0){l=u.anchorNode;var b=u.anchorOffset,v=u.focusNode;u=u.focusOffset;try{l.nodeType,v.nodeType}catch{l=null;break e}var A=0,F=-1,ne=-1,le=0,he=0,ge=n,oe=null;t:for(;;){for(var de;ge!==l||b!==0&&ge.nodeType!==3||(F=A+b),ge!==v||u!==0&&ge.nodeType!==3||(ne=A+u),ge.nodeType===3&&(A+=ge.nodeValue.length),(de=ge.firstChild)!==null;)oe=ge,ge=de;for(;;){if(ge===n)break t;if(oe===l&&++le===b&&(F=A),oe===v&&++he===u&&(ne=A),(de=ge.nextSibling)!==null)break;ge=oe,oe=ge.parentNode}ge=de}l=F===-1||ne===-1?null:{start:F,end:ne}}else l=null}l=l||{start:0,end:0}}else l=null;for(Vf={focusedElem:n,selectionRange:l},Pc=!1,gn=i;gn!==null;)if(i=gn,n=i.child,(i.subtreeFlags&1028)!==0&&n!==null)n.return=i,gn=n;else for(;gn!==null;){switch(i=gn,v=i.alternate,n=i.flags,i.tag){case 0:if((n&4)!==0&&(n=i.updateQueue,n=n!==null?n.events:null,n!==null))for(l=0;l title"))),_n(v,u,l),v[Ut]=n,Ft(v),u=v;break e;case"link":var A=M0("link","href",b).get(u+(l.href||""));if(A){for(var F=0;FNt&&(A=Nt,Nt=He,He=A);var ae=Dg(F,He),ie=Dg(F,Nt);if(ae&&ie&&(de.rangeCount!==1||de.anchorNode!==ae.node||de.anchorOffset!==ae.offset||de.focusNode!==ie.node||de.focusOffset!==ie.offset)){var se=ge.createRange();se.setStart(ae.node,ae.offset),de.removeAllRanges(),He>Nt?(de.addRange(se),de.extend(ie.node,ie.offset)):(se.setEnd(ie.node,ie.offset),de.addRange(se))}}}}for(ge=[],de=F;de=de.parentNode;)de.nodeType===1&&ge.push({element:de,left:de.scrollLeft,top:de.scrollTop});for(typeof F.focus=="function"&&F.focus(),F=0;Fl?32:l,O.T=null,l=Of,Of=null;var v=Xi,A=pi;if(dn=0,ks=Xi=null,pi=0,(pt&6)!==0)throw Error(a(331));var F=pt;if(pt|=4,Lx(v.current),Rx(v,v.current,A,l),pt=F,Il(0,!1),At&&typeof At.onPostCommitFiberRoot=="function")try{At.onPostCommitFiberRoot(Kt,v)}catch{}return!0}finally{H.p=b,O.T=u,Jx(n,i)}}function t0(n,i,l){i=ur(l,i),i=uf(n.stateNode,i,2),n=$i(n,i,2),n!==null&&(gt(n,2),Pr(n))}function yt(n,i,l){if(n.tag===3)t0(n,n,l);else for(;i!==null;){if(i.tag===3){t0(i,n,l);break}else if(i.tag===1){var u=i.stateNode;if(typeof i.type.getDerivedStateFromError=="function"||typeof u.componentDidCatch=="function"&&(Yi===null||!Yi.has(u))){n=ur(l,n),l=nx(2),u=$i(i,l,2),u!==null&&(rx(l,u,i,n),gt(u,2),Pr(u));break}}i=i.return}}function Lf(n,i,l){var u=n.pingCache;if(u===null){u=n.pingCache=new N2;var b=new Set;u.set(i,b)}else b=u.get(i),b===void 0&&(b=new Set,u.set(i,b));b.has(l)||(Cf=!0,b.add(l),n=A2.bind(null,n,i,l),i.then(n,n))}function A2(n,i,l){var u=n.pingCache;u!==null&&u.delete(i),n.pingedLanes|=n.suspendedLanes&l,n.warmLanes&=~l,kt===n&&(it&l)===l&&(Vt===4||Vt===3&&(it&62914560)===it&&300>ct()-Sc?(pt&2)===0&&Cs(n,0):Tf|=l,Ss===it&&(Ss=0)),Pr(n)}function n0(n,i){i===0&&(i=Pe()),n=Ea(n,i),n!==null&&(gt(n,i),Pr(n))}function M2(n){var i=n.memoizedState,l=0;i!==null&&(l=i.retryLane),n0(n,l)}function O2(n,i){var l=0;switch(n.tag){case 31:case 13:var u=n.stateNode,b=n.memoizedState;b!==null&&(l=b.retryLane);break;case 19:u=n.stateNode;break;case 22:u=n.stateNode._retryCache;break;default:throw Error(a(314))}u!==null&&u.delete(i),n0(n,l)}function R2(n,i){return Pt(n,i)}var Rc=null,As=null,zf=!1,jc=!1,If=!1,Zi=0;function Pr(n){n!==As&&n.next===null&&(As===null?Rc=As=n:As=As.next=n),jc=!0,zf||(zf=!0,D2())}function Il(n,i){if(!If&&jc){If=!0;do for(var l=!1,u=Rc;u!==null;){if(n!==0){var b=u.pendingLanes;if(b===0)var v=0;else{var A=u.suspendedLanes,F=u.pingedLanes;v=(1<<31-ut(42|n)+1)-1,v&=b&~(A&~F),v=v&201326741?v&201326741|1:v?v|2:0}v!==0&&(l=!0,s0(u,v))}else v=it,v=re(u,u===kt?v:0,u.cancelPendingCommit!==null||u.timeoutHandle!==-1),(v&3)===0||me(u,v)||(l=!0,s0(u,v));u=u.next}while(l);If=!1}}function j2(){r0()}function r0(){jc=zf=!1;var n=0;Zi!==0&&F2()&&(n=Zi);for(var i=ct(),l=null,u=Rc;u!==null;){var b=u.next,v=i0(u,i);v===0?(u.next=null,l===null?Rc=b:l.next=b,b===null&&(As=l)):(l=u,(n!==0||(v&3)!==0)&&(jc=!0)),u=b}dn!==0&&dn!==5||Il(n),Zi!==0&&(Zi=0)}function i0(n,i){for(var l=n.suspendedLanes,u=n.pingedLanes,b=n.expirationTimes,v=n.pendingLanes&-62914561;0F)break;var he=ne.transferSize,ge=ne.initiatorType;he&&m0(ge)&&(ne=ne.responseEnd,A+=he*(ne"u"?null:document;function k0(n,i,l){var u=Ms;if(u&&typeof i=="string"&&i){var b=kn(i);b='link[rel="'+n+'"][href="'+b+'"]',typeof l=="string"&&(b+='[crossorigin="'+l+'"]'),S0.has(b)||(S0.add(b),n={rel:n,crossOrigin:l,href:i},u.querySelector(b)===null&&(i=u.createElement("link"),_n(i,"link",n),Ft(i),u.head.appendChild(i)))}}function J2(n){gi.D(n),k0("dns-prefetch",n,null)}function ek(n,i){gi.C(n,i),k0("preconnect",n,i)}function tk(n,i,l){gi.L(n,i,l);var u=Ms;if(u&&n&&i){var b='link[rel="preload"][as="'+kn(i)+'"]';i==="image"&&l&&l.imageSrcSet?(b+='[imagesrcset="'+kn(l.imageSrcSet)+'"]',typeof l.imageSizes=="string"&&(b+='[imagesizes="'+kn(l.imageSizes)+'"]')):b+='[href="'+kn(n)+'"]';var v=b;switch(i){case"style":v=Os(n);break;case"script":v=Rs(n)}gr.has(v)||(n=p({rel:"preload",href:i==="image"&&l&&l.imageSrcSet?void 0:n,as:i},l),gr.set(v,n),u.querySelector(b)!==null||i==="style"&&u.querySelector($l(v))||i==="script"&&u.querySelector(ql(v))||(i=u.createElement("link"),_n(i,"link",n),Ft(i),u.head.appendChild(i)))}}function nk(n,i){gi.m(n,i);var l=Ms;if(l&&n){var u=i&&typeof i.as=="string"?i.as:"script",b='link[rel="modulepreload"][as="'+kn(u)+'"][href="'+kn(n)+'"]',v=b;switch(u){case"audioworklet":case"paintworklet":case"serviceworker":case"sharedworker":case"worker":case"script":v=Rs(n)}if(!gr.has(v)&&(n=p({rel:"modulepreload",href:n},i),gr.set(v,n),l.querySelector(b)===null)){switch(u){case"audioworklet":case"paintworklet":case"serviceworker":case"sharedworker":case"worker":case"script":if(l.querySelector(ql(v)))return}u=l.createElement("link"),_n(u,"link",n),Ft(u),l.head.appendChild(u)}}}function rk(n,i,l){gi.S(n,i,l);var u=Ms;if(u&&n){var b=Br(u).hoistableStyles,v=Os(n);i=i||"default";var A=b.get(v);if(!A){var F={loading:0,preload:null};if(A=u.querySelector($l(v)))F.loading=5;else{n=p({rel:"stylesheet",href:n,"data-precedence":i},l),(l=gr.get(v))&&Jf(n,l);var ne=A=u.createElement("link");Ft(ne),_n(ne,"link",n),ne._p=new Promise(function(le,he){ne.onload=le,ne.onerror=he}),ne.addEventListener("load",function(){F.loading|=1}),ne.addEventListener("error",function(){F.loading|=2}),F.loading|=4,Bc(A,i,u)}A={type:"stylesheet",instance:A,count:1,state:F},b.set(v,A)}}}function ik(n,i){gi.X(n,i);var l=Ms;if(l&&n){var u=Br(l).hoistableScripts,b=Rs(n),v=u.get(b);v||(v=l.querySelector(ql(b)),v||(n=p({src:n,async:!0},i),(i=gr.get(b))&&eh(n,i),v=l.createElement("script"),Ft(v),_n(v,"link",n),l.head.appendChild(v)),v={type:"script",instance:v,count:1,state:null},u.set(b,v))}}function ak(n,i){gi.M(n,i);var l=Ms;if(l&&n){var u=Br(l).hoistableScripts,b=Rs(n),v=u.get(b);v||(v=l.querySelector(ql(b)),v||(n=p({src:n,async:!0,type:"module"},i),(i=gr.get(b))&&eh(n,i),v=l.createElement("script"),Ft(v),_n(v,"link",n),l.head.appendChild(v)),v={type:"script",instance:v,count:1,state:null},u.set(b,v))}}function C0(n,i,l,u){var b=(b=Q.current)?Ic(b):null;if(!b)throw Error(a(446));switch(n){case"meta":case"title":return null;case"style":return typeof l.precedence=="string"&&typeof l.href=="string"?(i=Os(l.href),l=Br(b).hoistableStyles,u=l.get(i),u||(u={type:"style",instance:null,count:0,state:null},l.set(i,u)),u):{type:"void",instance:null,count:0,state:null};case"link":if(l.rel==="stylesheet"&&typeof l.href=="string"&&typeof l.precedence=="string"){n=Os(l.href);var v=Br(b).hoistableStyles,A=v.get(n);if(A||(b=b.ownerDocument||b,A={type:"stylesheet",instance:null,count:0,state:{loading:0,preload:null}},v.set(n,A),(v=b.querySelector($l(n)))&&!v._p&&(A.instance=v,A.state.loading=5),gr.has(n)||(l={rel:"preload",as:"style",href:l.href,crossOrigin:l.crossOrigin,integrity:l.integrity,media:l.media,hrefLang:l.hrefLang,referrerPolicy:l.referrerPolicy},gr.set(n,l),v||sk(b,n,l,A.state))),i&&u===null)throw Error(a(528,""));return A}if(i&&u!==null)throw Error(a(529,""));return null;case"script":return i=l.async,l=l.src,typeof l=="string"&&i&&typeof i!="function"&&typeof i!="symbol"?(i=Rs(l),l=Br(b).hoistableScripts,u=l.get(i),u||(u={type:"script",instance:null,count:0,state:null},l.set(i,u)),u):{type:"void",instance:null,count:0,state:null};default:throw Error(a(444,n))}}function Os(n){return'href="'+kn(n)+'"'}function $l(n){return'link[rel="stylesheet"]['+n+"]"}function T0(n){return p({},n,{"data-precedence":n.precedence,precedence:null})}function sk(n,i,l,u){n.querySelector('link[rel="preload"][as="style"]['+i+"]")?u.loading=1:(i=n.createElement("link"),u.preload=i,i.addEventListener("load",function(){return u.loading|=1}),i.addEventListener("error",function(){return u.loading|=2}),_n(i,"link",l),Ft(i),n.head.appendChild(i))}function Rs(n){return'[src="'+kn(n)+'"]'}function ql(n){return"script[async]"+n}function A0(n,i,l){if(i.count++,i.instance===null)switch(i.type){case"style":var u=n.querySelector('style[data-href~="'+kn(l.href)+'"]');if(u)return i.instance=u,Ft(u),u;var b=p({},l,{"data-href":l.href,"data-precedence":l.precedence,href:null,precedence:null});return u=(n.ownerDocument||n).createElement("style"),Ft(u),_n(u,"style",b),Bc(u,l.precedence,n),i.instance=u;case"stylesheet":b=Os(l.href);var v=n.querySelector($l(b));if(v)return i.state.loading|=4,i.instance=v,Ft(v),v;u=T0(l),(b=gr.get(b))&&Jf(u,b),v=(n.ownerDocument||n).createElement("link"),Ft(v);var A=v;return A._p=new Promise(function(F,ne){A.onload=F,A.onerror=ne}),_n(v,"link",u),i.state.loading|=4,Bc(v,l.precedence,n),i.instance=v;case"script":return v=Rs(l.src),(b=n.querySelector(ql(v)))?(i.instance=b,Ft(b),b):(u=l,(b=gr.get(v))&&(u=p({},l),eh(u,b)),n=n.ownerDocument||n,b=n.createElement("script"),Ft(b),_n(b,"link",u),n.head.appendChild(b),i.instance=b);case"void":return null;default:throw Error(a(443,i.type))}else i.type==="stylesheet"&&(i.state.loading&4)===0&&(u=i.instance,i.state.loading|=4,Bc(u,l.precedence,n));return i.instance}function Bc(n,i,l){for(var u=l.querySelectorAll('link[rel="stylesheet"][data-precedence],style[data-precedence]'),b=u.length?u[u.length-1]:null,v=b,A=0;A title"):null)}function lk(n,i,l){if(l===1||i.itemProp!=null)return!1;switch(n){case"meta":case"title":return!0;case"style":if(typeof i.precedence!="string"||typeof i.href!="string"||i.href==="")break;return!0;case"link":if(typeof i.rel!="string"||typeof i.href!="string"||i.href===""||i.onLoad||i.onError)break;switch(i.rel){case"stylesheet":return n=i.disabled,typeof i.precedence=="string"&&n==null;default:return!0}case"script":if(i.async&&typeof i.async!="function"&&typeof i.async!="symbol"&&!i.onLoad&&!i.onError&&i.src&&typeof i.src=="string")return!0}return!1}function R0(n){return!(n.type==="stylesheet"&&(n.state.loading&3)===0)}function ok(n,i,l,u){if(l.type==="stylesheet"&&(typeof u.media!="string"||matchMedia(u.media).matches!==!1)&&(l.state.loading&4)===0){if(l.instance===null){var b=Os(u.href),v=i.querySelector($l(b));if(v){i=v._p,i!==null&&typeof i=="object"&&typeof i.then=="function"&&(n.count++,n=Hc.bind(n),i.then(n,n)),l.state.loading|=4,l.instance=v,Ft(v);return}v=i.ownerDocument||i,u=T0(u),(b=gr.get(b))&&Jf(u,b),v=v.createElement("link"),Ft(v);var A=v;A._p=new Promise(function(F,ne){A.onload=F,A.onerror=ne}),_n(v,"link",u),l.instance=v}n.stylesheets===null&&(n.stylesheets=new Map),n.stylesheets.set(l,i),(i=l.state.preload)&&(l.state.loading&3)===0&&(n.count++,l=Hc.bind(n),i.addEventListener("load",l),i.addEventListener("error",l))}}var th=0;function ck(n,i){return n.stylesheets&&n.count===0&&qc(n,n.stylesheets),0th?50:800)+i);return n.unsuspend=l,function(){n.unsuspend=null,clearTimeout(u),clearTimeout(b)}}:null}function Hc(){if(this.count--,this.count===0&&(this.imgCount===0||!this.waitingForImages)){if(this.stylesheets)qc(this,this.stylesheets);else if(this.unsuspend){var n=this.unsuspend;this.unsuspend=null,n()}}}var $c=null;function qc(n,i){n.stylesheets=null,n.unsuspend!==null&&(n.count++,$c=new Map,i.forEach(uk,n),$c=null,Hc.call(n))}function uk(n,i){if(!(i.state.loading&4)){var l=$c.get(n);if(l)var u=l.get(null);else{l=new Map,$c.set(n,l);for(var b=n.querySelectorAll("link[data-precedence],style[data-precedence]"),v=0;v"u"||typeof __REACT_DEVTOOLS_GLOBAL_HOOK__.checkDCE!="function"))try{__REACT_DEVTOOLS_GLOBAL_HOOK__.checkDCE(e)}catch(t){console.error(t)}}return e(),uh.exports=Sk(),uh.exports}var Ck=kk();/** * @license lucide-react v0.563.0 - ISC * * This source code is licensed under the ISC license. @@ -66,7 +66,7 @@ Error generating stack: `+u.message+` * * This source code is licensed under the ISC license. * See the LICENSE file in the root directory of this source tree. - */const ty=e=>{const t=Ak(e);return t.charAt(0).toUpperCase()+t.slice(1)};/** + */const ny=e=>{const t=Ak(e);return t.charAt(0).toUpperCase()+t.slice(1)};/** * @license lucide-react v0.563.0 - ISC * * This source code is licensed under the ISC license. @@ -86,12 +86,12 @@ Error generating stack: `+u.message+` * * This source code is licensed under the ISC license. * See the LICENSE file in the root directory of this source tree. - */const Me=(e,t)=>{const r=ee.forwardRef(({className:a,...s},o)=>ee.createElement(Rk,{ref:o,iconNode:t,className:C_(`lucide-${Tk(ty(e))}`,`lucide-${e}`,a),...s}));return r.displayName=ty(e),r};/** + */const Me=(e,t)=>{const r=ee.forwardRef(({className:a,...s},o)=>ee.createElement(Rk,{ref:o,iconNode:t,className:C_(`lucide-${Tk(ny(e))}`,`lucide-${e}`,a),...s}));return r.displayName=ny(e),r};/** * @license lucide-react v0.563.0 - ISC * * This source code is licensed under the ISC license. * See the LICENSE file in the root directory of this source tree. - */const jk=[["path",{d:"m12 19-7-7 7-7",key:"1l729n"}],["path",{d:"M19 12H5",key:"x3x0zl"}]],bp=Me("arrow-left",jk);/** + */const jk=[["path",{d:"m12 19-7-7 7-7",key:"1l729n"}],["path",{d:"M19 12H5",key:"x3x0zl"}]],xp=Me("arrow-left",jk);/** * @license lucide-react v0.563.0 - ISC * * This source code is licensed under the ISC license. @@ -206,7 +206,7 @@ Error generating stack: `+u.message+` * * This source code is licensed under the ISC license. * See the LICENSE file in the root directory of this source tree. - */const fC=[["path",{d:"M15 3h6v6",key:"1q9fwt"}],["path",{d:"M10 14 21 3",key:"gplh6r"}],["path",{d:"M18 13v6a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h6",key:"a6xqqp"}]],ny=Me("external-link",fC);/** + */const fC=[["path",{d:"M15 3h6v6",key:"1q9fwt"}],["path",{d:"M10 14 21 3",key:"gplh6r"}],["path",{d:"M18 13v6a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h6",key:"a6xqqp"}]],ry=Me("external-link",fC);/** * @license lucide-react v0.563.0 - ISC * * This source code is licensed under the ISC license. @@ -286,12 +286,12 @@ Error generating stack: `+u.message+` * * This source code is licensed under the ISC license. * See the LICENSE file in the root directory of this source tree. - */const UC=[["path",{d:"m22 7-8.991 5.727a2 2 0 0 1-2.009 0L2 7",key:"132q7q"}],["rect",{x:"2",y:"4",width:"20",height:"16",rx:"2",key:"izxlao"}]],xp=Me("mail",UC);/** + */const UC=[["path",{d:"m22 7-8.991 5.727a2 2 0 0 1-2.009 0L2 7",key:"132q7q"}],["rect",{x:"2",y:"4",width:"20",height:"16",rx:"2",key:"izxlao"}]],yp=Me("mail",UC);/** * @license lucide-react v0.563.0 - ISC * * This source code is licensed under the ISC license. * See the LICENSE file in the root directory of this source tree. - */const HC=[["path",{d:"M2.992 16.342a2 2 0 0 1 .094 1.167l-1.065 3.29a1 1 0 0 0 1.236 1.168l3.413-.998a2 2 0 0 1 1.099.092 10 10 0 1 0-4.777-4.719",key:"1sd12s"}]],ry=Me("message-circle",HC);/** + */const HC=[["path",{d:"M2.992 16.342a2 2 0 0 1 .094 1.167l-1.065 3.29a1 1 0 0 0 1.236 1.168l3.413-.998a2 2 0 0 1 1.099.092 10 10 0 1 0-4.777-4.719",key:"1sd12s"}]],mh=Me("message-circle",HC);/** * @license lucide-react v0.563.0 - ISC * * This source code is licensed under the ISC license. @@ -351,7 +351,7 @@ Error generating stack: `+u.message+` * * This source code is licensed under the ISC license. * See the LICENSE file in the root directory of this source tree. - */const oT=[["path",{d:"M11.017 2.814a1 1 0 0 1 1.966 0l1.051 5.558a2 2 0 0 0 1.594 1.594l5.558 1.051a1 1 0 0 1 0 1.966l-5.558 1.051a2 2 0 0 0-1.594 1.594l-1.051 5.558a1 1 0 0 1-1.966 0l-1.051-5.558a2 2 0 0 0-1.594-1.594l-5.558-1.051a1 1 0 0 1 0-1.966l5.558-1.051a2 2 0 0 0 1.594-1.594z",key:"1s2grr"}],["path",{d:"M20 2v4",key:"1rf3ol"}],["path",{d:"M22 4h-4",key:"gwowj6"}],["circle",{cx:"4",cy:"20",r:"2",key:"6kqj1y"}]],Bm=Me("sparkles",oT);/** + */const oT=[["path",{d:"M11.017 2.814a1 1 0 0 1 1.966 0l1.051 5.558a2 2 0 0 0 1.594 1.594l5.558 1.051a1 1 0 0 1 0 1.966l-5.558 1.051a2 2 0 0 0-1.594 1.594l-1.051 5.558a1 1 0 0 1-1.966 0l-1.051-5.558a2 2 0 0 0-1.594-1.594l-5.558-1.051a1 1 0 0 1 0-1.966l5.558-1.051a2 2 0 0 0 1.594-1.594z",key:"1s2grr"}],["path",{d:"M20 2v4",key:"1rf3ol"}],["path",{d:"M22 4h-4",key:"gwowj6"}],["circle",{cx:"4",cy:"20",r:"2",key:"6kqj1y"}]],Um=Me("sparkles",oT);/** * @license lucide-react v0.563.0 - ISC * * This source code is licensed under the ISC license. @@ -386,59 +386,59 @@ Error generating stack: `+u.message+` * * This source code is licensed under the ISC license. * See the LICENSE file in the root directory of this source tree. - */const vT=[["path",{d:"M14.7 6.3a1 1 0 0 0 0 1.4l1.6 1.6a1 1 0 0 0 1.4 0l3.106-3.105c.32-.322.863-.22.983.218a6 6 0 0 1-8.259 7.057l-7.91 7.91a1 1 0 0 1-2.999-3l7.91-7.91a6 6 0 0 1 7.057-8.259c.438.12.54.662.219.984z",key:"1ngwbx"}]],Um=Me("wrench",vT);/** + */const vT=[["path",{d:"M14.7 6.3a1 1 0 0 0 0 1.4l1.6 1.6a1 1 0 0 0 1.4 0l3.106-3.105c.32-.322.863-.22.983.218a6 6 0 0 1-8.259 7.057l-7.91 7.91a1 1 0 0 1-2.999-3l7.91-7.91a6 6 0 0 1 7.057-8.259c.438.12.54.662.219.984z",key:"1ngwbx"}]],Hm=Me("wrench",vT);/** * @license lucide-react v0.563.0 - ISC * * This source code is licensed under the ISC license. * See the LICENSE file in the root directory of this source tree. - */const _T=[["path",{d:"M18 6 6 18",key:"1bl5f8"}],["path",{d:"m6 6 12 12",key:"d8bk6v"}]],yp=Me("x",_T);/** + */const _T=[["path",{d:"M18 6 6 18",key:"1bl5f8"}],["path",{d:"m6 6 12 12",key:"d8bk6v"}]],vp=Me("x",_T);/** * @license lucide-react v0.563.0 - ISC * * This source code is licensed under the ISC license. * See the LICENSE file in the root directory of this source tree. - */const wT=[["path",{d:"M4 14a1 1 0 0 1-.78-1.63l9.9-10.2a.5.5 0 0 1 .86.46l-1.92 6.02A1 1 0 0 0 13 10h7a1 1 0 0 1 .78 1.63l-9.9 10.2a.5.5 0 0 1-.86-.46l1.92-6.02A1 1 0 0 0 11 14z",key:"1xq2db"}]],ET=Me("zap",wT),NT={open:{label:"Open",color:"bg-red-500/10 text-red-400 border-red-500/20",dotColor:"bg-red-500",description:"Newly discovered, awaiting triage"},in_progress:{label:"In Progress",color:"bg-blue-500/10 text-blue-400 border-blue-500/20",dotColor:"bg-blue-500",description:"Someone is working on this"},snoozed:{label:"Snoozed",color:"bg-purple-500/10 text-purple-400 border-purple-500/20",dotColor:"bg-purple-500",description:"Temporarily hidden until a follow-up date"},fixed:{label:"Fixed",color:"bg-emerald-500/10 text-emerald-400 border-emerald-500/20",dotColor:"bg-emerald-500",description:"This vulnerability has been fixed"},ignored:{label:"Ignored",color:"bg-gray-500/10 text-gray-400 border-gray-500/20",dotColor:"bg-gray-500",description:"Acknowledged but accepted"}},ST={trivial:{label:"Trivial",color:"bg-emerald-500/10 text-emerald-400 border-emerald-500/20"},low:{label:"Low",color:"bg-blue-500/10 text-blue-400 border-blue-500/20"},medium:{label:"Medium",color:"bg-yellow-500/10 text-yellow-400 border-yellow-500/20"},high:{label:"High",color:"bg-orange-500/10 text-orange-400 border-orange-500/20"}},U_={critical:"bg-red-500/20 text-red-500 border-red-500/30",high:"bg-orange-500/20 text-orange-500 border-orange-500/30",medium:"bg-yellow-500/20 text-yellow-500 border-yellow-500/30",low:"bg-blue-500/20 text-blue-500 border-blue-500/30"};function Zc(e){return e.original_severity!=null&&e.original_severity!==e.severity}const kT={js:"javascript",ts:"typescript",tsx:"typescript",jsx:"javascript",py:"python",rb:"ruby",go:"go",rs:"rust",java:"java",php:"php",cs:"csharp",cpp:"cpp",c:"c",sh:"bash",bash:"bash",sql:"sql",html:"html",css:"css",json:"json",yaml:"yaml",yml:"yaml",xml:"xml"};function CT(e){var r;if(!e)return null;const t=(r=e.split(".").pop())==null?void 0:r.toLowerCase();return t&&kT[t]||null}function vp(e){switch(e){case"critical":return"bg-red-500";case"high":return"bg-orange-500";case"medium":return"bg-yellow-500";default:return"bg-blue-500"}}async function _p(e){try{await navigator.clipboard.writeText(e)}catch{const t=document.createElement("textarea");t.value=e,t.style.position="absolute",t.style.left="-9999px",document.body.appendChild(t),t.select(),document.execCommand("copy"),document.body.removeChild(t)}}const $u="https://app.strix.ai/api/auth/signup",TT="https://strix.ai/pricing",AT="ref=oss_viewer&utm_source=oss_viewer&utm_medium=local_viewer&utm_campaign=oss_viewer";function fa(e,t){const r=e.includes("?")?"&":"?";return`${e}${r}${AT}&utm_content=${encodeURIComponent(t)}`}function Tr(e,t={}){try{const r={event:e};for(const[s,o]of Object.entries(t))o!==void 0&&(r[s]=o);const a=JSON.stringify(r);typeof navigator<"u"&&navigator.sendBeacon?navigator.sendBeacon("/api/event",a):fetch("/api/event",{method:"POST",body:a,keepalive:!0})}catch{}}function jr(e,t){Tr("cta_clicked",{cta:e,surface:t})}function H_(e){var t,r,a="";if(typeof e=="string"||typeof e=="number")a+=e;else if(typeof e=="object")if(Array.isArray(e)){var s=e.length;for(t=0;t{const r=new Array(e.length+t.length);for(let a=0;a({classGroupId:e,validator:t}),$_=(e=new Map,t=null,r)=>({nextPart:e,validators:t,classGroupId:r}),vu="-",iy=[],jT="arbitrary..",DT=e=>{const t=zT(e),{conflictingClassGroups:r,conflictingClassGroupModifiers:a}=e;return{getClassGroupId:c=>{if(c.startsWith("[")&&c.endsWith("]"))return LT(c);const d=c.split(vu),h=d[0]===""&&d.length>1?1:0;return q_(d,h,t)},getConflictingClassGroupIds:(c,d)=>{if(d){const h=a[c],f=r[c];return h?f?OT(f,h):h:f||iy}return r[c]||iy}}},q_=(e,t,r)=>{if(e.length-t===0)return r.classGroupId;const s=e[t],o=r.nextPart.get(s);if(o){const f=q_(e,t+1,o);if(f)return f}const c=r.validators;if(c===null)return;const d=t===0?e.join(vu):e.slice(t).join(vu),h=c.length;for(let f=0;fe.slice(1,-1).indexOf(":")===-1?void 0:(()=>{const t=e.slice(1,-1),r=t.indexOf(":"),a=t.slice(0,r);return a?jT+a:void 0})(),zT=e=>{const{theme:t,classGroups:r}=e;return IT(r,t)},IT=(e,t)=>{const r=$_();for(const a in e){const s=e[a];wp(s,r,a,t)}return r},wp=(e,t,r,a)=>{const s=e.length;for(let o=0;o{if(typeof e=="string"){UT(e,t,r);return}if(typeof e=="function"){HT(e,t,r,a);return}$T(e,t,r,a)},UT=(e,t,r)=>{const a=e===""?t:P_(t,e);a.classGroupId=r},HT=(e,t,r,a)=>{if(qT(e)){wp(e(a),t,r,a);return}t.validators===null&&(t.validators=[]),t.validators.push(RT(r,e))},$T=(e,t,r,a)=>{const s=Object.entries(e),o=s.length;for(let c=0;c{let r=e;const a=t.split(vu),s=a.length;for(let o=0;o"isThemeGetter"in e&&e.isThemeGetter===!0,PT=e=>{if(e<1)return{get:()=>{},set:()=>{}};let t=0,r=Object.create(null),a=Object.create(null);const s=(o,c)=>{r[o]=c,t++,t>e&&(t=0,a=r,r=Object.create(null))};return{get(o){let c=r[o];if(c!==void 0)return c;if((c=a[o])!==void 0)return s(o,c),c},set(o,c){o in r?r[o]=c:s(o,c)}}},Hm="!",ay=":",FT=[],sy=(e,t,r,a,s)=>({modifiers:e,hasImportantModifier:t,baseClassName:r,maybePostfixModifierPosition:a,isExternal:s}),GT=e=>{const{prefix:t,experimentalParseClassName:r}=e;let a=s=>{const o=[];let c=0,d=0,h=0,f;const m=s.length;for(let N=0;Nh?f-h:void 0;return sy(o,x,y,_)};if(t){const s=t+ay,o=a;a=c=>c.startsWith(s)?o(c.slice(s.length)):sy(FT,!1,c,void 0,!0)}if(r){const s=a;a=o=>r({className:o,parseClassName:s})}return a},VT=e=>{const t=new Map;return e.orderSensitiveModifiers.forEach((r,a)=>{t.set(r,1e6+a)}),r=>{const a=[];let s=[];for(let o=0;o0&&(s.sort(),a.push(...s),s=[]),a.push(c)):s.push(c)}return s.length>0&&(s.sort(),a.push(...s)),a}},YT=e=>({cache:PT(e.cacheSize),parseClassName:GT(e),sortModifiers:VT(e),postfixLookupClassGroupIds:XT(e),...DT(e)}),XT=e=>{const t=Object.create(null),r=e.postfixLookupClassGroups;if(r)for(let a=0;a{const{parseClassName:r,getClassGroupId:a,getConflictingClassGroupIds:s,sortModifiers:o,postfixLookupClassGroupIds:c}=t,d=[],h=e.trim().split(KT);let f="";for(let m=h.length-1;m>=0;m-=1){const p=h[m],{isExternal:y,modifiers:x,hasImportantModifier:_,baseClassName:N,maybePostfixModifierPosition:S}=r(p);if(y){f=p+(f.length>0?" "+f:f);continue}let w=!!S,k;if(w){const $=N.substring(0,S);k=a($);const B=k&&c[k]?a(N):void 0;B&&B!==k&&(k=B,w=!1)}else k=a(N);if(!k){if(!w){f=p+(f.length>0?" "+f:f);continue}if(k=a(N),!k){f=p+(f.length>0?" "+f:f);continue}w=!1}const E=x.length===0?"":x.length===1?x[0]:o(x).join(":"),M=_?E+Hm:E,I=M+k;if(d.indexOf(I)>-1)continue;d.push(I);const R=s(k,w);for(let $=0;$0?" "+f:f)}return f},QT=(...e)=>{let t=0,r,a,s="";for(;t{if(typeof e=="string")return e;let t,r="";for(let a=0;a{let r,a,s,o;const c=h=>{const f=t.reduce((m,p)=>p(m),e());return r=YT(f),a=r.cache.get,s=r.cache.set,o=d,d(h)},d=h=>{const f=a(h);if(f)return f;const m=ZT(h,r);return s(h,m),m};return o=c,(...h)=>o(QT(...h))},JT=[],fn=e=>{const t=r=>r[e]||JT;return t.isThemeGetter=!0,t},G_=/^\[(?:(\w[\w-]*):)?(.+)\]$/i,V_=/^\((?:(\w[\w-]*):)?(.+)\)$/i,eA=/^\d+(?:\.\d+)?\/\d+(?:\.\d+)?$/,tA=/^(\d+(\.\d+)?)?(xs|sm|md|lg|xl)$/,nA=/\d+(%|px|r?em|[sdl]?v([hwib]|min|max)|pt|pc|in|cm|mm|cap|ch|ex|r?lh|cq(w|h|i|b|min|max))|\b(calc|min|max|clamp)\(.+\)|^0$/,rA=/^(rgba?|hsla?|hwb|(ok)?(lab|lch)|color-mix)\(.+\)$/,iA=/^(inset_)?-?((\d+)?\.?(\d+)[a-z]+|0)_-?((\d+)?\.?(\d+)[a-z]+|0)/,aA=/^(url|image|image-set|cross-fade|element|(repeating-)?(linear|radial|conic)-gradient)\(.+\)$/,ra=e=>eA.test(e),We=e=>!!e&&!Number.isNaN(Number(e)),Fr=e=>!!e&&Number.isInteger(Number(e)),mh=e=>e.endsWith("%")&&We(e.slice(0,-1)),bi=e=>tA.test(e),Y_=()=>!0,sA=e=>nA.test(e)&&!rA.test(e),Ep=()=>!1,lA=e=>iA.test(e),oA=e=>aA.test(e),cA=e=>!ke(e)&&!Ce(e),uA=e=>e.startsWith("@container")&&(e[10]==="/"&&e[11]!==void 0||e[11]==="s"&&e[16]!==void 0&&e.startsWith("-size/",10)||e[11]==="n"&&e[18]!==void 0&&e.startsWith("-normal/",10)),dA=e=>ha(e,Z_,Ep),ke=e=>G_.test(e),La=e=>ha(e,Q_,sA),ly=e=>ha(e,yA,We),fA=e=>ha(e,J_,Y_),hA=e=>ha(e,W_,Ep),oy=e=>ha(e,X_,Ep),mA=e=>ha(e,K_,oA),Qc=e=>ha(e,ew,lA),Ce=e=>V_.test(e),Kl=e=>Qa(e,Q_),pA=e=>Qa(e,W_),cy=e=>Qa(e,X_),gA=e=>Qa(e,Z_),bA=e=>Qa(e,K_),Wc=e=>Qa(e,ew,!0),xA=e=>Qa(e,J_,!0),ha=(e,t,r)=>{const a=G_.exec(e);return a?a[1]?t(a[1]):r(a[2]):!1},Qa=(e,t,r=!1)=>{const a=V_.exec(e);return a?a[1]?t(a[1]):r:!1},X_=e=>e==="position"||e==="percentage",K_=e=>e==="image"||e==="url",Z_=e=>e==="length"||e==="size"||e==="bg-size",Q_=e=>e==="length",yA=e=>e==="number",W_=e=>e==="family-name",J_=e=>e==="number"||e==="weight",ew=e=>e==="shadow",vA=()=>{const e=fn("color"),t=fn("font"),r=fn("text"),a=fn("font-weight"),s=fn("tracking"),o=fn("leading"),c=fn("breakpoint"),d=fn("container"),h=fn("spacing"),f=fn("radius"),m=fn("shadow"),p=fn("inset-shadow"),y=fn("text-shadow"),x=fn("drop-shadow"),_=fn("blur"),N=fn("perspective"),S=fn("aspect"),w=fn("ease"),k=fn("animate"),E=()=>["auto","avoid","all","avoid-page","page","left","right","column"],M=()=>["center","top","bottom","left","right","top-left","left-top","top-right","right-top","bottom-right","right-bottom","bottom-left","left-bottom"],I=()=>[...M(),Ce,ke],R=()=>["auto","hidden","clip","visible","scroll"],$=()=>["auto","contain","none"],B=()=>[Ce,ke,h],Z=()=>[ra,"full","auto",...B()],j=()=>[Fr,"none","subgrid",Ce,ke],z=()=>["auto",{span:["full",Fr,Ce,ke]},Fr,Ce,ke],G=()=>[Fr,"auto",Ce,ke],V=()=>["auto","min","max","fr",Ce,ke],T=()=>["start","end","center","between","around","evenly","stretch","baseline","center-safe","end-safe"],U=()=>["start","end","center","stretch","center-safe","end-safe"],O=()=>["auto",...B()],H=()=>[ra,"auto","full","dvw","dvh","lvw","lvh","svw","svh","min","max","fit",...B()],X=()=>[ra,"screen","full","dvw","lvw","svw","min","max","fit",...B()],K=()=>[ra,"screen","full","lh","dvh","lvh","svh","min","max","fit",...B()],C=()=>[e,Ce,ke],D=()=>[...M(),cy,oy,{position:[Ce,ke]}],Y=()=>["no-repeat",{repeat:["","x","y","space","round"]}],L=()=>["auto","cover","contain",gA,dA,{size:[Ce,ke]}],F=()=>[mh,Kl,La],q=()=>["","none","full",f,Ce,ke],Q=()=>["",We,Kl,La],J=()=>["solid","dashed","dotted","double"],W=()=>["normal","multiply","screen","overlay","darken","lighten","color-dodge","color-burn","hard-light","soft-light","difference","exclusion","hue","saturation","color","luminosity"],te=()=>[We,mh,cy,oy],ce=()=>["","none",_,Ce,ke],fe=()=>["none",We,Ce,ke],be=()=>["none",We,Ce,ke],we=()=>[We,Ce,ke],Ne=()=>[ra,"full",...B()];return{cacheSize:500,theme:{animate:["spin","ping","pulse","bounce"],aspect:["video"],blur:[bi],breakpoint:[bi],color:[Y_],container:[bi],"drop-shadow":[bi],ease:["in","out","in-out"],font:[cA],"font-weight":["thin","extralight","light","normal","medium","semibold","bold","extrabold","black"],"inset-shadow":[bi],leading:["none","tight","snug","normal","relaxed","loose"],perspective:["dramatic","near","normal","midrange","distant","none"],radius:[bi],shadow:[bi],spacing:["px",We],text:[bi],"text-shadow":[bi],tracking:["tighter","tight","normal","wide","wider","widest"]},classGroups:{aspect:[{aspect:["auto","square",ra,ke,Ce,S]}],container:["container"],"container-type":[{"@container":["","normal","size",Ce,ke]}],"container-named":[uA],columns:[{columns:[We,ke,Ce,d]}],"break-after":[{"break-after":E()}],"break-before":[{"break-before":E()}],"break-inside":[{"break-inside":["auto","avoid","avoid-page","avoid-column"]}],"box-decoration":[{"box-decoration":["slice","clone"]}],box:[{box:["border","content"]}],display:["block","inline-block","inline","flex","inline-flex","table","inline-table","table-caption","table-cell","table-column","table-column-group","table-footer-group","table-header-group","table-row-group","table-row","flow-root","grid","inline-grid","contents","list-item","hidden"],sr:["sr-only","not-sr-only"],float:[{float:["right","left","none","start","end"]}],clear:[{clear:["left","right","both","none","start","end"]}],isolation:["isolate","isolation-auto"],"object-fit":[{object:["contain","cover","fill","none","scale-down"]}],"object-position":[{object:I()}],overflow:[{overflow:R()}],"overflow-x":[{"overflow-x":R()}],"overflow-y":[{"overflow-y":R()}],overscroll:[{overscroll:$()}],"overscroll-x":[{"overscroll-x":$()}],"overscroll-y":[{"overscroll-y":$()}],position:["static","fixed","absolute","relative","sticky"],inset:[{inset:Z()}],"inset-x":[{"inset-x":Z()}],"inset-y":[{"inset-y":Z()}],start:[{"inset-s":Z(),start:Z()}],end:[{"inset-e":Z(),end:Z()}],"inset-bs":[{"inset-bs":Z()}],"inset-be":[{"inset-be":Z()}],top:[{top:Z()}],right:[{right:Z()}],bottom:[{bottom:Z()}],left:[{left:Z()}],visibility:["visible","invisible","collapse"],z:[{z:[Fr,"auto",Ce,ke]}],basis:[{basis:[ra,"full","auto",d,...B()]}],"flex-direction":[{flex:["row","row-reverse","col","col-reverse"]}],"flex-wrap":[{flex:["nowrap","wrap","wrap-reverse"]}],flex:[{flex:[We,ra,"auto","initial","none",ke]}],grow:[{grow:["",We,Ce,ke]}],shrink:[{shrink:["",We,Ce,ke]}],order:[{order:[Fr,"first","last","none",Ce,ke]}],"grid-cols":[{"grid-cols":j()}],"col-start-end":[{col:z()}],"col-start":[{"col-start":G()}],"col-end":[{"col-end":G()}],"grid-rows":[{"grid-rows":j()}],"row-start-end":[{row:z()}],"row-start":[{"row-start":G()}],"row-end":[{"row-end":G()}],"grid-flow":[{"grid-flow":["row","col","dense","row-dense","col-dense"]}],"auto-cols":[{"auto-cols":V()}],"auto-rows":[{"auto-rows":V()}],gap:[{gap:B()}],"gap-x":[{"gap-x":B()}],"gap-y":[{"gap-y":B()}],"justify-content":[{justify:[...T(),"normal"]}],"justify-items":[{"justify-items":[...U(),"normal"]}],"justify-self":[{"justify-self":["auto",...U()]}],"align-content":[{content:["normal",...T()]}],"align-items":[{items:[...U(),{baseline:["","last"]}]}],"align-self":[{self:["auto",...U(),{baseline:["","last"]}]}],"place-content":[{"place-content":T()}],"place-items":[{"place-items":[...U(),"baseline"]}],"place-self":[{"place-self":["auto",...U()]}],p:[{p:B()}],px:[{px:B()}],py:[{py:B()}],ps:[{ps:B()}],pe:[{pe:B()}],pbs:[{pbs:B()}],pbe:[{pbe:B()}],pt:[{pt:B()}],pr:[{pr:B()}],pb:[{pb:B()}],pl:[{pl:B()}],m:[{m:O()}],mx:[{mx:O()}],my:[{my:O()}],ms:[{ms:O()}],me:[{me:O()}],mbs:[{mbs:O()}],mbe:[{mbe:O()}],mt:[{mt:O()}],mr:[{mr:O()}],mb:[{mb:O()}],ml:[{ml:O()}],"space-x":[{"space-x":B()}],"space-x-reverse":["space-x-reverse"],"space-y":[{"space-y":B()}],"space-y-reverse":["space-y-reverse"],size:[{size:H()}],"inline-size":[{inline:["auto",...X()]}],"min-inline-size":[{"min-inline":["auto",...X()]}],"max-inline-size":[{"max-inline":["none",...X()]}],"block-size":[{block:["auto",...K()]}],"min-block-size":[{"min-block":["auto",...K()]}],"max-block-size":[{"max-block":["none",...K()]}],w:[{w:[d,"screen",...H()]}],"min-w":[{"min-w":[d,"screen","none",...H()]}],"max-w":[{"max-w":[d,"screen","none","prose",{screen:[c]},...H()]}],h:[{h:["screen","lh",...H()]}],"min-h":[{"min-h":["screen","lh","none",...H()]}],"max-h":[{"max-h":["screen","lh",...H()]}],"font-size":[{text:["base",r,Kl,La]}],"font-smoothing":["antialiased","subpixel-antialiased"],"font-style":["italic","not-italic"],"font-weight":[{font:[a,xA,fA]}],"font-stretch":[{"font-stretch":["ultra-condensed","extra-condensed","condensed","semi-condensed","normal","semi-expanded","expanded","extra-expanded","ultra-expanded",mh,ke]}],"font-family":[{font:[pA,hA,t]}],"font-features":[{"font-features":[ke]}],"fvn-normal":["normal-nums"],"fvn-ordinal":["ordinal"],"fvn-slashed-zero":["slashed-zero"],"fvn-figure":["lining-nums","oldstyle-nums"],"fvn-spacing":["proportional-nums","tabular-nums"],"fvn-fraction":["diagonal-fractions","stacked-fractions"],tracking:[{tracking:[s,Ce,ke]}],"line-clamp":[{"line-clamp":[We,"none",Ce,ly]}],leading:[{leading:[o,...B()]}],"list-image":[{"list-image":["none",Ce,ke]}],"list-style-position":[{list:["inside","outside"]}],"list-style-type":[{list:["disc","decimal","none",Ce,ke]}],"text-alignment":[{text:["left","center","right","justify","start","end"]}],"placeholder-color":[{placeholder:C()}],"text-color":[{text:C()}],"text-decoration":["underline","overline","line-through","no-underline"],"text-decoration-style":[{decoration:[...J(),"wavy"]}],"text-decoration-thickness":[{decoration:[We,"from-font","auto",Ce,La]}],"text-decoration-color":[{decoration:C()}],"underline-offset":[{"underline-offset":[We,"auto",Ce,ke]}],"text-transform":["uppercase","lowercase","capitalize","normal-case"],"text-overflow":["truncate","text-ellipsis","text-clip"],"text-wrap":[{text:["wrap","nowrap","balance","pretty"]}],indent:[{indent:B()}],"tab-size":[{tab:[Fr,Ce,ke]}],"vertical-align":[{align:["baseline","top","middle","bottom","text-top","text-bottom","sub","super",Ce,ke]}],whitespace:[{whitespace:["normal","nowrap","pre","pre-line","pre-wrap","break-spaces"]}],break:[{break:["normal","words","all","keep"]}],wrap:[{wrap:["break-word","anywhere","normal"]}],hyphens:[{hyphens:["none","manual","auto"]}],content:[{content:["none",Ce,ke]}],"bg-attachment":[{bg:["fixed","local","scroll"]}],"bg-clip":[{"bg-clip":["border","padding","content","text"]}],"bg-origin":[{"bg-origin":["border","padding","content"]}],"bg-position":[{bg:D()}],"bg-repeat":[{bg:Y()}],"bg-size":[{bg:L()}],"bg-image":[{bg:["none",{linear:[{to:["t","tr","r","br","b","bl","l","tl"]},Fr,Ce,ke],radial:["",Ce,ke],conic:[Fr,Ce,ke]},bA,mA]}],"bg-color":[{bg:C()}],"gradient-from-pos":[{from:F()}],"gradient-via-pos":[{via:F()}],"gradient-to-pos":[{to:F()}],"gradient-from":[{from:C()}],"gradient-via":[{via:C()}],"gradient-to":[{to:C()}],rounded:[{rounded:q()}],"rounded-s":[{"rounded-s":q()}],"rounded-e":[{"rounded-e":q()}],"rounded-t":[{"rounded-t":q()}],"rounded-r":[{"rounded-r":q()}],"rounded-b":[{"rounded-b":q()}],"rounded-l":[{"rounded-l":q()}],"rounded-ss":[{"rounded-ss":q()}],"rounded-se":[{"rounded-se":q()}],"rounded-ee":[{"rounded-ee":q()}],"rounded-es":[{"rounded-es":q()}],"rounded-tl":[{"rounded-tl":q()}],"rounded-tr":[{"rounded-tr":q()}],"rounded-br":[{"rounded-br":q()}],"rounded-bl":[{"rounded-bl":q()}],"border-w":[{border:Q()}],"border-w-x":[{"border-x":Q()}],"border-w-y":[{"border-y":Q()}],"border-w-s":[{"border-s":Q()}],"border-w-e":[{"border-e":Q()}],"border-w-bs":[{"border-bs":Q()}],"border-w-be":[{"border-be":Q()}],"border-w-t":[{"border-t":Q()}],"border-w-r":[{"border-r":Q()}],"border-w-b":[{"border-b":Q()}],"border-w-l":[{"border-l":Q()}],"divide-x":[{"divide-x":Q()}],"divide-x-reverse":["divide-x-reverse"],"divide-y":[{"divide-y":Q()}],"divide-y-reverse":["divide-y-reverse"],"border-style":[{border:[...J(),"hidden","none"]}],"divide-style":[{divide:[...J(),"hidden","none"]}],"border-color":[{border:C()}],"border-color-x":[{"border-x":C()}],"border-color-y":[{"border-y":C()}],"border-color-s":[{"border-s":C()}],"border-color-e":[{"border-e":C()}],"border-color-bs":[{"border-bs":C()}],"border-color-be":[{"border-be":C()}],"border-color-t":[{"border-t":C()}],"border-color-r":[{"border-r":C()}],"border-color-b":[{"border-b":C()}],"border-color-l":[{"border-l":C()}],"divide-color":[{divide:C()}],"outline-style":[{outline:[...J(),"none","hidden"]}],"outline-offset":[{"outline-offset":[We,Ce,ke]}],"outline-w":[{outline:["",We,Kl,La]}],"outline-color":[{outline:C()}],shadow:[{shadow:["","none",m,Wc,Qc]}],"shadow-color":[{shadow:C()}],"inset-shadow":[{"inset-shadow":["none",p,Wc,Qc]}],"inset-shadow-color":[{"inset-shadow":C()}],"ring-w":[{ring:Q()}],"ring-w-inset":["ring-inset"],"ring-color":[{ring:C()}],"ring-offset-w":[{"ring-offset":[We,La]}],"ring-offset-color":[{"ring-offset":C()}],"inset-ring-w":[{"inset-ring":Q()}],"inset-ring-color":[{"inset-ring":C()}],"text-shadow":[{"text-shadow":["none",y,Wc,Qc]}],"text-shadow-color":[{"text-shadow":C()}],opacity:[{opacity:[We,Ce,ke]}],"mix-blend":[{"mix-blend":[...W(),"plus-darker","plus-lighter"]}],"bg-blend":[{"bg-blend":W()}],"mask-clip":[{"mask-clip":["border","padding","content","fill","stroke","view"]},"mask-no-clip"],"mask-composite":[{mask:["add","subtract","intersect","exclude"]}],"mask-image-linear-pos":[{"mask-linear":[We]}],"mask-image-linear-from-pos":[{"mask-linear-from":te()}],"mask-image-linear-to-pos":[{"mask-linear-to":te()}],"mask-image-linear-from-color":[{"mask-linear-from":C()}],"mask-image-linear-to-color":[{"mask-linear-to":C()}],"mask-image-t-from-pos":[{"mask-t-from":te()}],"mask-image-t-to-pos":[{"mask-t-to":te()}],"mask-image-t-from-color":[{"mask-t-from":C()}],"mask-image-t-to-color":[{"mask-t-to":C()}],"mask-image-r-from-pos":[{"mask-r-from":te()}],"mask-image-r-to-pos":[{"mask-r-to":te()}],"mask-image-r-from-color":[{"mask-r-from":C()}],"mask-image-r-to-color":[{"mask-r-to":C()}],"mask-image-b-from-pos":[{"mask-b-from":te()}],"mask-image-b-to-pos":[{"mask-b-to":te()}],"mask-image-b-from-color":[{"mask-b-from":C()}],"mask-image-b-to-color":[{"mask-b-to":C()}],"mask-image-l-from-pos":[{"mask-l-from":te()}],"mask-image-l-to-pos":[{"mask-l-to":te()}],"mask-image-l-from-color":[{"mask-l-from":C()}],"mask-image-l-to-color":[{"mask-l-to":C()}],"mask-image-x-from-pos":[{"mask-x-from":te()}],"mask-image-x-to-pos":[{"mask-x-to":te()}],"mask-image-x-from-color":[{"mask-x-from":C()}],"mask-image-x-to-color":[{"mask-x-to":C()}],"mask-image-y-from-pos":[{"mask-y-from":te()}],"mask-image-y-to-pos":[{"mask-y-to":te()}],"mask-image-y-from-color":[{"mask-y-from":C()}],"mask-image-y-to-color":[{"mask-y-to":C()}],"mask-image-radial":[{"mask-radial":[Ce,ke]}],"mask-image-radial-from-pos":[{"mask-radial-from":te()}],"mask-image-radial-to-pos":[{"mask-radial-to":te()}],"mask-image-radial-from-color":[{"mask-radial-from":C()}],"mask-image-radial-to-color":[{"mask-radial-to":C()}],"mask-image-radial-shape":[{"mask-radial":["circle","ellipse"]}],"mask-image-radial-size":[{"mask-radial":[{closest:["side","corner"],farthest:["side","corner"]}]}],"mask-image-radial-pos":[{"mask-radial-at":M()}],"mask-image-conic-pos":[{"mask-conic":[We]}],"mask-image-conic-from-pos":[{"mask-conic-from":te()}],"mask-image-conic-to-pos":[{"mask-conic-to":te()}],"mask-image-conic-from-color":[{"mask-conic-from":C()}],"mask-image-conic-to-color":[{"mask-conic-to":C()}],"mask-mode":[{mask:["alpha","luminance","match"]}],"mask-origin":[{"mask-origin":["border","padding","content","fill","stroke","view"]}],"mask-position":[{mask:D()}],"mask-repeat":[{mask:Y()}],"mask-size":[{mask:L()}],"mask-type":[{"mask-type":["alpha","luminance"]}],"mask-image":[{mask:["none",Ce,ke]}],filter:[{filter:["","none",Ce,ke]}],blur:[{blur:ce()}],brightness:[{brightness:[We,Ce,ke]}],contrast:[{contrast:[We,Ce,ke]}],"drop-shadow":[{"drop-shadow":["","none",x,Wc,Qc]}],"drop-shadow-color":[{"drop-shadow":C()}],grayscale:[{grayscale:["",We,Ce,ke]}],"hue-rotate":[{"hue-rotate":[We,Ce,ke]}],invert:[{invert:["",We,Ce,ke]}],saturate:[{saturate:[We,Ce,ke]}],sepia:[{sepia:["",We,Ce,ke]}],"backdrop-filter":[{"backdrop-filter":["","none",Ce,ke]}],"backdrop-blur":[{"backdrop-blur":ce()}],"backdrop-brightness":[{"backdrop-brightness":[We,Ce,ke]}],"backdrop-contrast":[{"backdrop-contrast":[We,Ce,ke]}],"backdrop-grayscale":[{"backdrop-grayscale":["",We,Ce,ke]}],"backdrop-hue-rotate":[{"backdrop-hue-rotate":[We,Ce,ke]}],"backdrop-invert":[{"backdrop-invert":["",We,Ce,ke]}],"backdrop-opacity":[{"backdrop-opacity":[We,Ce,ke]}],"backdrop-saturate":[{"backdrop-saturate":[We,Ce,ke]}],"backdrop-sepia":[{"backdrop-sepia":["",We,Ce,ke]}],"border-collapse":[{border:["collapse","separate"]}],"border-spacing":[{"border-spacing":B()}],"border-spacing-x":[{"border-spacing-x":B()}],"border-spacing-y":[{"border-spacing-y":B()}],"table-layout":[{table:["auto","fixed"]}],caption:[{caption:["top","bottom"]}],transition:[{transition:["","all","colors","opacity","shadow","transform","none",Ce,ke]}],"transition-behavior":[{transition:["normal","discrete"]}],duration:[{duration:[We,"initial",Ce,ke]}],ease:[{ease:["linear","initial",w,Ce,ke]}],delay:[{delay:[We,Ce,ke]}],animate:[{animate:["none",k,Ce,ke]}],backface:[{backface:["hidden","visible"]}],perspective:[{perspective:[N,Ce,ke]}],"perspective-origin":[{"perspective-origin":I()}],rotate:[{rotate:fe()}],"rotate-x":[{"rotate-x":fe()}],"rotate-y":[{"rotate-y":fe()}],"rotate-z":[{"rotate-z":fe()}],scale:[{scale:be()}],"scale-x":[{"scale-x":be()}],"scale-y":[{"scale-y":be()}],"scale-z":[{"scale-z":be()}],"scale-3d":["scale-3d"],skew:[{skew:we()}],"skew-x":[{"skew-x":we()}],"skew-y":[{"skew-y":we()}],transform:[{transform:[Ce,ke,"","none","gpu","cpu"]}],"transform-origin":[{origin:I()}],"transform-style":[{transform:["3d","flat"]}],translate:[{translate:Ne()}],"translate-x":[{"translate-x":Ne()}],"translate-y":[{"translate-y":Ne()}],"translate-z":[{"translate-z":Ne()}],"translate-none":["translate-none"],zoom:[{zoom:[Fr,Ce,ke]}],accent:[{accent:C()}],appearance:[{appearance:["none","auto"]}],"caret-color":[{caret:C()}],"color-scheme":[{scheme:["normal","dark","light","light-dark","only-dark","only-light"]}],cursor:[{cursor:["auto","default","pointer","wait","text","move","help","not-allowed","none","context-menu","progress","cell","crosshair","vertical-text","alias","copy","no-drop","grab","grabbing","all-scroll","col-resize","row-resize","n-resize","e-resize","s-resize","w-resize","ne-resize","nw-resize","se-resize","sw-resize","ew-resize","ns-resize","nesw-resize","nwse-resize","zoom-in","zoom-out",Ce,ke]}],"field-sizing":[{"field-sizing":["fixed","content"]}],"pointer-events":[{"pointer-events":["auto","none"]}],resize:[{resize:["none","","y","x"]}],"scroll-behavior":[{scroll:["auto","smooth"]}],"scrollbar-thumb-color":[{"scrollbar-thumb":C()}],"scrollbar-track-color":[{"scrollbar-track":C()}],"scrollbar-gutter":[{"scrollbar-gutter":["auto","stable","both"]}],"scrollbar-w":[{scrollbar:["auto","thin","none"]}],"scroll-m":[{"scroll-m":B()}],"scroll-mx":[{"scroll-mx":B()}],"scroll-my":[{"scroll-my":B()}],"scroll-ms":[{"scroll-ms":B()}],"scroll-me":[{"scroll-me":B()}],"scroll-mbs":[{"scroll-mbs":B()}],"scroll-mbe":[{"scroll-mbe":B()}],"scroll-mt":[{"scroll-mt":B()}],"scroll-mr":[{"scroll-mr":B()}],"scroll-mb":[{"scroll-mb":B()}],"scroll-ml":[{"scroll-ml":B()}],"scroll-p":[{"scroll-p":B()}],"scroll-px":[{"scroll-px":B()}],"scroll-py":[{"scroll-py":B()}],"scroll-ps":[{"scroll-ps":B()}],"scroll-pe":[{"scroll-pe":B()}],"scroll-pbs":[{"scroll-pbs":B()}],"scroll-pbe":[{"scroll-pbe":B()}],"scroll-pt":[{"scroll-pt":B()}],"scroll-pr":[{"scroll-pr":B()}],"scroll-pb":[{"scroll-pb":B()}],"scroll-pl":[{"scroll-pl":B()}],"snap-align":[{snap:["start","end","center","align-none"]}],"snap-stop":[{snap:["normal","always"]}],"snap-type":[{snap:["none","x","y","both"]}],"snap-strictness":[{snap:["mandatory","proximity"]}],touch:[{touch:["auto","none","manipulation"]}],"touch-x":[{"touch-pan":["x","left","right"]}],"touch-y":[{"touch-pan":["y","up","down"]}],"touch-pz":["touch-pinch-zoom"],select:[{select:["none","text","all","auto"]}],"will-change":[{"will-change":["auto","scroll","contents","transform",Ce,ke]}],fill:[{fill:["none",...C()]}],"stroke-w":[{stroke:[We,Kl,La,ly]}],stroke:[{stroke:["none",...C()]}],"forced-color-adjust":[{"forced-color-adjust":["auto","none"]}]},conflictingClassGroups:{"container-named":["container-type"],overflow:["overflow-x","overflow-y"],overscroll:["overscroll-x","overscroll-y"],inset:["inset-x","inset-y","inset-bs","inset-be","start","end","top","right","bottom","left"],"inset-x":["right","left"],"inset-y":["top","bottom"],flex:["basis","grow","shrink"],gap:["gap-x","gap-y"],p:["px","py","ps","pe","pbs","pbe","pt","pr","pb","pl"],px:["pr","pl"],py:["pt","pb"],m:["mx","my","ms","me","mbs","mbe","mt","mr","mb","ml"],mx:["mr","ml"],my:["mt","mb"],size:["w","h"],"font-size":["leading"],"fvn-normal":["fvn-ordinal","fvn-slashed-zero","fvn-figure","fvn-spacing","fvn-fraction"],"fvn-ordinal":["fvn-normal"],"fvn-slashed-zero":["fvn-normal"],"fvn-figure":["fvn-normal"],"fvn-spacing":["fvn-normal"],"fvn-fraction":["fvn-normal"],"line-clamp":["display","overflow"],rounded:["rounded-s","rounded-e","rounded-t","rounded-r","rounded-b","rounded-l","rounded-ss","rounded-se","rounded-ee","rounded-es","rounded-tl","rounded-tr","rounded-br","rounded-bl"],"rounded-s":["rounded-ss","rounded-es"],"rounded-e":["rounded-se","rounded-ee"],"rounded-t":["rounded-tl","rounded-tr"],"rounded-r":["rounded-tr","rounded-br"],"rounded-b":["rounded-br","rounded-bl"],"rounded-l":["rounded-tl","rounded-bl"],"border-spacing":["border-spacing-x","border-spacing-y"],"border-w":["border-w-x","border-w-y","border-w-s","border-w-e","border-w-bs","border-w-be","border-w-t","border-w-r","border-w-b","border-w-l"],"border-w-x":["border-w-r","border-w-l"],"border-w-y":["border-w-t","border-w-b"],"border-color":["border-color-x","border-color-y","border-color-s","border-color-e","border-color-bs","border-color-be","border-color-t","border-color-r","border-color-b","border-color-l"],"border-color-x":["border-color-r","border-color-l"],"border-color-y":["border-color-t","border-color-b"],translate:["translate-x","translate-y","translate-none"],"translate-none":["translate","translate-x","translate-y","translate-z"],"scroll-m":["scroll-mx","scroll-my","scroll-ms","scroll-me","scroll-mbs","scroll-mbe","scroll-mt","scroll-mr","scroll-mb","scroll-ml"],"scroll-mx":["scroll-mr","scroll-ml"],"scroll-my":["scroll-mt","scroll-mb"],"scroll-p":["scroll-px","scroll-py","scroll-ps","scroll-pe","scroll-pbs","scroll-pbe","scroll-pt","scroll-pr","scroll-pb","scroll-pl"],"scroll-px":["scroll-pr","scroll-pl"],"scroll-py":["scroll-pt","scroll-pb"],touch:["touch-x","touch-y","touch-pz"],"touch-x":["touch"],"touch-y":["touch"],"touch-pz":["touch"]},conflictingClassGroupModifiers:{"font-size":["leading"]},postfixLookupClassGroups:["container-type"],orderSensitiveModifiers:["*","**","after","backdrop","before","details-content","file","first-letter","first-line","marker","placeholder","selection"]}},_A=WT(vA);function Mr(...e){return _A(MT(e))}function wA(e){return new Date(e).toLocaleDateString("en-US",{year:"numeric",month:"short",day:"numeric"})}function $m(e){const t=new Date(e),a=Math.floor((new Date().getTime()-t.getTime())/1e3);return a<60?"just now":a<3600?`${Math.floor(a/60)}m ago`:a<86400?`${Math.floor(a/3600)}h ago`:a<604800?`${Math.floor(a/86400)}d ago`:wA(e)}function EA(e){return`STRIX-${e}`}function Ds(e){return new Intl.NumberFormat("en-US").format(e)}function NA(e,t){const r={};return(e[e.length-1]===""?[...e,""]:e).join((r.padRight?" ":"")+","+(r.padLeft===!1?"":" ")).trim()}const SA=/^[$_\p{ID_Start}][$_\u{200C}\u{200D}\p{ID_Continue}]*$/u,kA=/^[$_\p{ID_Start}][-$_\u{200C}\u{200D}\p{ID_Continue}]*$/u,CA={};function uy(e,t){return(CA.jsx?kA:SA).test(e)}const TA=/[ \t\n\f\r]/g;function AA(e){return typeof e=="object"?e.type==="text"?dy(e.value):!1:dy(e)}function dy(e){return e.replace(TA,"")===""}class Mo{constructor(t,r,a){this.normal=r,this.property=t,a&&(this.space=a)}}Mo.prototype.normal={};Mo.prototype.property={};Mo.prototype.space=void 0;function tw(e,t){const r={},a={};for(const s of e)Object.assign(r,s.property),Object.assign(a,s.normal);return new Mo(r,a,t)}function qm(e){return e.toLowerCase()}class Yn{constructor(t,r){this.attribute=r,this.property=t}}Yn.prototype.attribute="";Yn.prototype.booleanish=!1;Yn.prototype.boolean=!1;Yn.prototype.commaOrSpaceSeparated=!1;Yn.prototype.commaSeparated=!1;Yn.prototype.defined=!1;Yn.prototype.mustUseProperty=!1;Yn.prototype.number=!1;Yn.prototype.overloadedBoolean=!1;Yn.prototype.property="";Yn.prototype.spaceSeparated=!1;Yn.prototype.space=void 0;let MA=0;const Ge=Wa(),an=Wa(),Pm=Wa(),ve=Wa(),Ct=Wa(),qa=Wa(),rr=Wa();function Wa(){return 2**++MA}const Fm=Object.freeze(Object.defineProperty({__proto__:null,boolean:Ge,booleanish:an,commaOrSpaceSeparated:rr,commaSeparated:qa,number:ve,overloadedBoolean:Pm,spaceSeparated:Ct},Symbol.toStringTag,{value:"Module"})),ph=Object.keys(Fm);class Np extends Yn{constructor(t,r,a,s){let o=-1;if(super(t,r),fy(this,"space",s),typeof a=="number")for(;++o4&&r.slice(0,4)==="data"&&LA.test(t)){if(t.charAt(4)==="-"){const o=t.slice(5).replace(hy,BA);a="data"+o.charAt(0).toUpperCase()+o.slice(1)}else{const o=t.slice(4);if(!hy.test(o)){let c=o.replace(DA,IA);c.charAt(0)!=="-"&&(c="-"+c),t="data"+c}}s=Np}return new s(a,t)}function IA(e){return"-"+e.toLowerCase()}function BA(e){return e.charAt(1).toUpperCase()}const UA=tw([nw,OA,aw,sw,lw],"html"),Sp=tw([nw,RA,aw,sw,lw],"svg");function HA(e){return e.join(" ").trim()}var Ls={},gh,my;function $A(){if(my)return gh;my=1;var e=/\/\*[^*]*\*+([^/*][^*]*\*+)*\//g,t=/\n/g,r=/^\s*/,a=/^(\*?[-#/*\\\w]+(\[[0-9a-z_-]+\])?)\s*/,s=/^:\s*/,o=/^((?:'(?:\\'|.)*?'|"(?:\\"|.)*?"|\([^)]*?\)|[^};])+)/,c=/^[;\s]*/,d=/^\s+|\s+$/g,h=` -`,f="/",m="*",p="",y="comment",x="declaration";function _(S,w){if(typeof S!="string")throw new TypeError("First argument must be a string");if(!S)return[];w=w||{};var k=1,E=1;function M(T){var U=T.match(t);U&&(k+=U.length);var O=T.lastIndexOf(h);E=~O?T.length-O:E+T.length}function I(){var T={line:k,column:E};return function(U){return U.position=new R(T),Z(),U}}function R(T){this.start=T,this.end={line:k,column:E},this.source=w.source}R.prototype.content=S;function $(T){var U=new Error(w.source+":"+k+":"+E+": "+T);if(U.reason=T,U.filename=w.source,U.line=k,U.column=E,U.source=S,!w.silent)throw U}function B(T){var U=T.exec(S);if(U){var O=U[0];return M(O),S=S.slice(O.length),U}}function Z(){B(r)}function j(T){var U;for(T=T||[];U=z();)U!==!1&&T.push(U);return T}function z(){var T=I();if(!(f!=S.charAt(0)||m!=S.charAt(1))){for(var U=2;p!=S.charAt(U)&&(m!=S.charAt(U)||f!=S.charAt(U+1));)++U;if(U+=2,p===S.charAt(U-1))return $("End of comment missing");var O=S.slice(2,U-2);return E+=2,M(O),S=S.slice(U),E+=2,T({type:y,comment:O})}}function G(){var T=I(),U=B(a);if(U){if(z(),!B(s))return $("property missing ':'");var O=B(o),H=T({type:x,property:N(U[0].replace(e,p)),value:O?N(O[0].replace(e,p)):p});return B(c),H}}function V(){var T=[];j(T);for(var U;U=G();)U!==!1&&(T.push(U),j(T));return T}return Z(),V()}function N(S){return S?S.replace(d,p):p}return gh=_,gh}var py;function qA(){if(py)return Ls;py=1;var e=Ls&&Ls.__importDefault||function(a){return a&&a.__esModule?a:{default:a}};Object.defineProperty(Ls,"__esModule",{value:!0}),Ls.default=r;const t=e($A());function r(a,s){let o=null;if(!a||typeof a!="string")return o;const c=(0,t.default)(a),d=typeof s=="function";return c.forEach(h=>{if(h.type!=="declaration")return;const{property:f,value:m}=h;d?s(f,m,h):m&&(o=o||{},o[f]=m)}),o}return Ls}var Zl={},gy;function PA(){if(gy)return Zl;gy=1,Object.defineProperty(Zl,"__esModule",{value:!0}),Zl.camelCase=void 0;var e=/^--[a-zA-Z0-9_-]+$/,t=/-([a-z])/g,r=/^[^-]+$/,a=/^-(webkit|moz|ms|o|khtml)-/,s=/^-(ms)-/,o=function(f){return!f||r.test(f)||e.test(f)},c=function(f,m){return m.toUpperCase()},d=function(f,m){return"".concat(m,"-")},h=function(f,m){return m===void 0&&(m={}),o(f)?f:(f=f.toLowerCase(),m.reactCompat?f=f.replace(s,d):f=f.replace(a,d),f.replace(t,c))};return Zl.camelCase=h,Zl}var Ql,by;function FA(){if(by)return Ql;by=1;var e=Ql&&Ql.__importDefault||function(s){return s&&s.__esModule?s:{default:s}},t=e(qA()),r=PA();function a(s,o){var c={};return!s||typeof s!="string"||(0,t.default)(s,function(d,h){d&&h&&(c[(0,r.camelCase)(d,o)]=h)}),c}return a.default=a,Ql=a,Ql}var GA=FA();const VA=Co(GA),ow=cw("end"),kp=cw("start");function cw(e){return t;function t(r){const a=r&&r.position&&r.position[e]||{};if(typeof a.line=="number"&&a.line>0&&typeof a.column=="number"&&a.column>0)return{line:a.line,column:a.column,offset:typeof a.offset=="number"&&a.offset>-1?a.offset:void 0}}}function YA(e){const t=kp(e),r=ow(e);if(t&&r)return{start:t,end:r}}function lo(e){return!e||typeof e!="object"?"":"position"in e||"type"in e?xy(e.position):"start"in e||"end"in e?xy(e):"line"in e||"column"in e?Gm(e):""}function Gm(e){return yy(e&&e.line)+":"+yy(e&&e.column)}function xy(e){return Gm(e&&e.start)+"-"+Gm(e&&e.end)}function yy(e){return e&&typeof e=="number"?e:1}class Mn extends Error{constructor(t,r,a){super(),typeof r=="string"&&(a=r,r=void 0);let s="",o={},c=!1;if(r&&("line"in r&&"column"in r?o={place:r}:"start"in r&&"end"in r?o={place:r}:"type"in r?o={ancestors:[r],place:r.position}:o={...r}),typeof t=="string"?s=t:!o.cause&&t&&(c=!0,s=t.message,o.cause=t),!o.ruleId&&!o.source&&typeof a=="string"){const h=a.indexOf(":");h===-1?o.ruleId=a:(o.source=a.slice(0,h),o.ruleId=a.slice(h+1))}if(!o.place&&o.ancestors&&o.ancestors){const h=o.ancestors[o.ancestors.length-1];h&&(o.place=h.position)}const d=o.place&&"start"in o.place?o.place.start:o.place;this.ancestors=o.ancestors||void 0,this.cause=o.cause||void 0,this.column=d?d.column:void 0,this.fatal=void 0,this.file="",this.message=s,this.line=d?d.line:void 0,this.name=lo(o.place)||"1:1",this.place=o.place||void 0,this.reason=this.message,this.ruleId=o.ruleId||void 0,this.source=o.source||void 0,this.stack=c&&o.cause&&typeof o.cause.stack=="string"?o.cause.stack:"",this.actual=void 0,this.expected=void 0,this.note=void 0,this.url=void 0}}Mn.prototype.file="";Mn.prototype.name="";Mn.prototype.reason="";Mn.prototype.message="";Mn.prototype.stack="";Mn.prototype.column=void 0;Mn.prototype.line=void 0;Mn.prototype.ancestors=void 0;Mn.prototype.cause=void 0;Mn.prototype.fatal=void 0;Mn.prototype.place=void 0;Mn.prototype.ruleId=void 0;Mn.prototype.source=void 0;const Cp={}.hasOwnProperty,XA=new Map,KA=/[A-Z]/g,ZA=new Set(["table","tbody","thead","tfoot","tr"]),QA=new Set(["td","th"]),uw="https://github.com/syntax-tree/hast-util-to-jsx-runtime";function WA(e,t){if(!t||t.Fragment===void 0)throw new TypeError("Expected `Fragment` in options");const r=t.filePath||void 0;let a;if(t.development){if(typeof t.jsxDEV!="function")throw new TypeError("Expected `jsxDEV` in options when `development: true`");a=sM(r,t.jsxDEV)}else{if(typeof t.jsx!="function")throw new TypeError("Expected `jsx` in production options");if(typeof t.jsxs!="function")throw new TypeError("Expected `jsxs` in production options");a=aM(r,t.jsx,t.jsxs)}const s={Fragment:t.Fragment,ancestors:[],components:t.components||{},create:a,elementAttributeNameCase:t.elementAttributeNameCase||"react",evaluater:t.createEvaluater?t.createEvaluater():void 0,filePath:r,ignoreInvalidStyle:t.ignoreInvalidStyle||!1,passKeys:t.passKeys!==!1,passNode:t.passNode||!1,schema:t.space==="svg"?Sp:UA,stylePropertyNameCase:t.stylePropertyNameCase||"dom",tableCellAlignToStyle:t.tableCellAlignToStyle!==!1},o=dw(s,e,void 0);return o&&typeof o!="string"?o:s.create(e,s.Fragment,{children:o||void 0},void 0)}function dw(e,t,r){if(t.type==="element")return JA(e,t,r);if(t.type==="mdxFlowExpression"||t.type==="mdxTextExpression")return eM(e,t);if(t.type==="mdxJsxFlowElement"||t.type==="mdxJsxTextElement")return nM(e,t,r);if(t.type==="mdxjsEsm")return tM(e,t);if(t.type==="root")return rM(e,t,r);if(t.type==="text")return iM(e,t)}function JA(e,t,r){const a=e.schema;let s=a;t.tagName.toLowerCase()==="svg"&&a.space==="html"&&(s=Sp,e.schema=s),e.ancestors.push(t);const o=hw(e,t.tagName,!1),c=lM(e,t);let d=Ap(e,t);return ZA.has(t.tagName)&&(d=d.filter(function(h){return typeof h=="string"?!AA(h):!0})),fw(e,c,o,t),Tp(c,d),e.ancestors.pop(),e.schema=a,e.create(t,o,c,r)}function eM(e,t){if(t.data&&t.data.estree&&e.evaluater){const a=t.data.estree.body[0];return a.type,e.evaluater.evaluateExpression(a.expression)}po(e,t.position)}function tM(e,t){if(t.data&&t.data.estree&&e.evaluater)return e.evaluater.evaluateProgram(t.data.estree);po(e,t.position)}function nM(e,t,r){const a=e.schema;let s=a;t.name==="svg"&&a.space==="html"&&(s=Sp,e.schema=s),e.ancestors.push(t);const o=t.name===null?e.Fragment:hw(e,t.name,!0),c=oM(e,t),d=Ap(e,t);return fw(e,c,o,t),Tp(c,d),e.ancestors.pop(),e.schema=a,e.create(t,o,c,r)}function rM(e,t,r){const a={};return Tp(a,Ap(e,t)),e.create(t,e.Fragment,a,r)}function iM(e,t){return t.value}function fw(e,t,r,a){typeof r!="string"&&r!==e.Fragment&&e.passNode&&(t.node=a)}function Tp(e,t){if(t.length>0){const r=t.length>1?t:t[0];r&&(e.children=r)}}function aM(e,t,r){return a;function a(s,o,c,d){const f=Array.isArray(c.children)?r:t;return d?f(o,c,d):f(o,c)}}function sM(e,t){return r;function r(a,s,o,c){const d=Array.isArray(o.children),h=kp(a);return t(s,o,c,d,{columnNumber:h?h.column-1:void 0,fileName:e,lineNumber:h?h.line:void 0},void 0)}}function lM(e,t){const r={};let a,s;for(s in t.properties)if(s!=="children"&&Cp.call(t.properties,s)){const o=cM(e,s,t.properties[s]);if(o){const[c,d]=o;e.tableCellAlignToStyle&&c==="align"&&typeof d=="string"&&QA.has(t.tagName)?a=d:r[c]=d}}if(a){const o=r.style||(r.style={});o[e.stylePropertyNameCase==="css"?"text-align":"textAlign"]=a}return r}function oM(e,t){const r={};for(const a of t.attributes)if(a.type==="mdxJsxExpressionAttribute")if(a.data&&a.data.estree&&e.evaluater){const o=a.data.estree.body[0];o.type;const c=o.expression;c.type;const d=c.properties[0];d.type,Object.assign(r,e.evaluater.evaluateExpression(d.argument))}else po(e,t.position);else{const s=a.name;let o;if(a.value&&typeof a.value=="object")if(a.value.data&&a.value.data.estree&&e.evaluater){const d=a.value.data.estree.body[0];d.type,o=e.evaluater.evaluateExpression(d.expression)}else po(e,t.position);else o=a.value===null?!0:a.value;r[s]=o}return r}function Ap(e,t){const r=[];let a=-1;const s=e.passKeys?new Map:XA;for(;++as?0:s+t:t=t>s?s:t,r=r>0?r:0,a.length<1e4)c=Array.from(a),c.unshift(t,r),e.splice(...c);else for(r&&e.splice(t,r);o0?(ar(e,e.length,0,t),e):t}const wy={}.hasOwnProperty;function pw(e){const t={};let r=-1;for(;++r13&&r<32||r>126&&r<160||r>55295&&r<57344||r>64975&&r<65008||(r&65535)===65535||(r&65535)===65534||r>1114111?"�":String.fromCodePoint(r)}function Dr(e){return e.replace(/[\t\n\r ]+/g," ").replace(/^ | $/g,"").toLowerCase().toUpperCase()}const Ln=ma(/[A-Za-z]/),Tn=ma(/[\dA-Za-z]/),xM=ma(/[#-'*+\--9=?A-Z^-~]/);function _u(e){return e!==null&&(e<32||e===127)}const Vm=ma(/\d/),yM=ma(/[\dA-Fa-f]/),vM=ma(/[!-/:-@[-`{-~]/);function Be(e){return e!==null&&e<-2}function Tt(e){return e!==null&&(e<0||e===32)}function tt(e){return e===-2||e===-1||e===32}const qu=ma(new RegExp("\\p{P}|\\p{S}","u")),Ga=ma(/\s/);function ma(e){return t;function t(r){return r!==null&&r>-1&&e.test(String.fromCharCode(r))}}function nl(e){const t=[];let r=-1,a=0,s=0;for(;++r55295&&o<57344){const d=e.charCodeAt(r+1);o<56320&&d>56319&&d<57344?(c=String.fromCharCode(o,d),s=1):c="�"}else c=String.fromCharCode(o);c&&(t.push(e.slice(a,r),encodeURIComponent(c)),a=r+s+1,c=""),s&&(r+=s,s=0)}return t.join("")+e.slice(a)}function ot(e,t,r,a){const s=a?a-1:Number.POSITIVE_INFINITY;let o=0;return c;function c(h){return tt(h)?(e.enter(r),d(h)):t(h)}function d(h){return tt(h)&&o++c))return;const $=t.events.length;let B=$,Z,j;for(;B--;)if(t.events[B][0]==="exit"&&t.events[B][1].type==="chunkFlow"){if(Z){j=t.events[B][1].end;break}Z=!0}for(w(a),R=$;RE;){const I=r[M];t.containerState=I[1],I[0].exit.call(t,e)}r.length=E}function k(){s.write([null]),o=void 0,s=void 0,t.containerState._closeFlow=void 0}}function SM(e,t,r){return ot(e,e.attempt(this.parser.constructs.document,t,r),"linePrefix",this.parser.constructs.disable.null.includes("codeIndented")?void 0:4)}function Ys(e){if(e===null||Tt(e)||Ga(e))return 1;if(qu(e))return 2}function Pu(e,t,r){const a=[];let s=-1;for(;++s1&&e[r][1].end.offset-e[r][1].start.offset>1?2:1;const p={...e[a][1].end},y={...e[r][1].start};Ny(p,-h),Ny(y,h),c={type:h>1?"strongSequence":"emphasisSequence",start:p,end:{...e[a][1].end}},d={type:h>1?"strongSequence":"emphasisSequence",start:{...e[r][1].start},end:y},o={type:h>1?"strongText":"emphasisText",start:{...e[a][1].end},end:{...e[r][1].start}},s={type:h>1?"strong":"emphasis",start:{...c.start},end:{...d.end}},e[a][1].end={...c.start},e[r][1].start={...d.end},f=[],e[a][1].end.offset-e[a][1].start.offset&&(f=br(f,[["enter",e[a][1],t],["exit",e[a][1],t]])),f=br(f,[["enter",s,t],["enter",c,t],["exit",c,t],["enter",o,t]]),f=br(f,Pu(t.parser.constructs.insideSpan.null,e.slice(a+1,r),t)),f=br(f,[["exit",o,t],["enter",d,t],["exit",d,t],["exit",s,t]]),e[r][1].end.offset-e[r][1].start.offset?(m=2,f=br(f,[["enter",e[r][1],t],["exit",e[r][1],t]])):m=0,ar(e,a-1,r-a+3,f),r=a+f.length-m-2;break}}for(r=-1;++r0&&tt(R)?ot(e,k,"linePrefix",o+1)(R):k(R)}function k(R){return R===null||Be(R)?e.check(Sy,N,M)(R):(e.enter("codeFlowValue"),E(R))}function E(R){return R===null||Be(R)?(e.exit("codeFlowValue"),k(R)):(e.consume(R),E)}function M(R){return e.exit("codeFenced"),t(R)}function I(R,$,B){let Z=0;return j;function j(U){return R.enter("lineEnding"),R.consume(U),R.exit("lineEnding"),z}function z(U){return R.enter("codeFencedFence"),tt(U)?ot(R,G,"linePrefix",a.parser.constructs.disable.null.includes("codeIndented")?void 0:4)(U):G(U)}function G(U){return U===d?(R.enter("codeFencedFenceSequence"),V(U)):B(U)}function V(U){return U===d?(Z++,R.consume(U),V):Z>=c?(R.exit("codeFencedFenceSequence"),tt(U)?ot(R,T,"whitespace")(U):T(U)):B(U)}function T(U){return U===null||Be(U)?(R.exit("codeFencedFence"),$(U)):B(U)}}}function IM(e,t,r){const a=this;return s;function s(c){return c===null?r(c):(e.enter("lineEnding"),e.consume(c),e.exit("lineEnding"),o)}function o(c){return a.parser.lazy[a.now().line]?r(c):t(c)}}const xh={name:"codeIndented",tokenize:UM},BM={partial:!0,tokenize:HM};function UM(e,t,r){const a=this;return s;function s(f){return e.enter("codeIndented"),ot(e,o,"linePrefix",5)(f)}function o(f){const m=a.events[a.events.length-1];return m&&m[1].type==="linePrefix"&&m[2].sliceSerialize(m[1],!0).length>=4?c(f):r(f)}function c(f){return f===null?h(f):Be(f)?e.attempt(BM,c,h)(f):(e.enter("codeFlowValue"),d(f))}function d(f){return f===null||Be(f)?(e.exit("codeFlowValue"),c(f)):(e.consume(f),d)}function h(f){return e.exit("codeIndented"),t(f)}}function HM(e,t,r){const a=this;return s;function s(c){return a.parser.lazy[a.now().line]?r(c):Be(c)?(e.enter("lineEnding"),e.consume(c),e.exit("lineEnding"),s):ot(e,o,"linePrefix",5)(c)}function o(c){const d=a.events[a.events.length-1];return d&&d[1].type==="linePrefix"&&d[2].sliceSerialize(d[1],!0).length>=4?t(c):Be(c)?s(c):r(c)}}const $M={name:"codeText",previous:PM,resolve:qM,tokenize:FM};function qM(e){let t=e.length-4,r=3,a,s;if((e[r][1].type==="lineEnding"||e[r][1].type==="space")&&(e[t][1].type==="lineEnding"||e[t][1].type==="space")){for(a=r;++a=this.left.length+this.right.length)throw new RangeError("Cannot access index `"+t+"` in a splice buffer of size `"+(this.left.length+this.right.length)+"`");return tthis.left.length?this.right.slice(this.right.length-a+this.left.length,this.right.length-t+this.left.length).reverse():this.left.slice(t).concat(this.right.slice(this.right.length-a+this.left.length).reverse())}splice(t,r,a){const s=r||0;this.setCursor(Math.trunc(t));const o=this.right.splice(this.right.length-s,Number.POSITIVE_INFINITY);return a&&Wl(this.left,a),o.reverse()}pop(){return this.setCursor(Number.POSITIVE_INFINITY),this.left.pop()}push(t){this.setCursor(Number.POSITIVE_INFINITY),this.left.push(t)}pushMany(t){this.setCursor(Number.POSITIVE_INFINITY),Wl(this.left,t)}unshift(t){this.setCursor(0),this.right.push(t)}unshiftMany(t){this.setCursor(0),Wl(this.right,t.reverse())}setCursor(t){if(!(t===this.left.length||t>this.left.length&&this.right.length===0||t<0&&this.left.length===0))if(t=4?t(c):e.interrupt(a.parser.constructs.flow,r,t)(c)}}function _w(e,t,r,a,s,o,c,d,h){const f=h||Number.POSITIVE_INFINITY;let m=0;return p;function p(w){return w===60?(e.enter(a),e.enter(s),e.enter(o),e.consume(w),e.exit(o),y):w===null||w===32||w===41||_u(w)?r(w):(e.enter(a),e.enter(c),e.enter(d),e.enter("chunkString",{contentType:"string"}),N(w))}function y(w){return w===62?(e.enter(o),e.consume(w),e.exit(o),e.exit(s),e.exit(a),t):(e.enter(d),e.enter("chunkString",{contentType:"string"}),x(w))}function x(w){return w===62?(e.exit("chunkString"),e.exit(d),y(w)):w===null||w===60||Be(w)?r(w):(e.consume(w),w===92?_:x)}function _(w){return w===60||w===62||w===92?(e.consume(w),x):x(w)}function N(w){return!m&&(w===null||w===41||Tt(w))?(e.exit("chunkString"),e.exit(d),e.exit(c),e.exit(a),t(w)):m999||x===null||x===91||x===93&&!h||x===94&&!d&&"_hiddenFootnoteSupport"in c.parser.constructs?r(x):x===93?(e.exit(o),e.enter(s),e.consume(x),e.exit(s),e.exit(a),t):Be(x)?(e.enter("lineEnding"),e.consume(x),e.exit("lineEnding"),m):(e.enter("chunkString",{contentType:"string"}),p(x))}function p(x){return x===null||x===91||x===93||Be(x)||d++>999?(e.exit("chunkString"),m(x)):(e.consume(x),h||(h=!tt(x)),x===92?y:p)}function y(x){return x===91||x===92||x===93?(e.consume(x),d++,p):p(x)}}function Ew(e,t,r,a,s,o){let c;return d;function d(y){return y===34||y===39||y===40?(e.enter(a),e.enter(s),e.consume(y),e.exit(s),c=y===40?41:y,h):r(y)}function h(y){return y===c?(e.enter(s),e.consume(y),e.exit(s),e.exit(a),t):(e.enter(o),f(y))}function f(y){return y===c?(e.exit(o),h(c)):y===null?r(y):Be(y)?(e.enter("lineEnding"),e.consume(y),e.exit("lineEnding"),ot(e,f,"linePrefix")):(e.enter("chunkString",{contentType:"string"}),m(y))}function m(y){return y===c||y===null||Be(y)?(e.exit("chunkString"),f(y)):(e.consume(y),y===92?p:m)}function p(y){return y===c||y===92?(e.consume(y),m):m(y)}}function oo(e,t){let r;return a;function a(s){return Be(s)?(e.enter("lineEnding"),e.consume(s),e.exit("lineEnding"),r=!0,a):tt(s)?ot(e,a,r?"linePrefix":"lineSuffix")(s):t(s)}}const WM={name:"definition",tokenize:e5},JM={partial:!0,tokenize:t5};function e5(e,t,r){const a=this;let s;return o;function o(x){return e.enter("definition"),c(x)}function c(x){return ww.call(a,e,d,r,"definitionLabel","definitionLabelMarker","definitionLabelString")(x)}function d(x){return s=Dr(a.sliceSerialize(a.events[a.events.length-1][1]).slice(1,-1)),x===58?(e.enter("definitionMarker"),e.consume(x),e.exit("definitionMarker"),h):r(x)}function h(x){return Tt(x)?oo(e,f)(x):f(x)}function f(x){return _w(e,m,r,"definitionDestination","definitionDestinationLiteral","definitionDestinationLiteralMarker","definitionDestinationRaw","definitionDestinationString")(x)}function m(x){return e.attempt(JM,p,p)(x)}function p(x){return tt(x)?ot(e,y,"whitespace")(x):y(x)}function y(x){return x===null||Be(x)?(e.exit("definition"),a.parser.defined.push(s),t(x)):r(x)}}function t5(e,t,r){return a;function a(d){return Tt(d)?oo(e,s)(d):r(d)}function s(d){return Ew(e,o,r,"definitionTitle","definitionTitleMarker","definitionTitleString")(d)}function o(d){return tt(d)?ot(e,c,"whitespace")(d):c(d)}function c(d){return d===null||Be(d)?t(d):r(d)}}const n5={name:"hardBreakEscape",tokenize:r5};function r5(e,t,r){return a;function a(o){return e.enter("hardBreakEscape"),e.consume(o),s}function s(o){return Be(o)?(e.exit("hardBreakEscape"),t(o)):r(o)}}const i5={name:"headingAtx",resolve:a5,tokenize:s5};function a5(e,t){let r=e.length-2,a=3,s,o;return e[a][1].type==="whitespace"&&(a+=2),r-2>a&&e[r][1].type==="whitespace"&&(r-=2),e[r][1].type==="atxHeadingSequence"&&(a===r-1||r-4>a&&e[r-2][1].type==="whitespace")&&(r-=a+1===r?2:4),r>a&&(s={type:"atxHeadingText",start:e[a][1].start,end:e[r][1].end},o={type:"chunkText",start:e[a][1].start,end:e[r][1].end,contentType:"text"},ar(e,a,r-a+1,[["enter",s,t],["enter",o,t],["exit",o,t],["exit",s,t]])),e}function s5(e,t,r){let a=0;return s;function s(m){return e.enter("atxHeading"),o(m)}function o(m){return e.enter("atxHeadingSequence"),c(m)}function c(m){return m===35&&a++<6?(e.consume(m),c):m===null||Tt(m)?(e.exit("atxHeadingSequence"),d(m)):r(m)}function d(m){return m===35?(e.enter("atxHeadingSequence"),h(m)):m===null||Be(m)?(e.exit("atxHeading"),t(m)):tt(m)?ot(e,d,"whitespace")(m):(e.enter("atxHeadingText"),f(m))}function h(m){return m===35?(e.consume(m),h):(e.exit("atxHeadingSequence"),d(m))}function f(m){return m===null||m===35||Tt(m)?(e.exit("atxHeadingText"),d(m)):(e.consume(m),f)}}const l5=["address","article","aside","base","basefont","blockquote","body","caption","center","col","colgroup","dd","details","dialog","dir","div","dl","dt","fieldset","figcaption","figure","footer","form","frame","frameset","h1","h2","h3","h4","h5","h6","head","header","hr","html","iframe","legend","li","link","main","menu","menuitem","nav","noframes","ol","optgroup","option","p","param","search","section","summary","table","tbody","td","tfoot","th","thead","title","tr","track","ul"],Cy=["pre","script","style","textarea"],o5={concrete:!0,name:"htmlFlow",resolveTo:d5,tokenize:f5},c5={partial:!0,tokenize:m5},u5={partial:!0,tokenize:h5};function d5(e){let t=e.length;for(;t--&&!(e[t][0]==="enter"&&e[t][1].type==="htmlFlow"););return t>1&&e[t-2][1].type==="linePrefix"&&(e[t][1].start=e[t-2][1].start,e[t+1][1].start=e[t-2][1].start,e.splice(t-2,2)),e}function f5(e,t,r){const a=this;let s,o,c,d,h;return f;function f(L){return m(L)}function m(L){return e.enter("htmlFlow"),e.enter("htmlFlowData"),e.consume(L),p}function p(L){return L===33?(e.consume(L),y):L===47?(e.consume(L),o=!0,N):L===63?(e.consume(L),s=3,a.interrupt?t:C):Ln(L)?(e.consume(L),c=String.fromCharCode(L),S):r(L)}function y(L){return L===45?(e.consume(L),s=2,x):L===91?(e.consume(L),s=5,d=0,_):Ln(L)?(e.consume(L),s=4,a.interrupt?t:C):r(L)}function x(L){return L===45?(e.consume(L),a.interrupt?t:C):r(L)}function _(L){const F="CDATA[";return L===F.charCodeAt(d++)?(e.consume(L),d===F.length?a.interrupt?t:G:_):r(L)}function N(L){return Ln(L)?(e.consume(L),c=String.fromCharCode(L),S):r(L)}function S(L){if(L===null||L===47||L===62||Tt(L)){const F=L===47,q=c.toLowerCase();return!F&&!o&&Cy.includes(q)?(s=1,a.interrupt?t(L):G(L)):l5.includes(c.toLowerCase())?(s=6,F?(e.consume(L),w):a.interrupt?t(L):G(L)):(s=7,a.interrupt&&!a.parser.lazy[a.now().line]?r(L):o?k(L):E(L))}return L===45||Tn(L)?(e.consume(L),c+=String.fromCharCode(L),S):r(L)}function w(L){return L===62?(e.consume(L),a.interrupt?t:G):r(L)}function k(L){return tt(L)?(e.consume(L),k):j(L)}function E(L){return L===47?(e.consume(L),j):L===58||L===95||Ln(L)?(e.consume(L),M):tt(L)?(e.consume(L),E):j(L)}function M(L){return L===45||L===46||L===58||L===95||Tn(L)?(e.consume(L),M):I(L)}function I(L){return L===61?(e.consume(L),R):tt(L)?(e.consume(L),I):E(L)}function R(L){return L===null||L===60||L===61||L===62||L===96?r(L):L===34||L===39?(e.consume(L),h=L,$):tt(L)?(e.consume(L),R):B(L)}function $(L){return L===h?(e.consume(L),h=null,Z):L===null||Be(L)?r(L):(e.consume(L),$)}function B(L){return L===null||L===34||L===39||L===47||L===60||L===61||L===62||L===96||Tt(L)?I(L):(e.consume(L),B)}function Z(L){return L===47||L===62||tt(L)?E(L):r(L)}function j(L){return L===62?(e.consume(L),z):r(L)}function z(L){return L===null||Be(L)?G(L):tt(L)?(e.consume(L),z):r(L)}function G(L){return L===45&&s===2?(e.consume(L),O):L===60&&s===1?(e.consume(L),H):L===62&&s===4?(e.consume(L),D):L===63&&s===3?(e.consume(L),C):L===93&&s===5?(e.consume(L),K):Be(L)&&(s===6||s===7)?(e.exit("htmlFlowData"),e.check(c5,Y,V)(L)):L===null||Be(L)?(e.exit("htmlFlowData"),V(L)):(e.consume(L),G)}function V(L){return e.check(u5,T,Y)(L)}function T(L){return e.enter("lineEnding"),e.consume(L),e.exit("lineEnding"),U}function U(L){return L===null||Be(L)?V(L):(e.enter("htmlFlowData"),G(L))}function O(L){return L===45?(e.consume(L),C):G(L)}function H(L){return L===47?(e.consume(L),c="",X):G(L)}function X(L){if(L===62){const F=c.toLowerCase();return Cy.includes(F)?(e.consume(L),D):G(L)}return Ln(L)&&c.length<8?(e.consume(L),c+=String.fromCharCode(L),X):G(L)}function K(L){return L===93?(e.consume(L),C):G(L)}function C(L){return L===62?(e.consume(L),D):L===45&&s===2?(e.consume(L),C):G(L)}function D(L){return L===null||Be(L)?(e.exit("htmlFlowData"),Y(L)):(e.consume(L),D)}function Y(L){return e.exit("htmlFlow"),t(L)}}function h5(e,t,r){const a=this;return s;function s(c){return Be(c)?(e.enter("lineEnding"),e.consume(c),e.exit("lineEnding"),o):r(c)}function o(c){return a.parser.lazy[a.now().line]?r(c):t(c)}}function m5(e,t,r){return a;function a(s){return e.enter("lineEnding"),e.consume(s),e.exit("lineEnding"),e.attempt(Oo,t,r)}}const p5={name:"htmlText",tokenize:g5};function g5(e,t,r){const a=this;let s,o,c;return d;function d(C){return e.enter("htmlText"),e.enter("htmlTextData"),e.consume(C),h}function h(C){return C===33?(e.consume(C),f):C===47?(e.consume(C),I):C===63?(e.consume(C),E):Ln(C)?(e.consume(C),B):r(C)}function f(C){return C===45?(e.consume(C),m):C===91?(e.consume(C),o=0,_):Ln(C)?(e.consume(C),k):r(C)}function m(C){return C===45?(e.consume(C),x):r(C)}function p(C){return C===null?r(C):C===45?(e.consume(C),y):Be(C)?(c=p,H(C)):(e.consume(C),p)}function y(C){return C===45?(e.consume(C),x):p(C)}function x(C){return C===62?O(C):C===45?y(C):p(C)}function _(C){const D="CDATA[";return C===D.charCodeAt(o++)?(e.consume(C),o===D.length?N:_):r(C)}function N(C){return C===null?r(C):C===93?(e.consume(C),S):Be(C)?(c=N,H(C)):(e.consume(C),N)}function S(C){return C===93?(e.consume(C),w):N(C)}function w(C){return C===62?O(C):C===93?(e.consume(C),w):N(C)}function k(C){return C===null||C===62?O(C):Be(C)?(c=k,H(C)):(e.consume(C),k)}function E(C){return C===null?r(C):C===63?(e.consume(C),M):Be(C)?(c=E,H(C)):(e.consume(C),E)}function M(C){return C===62?O(C):E(C)}function I(C){return Ln(C)?(e.consume(C),R):r(C)}function R(C){return C===45||Tn(C)?(e.consume(C),R):$(C)}function $(C){return Be(C)?(c=$,H(C)):tt(C)?(e.consume(C),$):O(C)}function B(C){return C===45||Tn(C)?(e.consume(C),B):C===47||C===62||Tt(C)?Z(C):r(C)}function Z(C){return C===47?(e.consume(C),O):C===58||C===95||Ln(C)?(e.consume(C),j):Be(C)?(c=Z,H(C)):tt(C)?(e.consume(C),Z):O(C)}function j(C){return C===45||C===46||C===58||C===95||Tn(C)?(e.consume(C),j):z(C)}function z(C){return C===61?(e.consume(C),G):Be(C)?(c=z,H(C)):tt(C)?(e.consume(C),z):Z(C)}function G(C){return C===null||C===60||C===61||C===62||C===96?r(C):C===34||C===39?(e.consume(C),s=C,V):Be(C)?(c=G,H(C)):tt(C)?(e.consume(C),G):(e.consume(C),T)}function V(C){return C===s?(e.consume(C),s=void 0,U):C===null?r(C):Be(C)?(c=V,H(C)):(e.consume(C),V)}function T(C){return C===null||C===34||C===39||C===60||C===61||C===96?r(C):C===47||C===62||Tt(C)?Z(C):(e.consume(C),T)}function U(C){return C===47||C===62||Tt(C)?Z(C):r(C)}function O(C){return C===62?(e.consume(C),e.exit("htmlTextData"),e.exit("htmlText"),t):r(C)}function H(C){return e.exit("htmlTextData"),e.enter("lineEnding"),e.consume(C),e.exit("lineEnding"),X}function X(C){return tt(C)?ot(e,K,"linePrefix",a.parser.constructs.disable.null.includes("codeIndented")?void 0:4)(C):K(C)}function K(C){return e.enter("htmlTextData"),c(C)}}const Rp={name:"labelEnd",resolveAll:v5,resolveTo:_5,tokenize:w5},b5={tokenize:E5},x5={tokenize:N5},y5={tokenize:S5};function v5(e){let t=-1;const r=[];for(;++t=3&&(f===null||Be(f))?(e.exit("thematicBreak"),t(f)):r(f)}function h(f){return f===s?(e.consume(f),a++,h):(e.exit("thematicBreakSequence"),tt(f)?ot(e,d,"whitespace")(f):d(f))}}const Gn={continuation:{tokenize:L5},exit:I5,name:"list",tokenize:D5},R5={partial:!0,tokenize:B5},j5={partial:!0,tokenize:z5};function D5(e,t,r){const a=this,s=a.events[a.events.length-1];let o=s&&s[1].type==="linePrefix"?s[2].sliceSerialize(s[1],!0).length:0,c=0;return d;function d(x){const _=a.containerState.type||(x===42||x===43||x===45?"listUnordered":"listOrdered");if(_==="listUnordered"?!a.containerState.marker||x===a.containerState.marker:Vm(x)){if(a.containerState.type||(a.containerState.type=_,e.enter(_,{_container:!0})),_==="listUnordered")return e.enter("listItemPrefix"),x===42||x===45?e.check(mu,r,f)(x):f(x);if(!a.interrupt||x===49)return e.enter("listItemPrefix"),e.enter("listItemValue"),h(x)}return r(x)}function h(x){return Vm(x)&&++c<10?(e.consume(x),h):(!a.interrupt||c<2)&&(a.containerState.marker?x===a.containerState.marker:x===41||x===46)?(e.exit("listItemValue"),f(x)):r(x)}function f(x){return e.enter("listItemMarker"),e.consume(x),e.exit("listItemMarker"),a.containerState.marker=a.containerState.marker||x,e.check(Oo,a.interrupt?r:m,e.attempt(R5,y,p))}function m(x){return a.containerState.initialBlankLine=!0,o++,y(x)}function p(x){return tt(x)?(e.enter("listItemPrefixWhitespace"),e.consume(x),e.exit("listItemPrefixWhitespace"),y):r(x)}function y(x){return a.containerState.size=o+a.sliceSerialize(e.exit("listItemPrefix"),!0).length,t(x)}}function L5(e,t,r){const a=this;return a.containerState._closeFlow=void 0,e.check(Oo,s,o);function s(d){return a.containerState.furtherBlankLines=a.containerState.furtherBlankLines||a.containerState.initialBlankLine,ot(e,t,"listItemIndent",a.containerState.size+1)(d)}function o(d){return a.containerState.furtherBlankLines||!tt(d)?(a.containerState.furtherBlankLines=void 0,a.containerState.initialBlankLine=void 0,c(d)):(a.containerState.furtherBlankLines=void 0,a.containerState.initialBlankLine=void 0,e.attempt(j5,t,c)(d))}function c(d){return a.containerState._closeFlow=!0,a.interrupt=void 0,ot(e,e.attempt(Gn,t,r),"linePrefix",a.parser.constructs.disable.null.includes("codeIndented")?void 0:4)(d)}}function z5(e,t,r){const a=this;return ot(e,s,"listItemIndent",a.containerState.size+1);function s(o){const c=a.events[a.events.length-1];return c&&c[1].type==="listItemIndent"&&c[2].sliceSerialize(c[1],!0).length===a.containerState.size?t(o):r(o)}}function I5(e){e.exit(this.containerState.type)}function B5(e,t,r){const a=this;return ot(e,s,"listItemPrefixWhitespace",a.parser.constructs.disable.null.includes("codeIndented")?void 0:5);function s(o){const c=a.events[a.events.length-1];return!tt(o)&&c&&c[1].type==="listItemPrefixWhitespace"?t(o):r(o)}}const Ty={name:"setextUnderline",resolveTo:U5,tokenize:H5};function U5(e,t){let r=e.length,a,s,o;for(;r--;)if(e[r][0]==="enter"){if(e[r][1].type==="content"){a=r;break}e[r][1].type==="paragraph"&&(s=r)}else e[r][1].type==="content"&&e.splice(r,1),!o&&e[r][1].type==="definition"&&(o=r);const c={type:"setextHeading",start:{...e[a][1].start},end:{...e[e.length-1][1].end}};return e[s][1].type="setextHeadingText",o?(e.splice(s,0,["enter",c,t]),e.splice(o+1,0,["exit",e[a][1],t]),e[a][1].end={...e[o][1].end}):e[a][1]=c,e.push(["exit",c,t]),e}function H5(e,t,r){const a=this;let s;return o;function o(f){let m=a.events.length,p;for(;m--;)if(a.events[m][1].type!=="lineEnding"&&a.events[m][1].type!=="linePrefix"&&a.events[m][1].type!=="content"){p=a.events[m][1].type==="paragraph";break}return!a.parser.lazy[a.now().line]&&(a.interrupt||p)?(e.enter("setextHeadingLine"),s=f,c(f)):r(f)}function c(f){return e.enter("setextHeadingLineSequence"),d(f)}function d(f){return f===s?(e.consume(f),d):(e.exit("setextHeadingLineSequence"),tt(f)?ot(e,h,"lineSuffix")(f):h(f))}function h(f){return f===null||Be(f)?(e.exit("setextHeadingLine"),t(f)):r(f)}}const $5={tokenize:q5};function q5(e){const t=this,r=e.attempt(Oo,a,e.attempt(this.parser.constructs.flowInitial,s,ot(e,e.attempt(this.parser.constructs.flow,s,e.attempt(YM,s)),"linePrefix")));return r;function a(o){if(o===null){e.consume(o);return}return e.enter("lineEndingBlank"),e.consume(o),e.exit("lineEndingBlank"),t.currentConstruct=void 0,r}function s(o){if(o===null){e.consume(o);return}return e.enter("lineEnding"),e.consume(o),e.exit("lineEnding"),t.currentConstruct=void 0,r}}const P5={resolveAll:Sw()},F5=Nw("string"),G5=Nw("text");function Nw(e){return{resolveAll:Sw(e==="text"?V5:void 0),tokenize:t};function t(r){const a=this,s=this.parser.constructs[e],o=r.attempt(s,c,d);return c;function c(m){return f(m)?o(m):d(m)}function d(m){if(m===null){r.consume(m);return}return r.enter("data"),r.consume(m),h}function h(m){return f(m)?(r.exit("data"),o(m)):(r.consume(m),h)}function f(m){if(m===null)return!0;const p=s[m];let y=-1;if(p)for(;++y-1){const d=c[0];typeof d=="string"?c[0]=d.slice(a):c.shift()}o>0&&c.push(e[s].slice(0,o))}return c}function aO(e,t){let r=-1;const a=[];let s;for(;++r