From 47afb4d4f33c1f00fd1ae4ce990d70849ffaa996 Mon Sep 17 00:00:00 2001 From: David Pine <7679720+IEvangelist@users.noreply.github.com> Date: Mon, 12 Oct 2026 23:23:45 -0500 Subject: [PATCH 01/29] Make Artifact Explorer resilient with recoverable jobs, soft limits, browser preview, and sharing skill Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: 72ee5a2d-bcbb-4e0f-b86f-6ad56d4fc033 --- docs/README.plugins.md | 2 +- docs/README.skills.md | 1 + extensions/pr-artifact-explorer/README.md | 28 +- .../pr-artifact-explorer/assets/app.css | 307 +++++ extensions/pr-artifact-explorer/assets/app.js | 63 +- .../pr-artifact-explorer/assets/browser.js | 1095 +++++++++++++++++ .../assets/docs/continuing-job.png | Bin 0 -> 14356 bytes .../assets/docs/preview-controls.png | Bin 0 -> 23207 bytes .../assets/docs/preview-options.png | Bin 0 -> 38797 bytes .../assets/octicons/arrow-left.svg | 1 + .../assets/octicons/arrow-right.svg | 1 + .../assets/octicons/book.svg | 1 + .../assets/octicons/copy.svg | 1 + .../assets/octicons/dash.svg | 1 + .../assets/octicons/device-camera.svg | 1 + .../assets/octicons/device-mobile.svg | 1 + .../assets/octicons/keyboard.svg | 1 + .../assets/octicons/plus.svg | 1 + .../backend-gaps.test.mjs | 179 +++ extensions/pr-artifact-explorer/cache.mjs | 413 ++++--- extensions/pr-artifact-explorer/capture.mjs | 346 ++++++ .../pr-artifact-explorer/capture.test.mjs | 127 ++ extensions/pr-artifact-explorer/constants.mjs | 18 +- extensions/pr-artifact-explorer/extension.mjs | 366 +++++- extensions/pr-artifact-explorer/github.mjs | 24 + .../pr-artifact-explorer/jobs-limits.test.mjs | 117 ++ extensions/pr-artifact-explorer/jobs.mjs | 411 +++++++ extensions/pr-artifact-explorer/limits.mjs | 166 +++ extensions/pr-artifact-explorer/preview.mjs | 8 +- extensions/pr-artifact-explorer/render.mjs | 25 +- extensions/pr-artifact-explorer/server.mjs | 375 +++++- .../pr-artifact-explorer/server.test.mjs | 116 ++ extensions/pr-artifact-explorer/targets.mjs | 326 +++++ .../pr-artifact-explorer/targets.test.mjs | 102 ++ extensions/pr-artifact-explorer/zip.mjs | 392 +++--- .../pr-artifact-explorer/zip64.test.mjs | 90 ++ plugins/pr-artifact-explorer/plugin.json | 3 + skills/pr-artifact-explorer/SKILL.md | 44 + 38 files changed, 4724 insertions(+), 429 deletions(-) create mode 100644 extensions/pr-artifact-explorer/assets/browser.js create mode 100644 extensions/pr-artifact-explorer/assets/docs/continuing-job.png create mode 100644 extensions/pr-artifact-explorer/assets/docs/preview-controls.png create mode 100644 extensions/pr-artifact-explorer/assets/docs/preview-options.png create mode 100644 extensions/pr-artifact-explorer/assets/octicons/arrow-left.svg create mode 100644 extensions/pr-artifact-explorer/assets/octicons/arrow-right.svg create mode 100644 extensions/pr-artifact-explorer/assets/octicons/book.svg create mode 100644 extensions/pr-artifact-explorer/assets/octicons/copy.svg create mode 100644 extensions/pr-artifact-explorer/assets/octicons/dash.svg create mode 100644 extensions/pr-artifact-explorer/assets/octicons/device-camera.svg create mode 100644 extensions/pr-artifact-explorer/assets/octicons/device-mobile.svg create mode 100644 extensions/pr-artifact-explorer/assets/octicons/keyboard.svg create mode 100644 extensions/pr-artifact-explorer/assets/octicons/plus.svg create mode 100644 extensions/pr-artifact-explorer/backend-gaps.test.mjs create mode 100644 extensions/pr-artifact-explorer/capture.mjs create mode 100644 extensions/pr-artifact-explorer/capture.test.mjs create mode 100644 extensions/pr-artifact-explorer/jobs-limits.test.mjs create mode 100644 extensions/pr-artifact-explorer/jobs.mjs create mode 100644 extensions/pr-artifact-explorer/limits.mjs create mode 100644 extensions/pr-artifact-explorer/server.test.mjs create mode 100644 extensions/pr-artifact-explorer/targets.mjs create mode 100644 extensions/pr-artifact-explorer/targets.test.mjs create mode 100644 extensions/pr-artifact-explorer/zip64.test.mjs create mode 100644 skills/pr-artifact-explorer/SKILL.md diff --git a/docs/README.plugins.md b/docs/README.plugins.md index fa5fa31550..9cf7eefe72 100644 --- a/docs/README.plugins.md +++ b/docs/README.plugins.md @@ -97,7 +97,7 @@ See [CONTRIBUTING.md](../CONTRIBUTING.md#adding-plugins) for guidelines on how t | [power-bi-development](../plugins/power-bi-development/README.md) | Comprehensive Power BI development resources including data modeling, DAX optimization, performance tuning, visualization design, security best practices, and DevOps/ALM guidance for building enterprise-grade Power BI solutions. | 8 items | power-bi, dax, data-modeling, performance, visualization, security, devops, business-intelligence | | [power-platform-architect](../plugins/power-platform-architect/README.md) | Solution Architect for the Microsoft Power Platform, turning business requirements into functioning Power Platform solution architectures. | 1 items | power-platform, power-platform-architect, power-apps, dataverse, power-automate, power-pages, power-bi | | [power-platform-mcp-connector-development](../plugins/power-platform-mcp-connector-development/README.md) | Complete toolkit for developing Power Platform custom connectors with Model Context Protocol integration for Microsoft Copilot Studio | 3 items | power-platform, mcp, copilot-studio, custom-connector, json-rpc | -| [pr-artifact-explorer](../plugins/pr-artifact-explorer/README.md) | Navigate pull requests and securely explore GitHub Actions artifacts, including test results, static sites, terminal recordings, and source files. | 1 items | actions-artifacts, artifact-browser, canvas, copilot-extension, github-actions, pull-requests, test-results | +| [pr-artifact-explorer](../plugins/pr-artifact-explorer/README.md) | Navigate pull requests and securely explore GitHub Actions artifacts, including test results, static sites, terminal recordings, and source files. | 2 items | actions-artifacts, artifact-browser, canvas, copilot-extension, github-actions, pull-requests, test-results | | [pr-review](../plugins/pr-review/README.md) | Review GitHub pull requests in a read-only canvas with AI-grouped changes, expandable diffs, and questions scoped to groups, files, or hunks. | 1 items | canvas, code-review, copilot-extension, pull-request, pull-request-review | | [project-documenter](../plugins/project-documenter/README.md) | Generate professional project documentation with draw.io architecture diagrams and Word (.docx) output with embedded images. Automatically discovers any project's technology stack and produces Markdown, diagrams, PNG exports, and a formatted Word document. | 3 items | documentation, architecture-diagrams, drawio, word-document, docx, png-images, c4-model, project-summary, auto-discovery | | [project-planning](../plugins/project-planning/README.md) | Tools and guidance for software project planning, feature breakdown, epic management, implementation planning, and task organization for development teams. | 15 items | planning, project-management, epic, feature, implementation, task, architecture, technical-spike | diff --git a/docs/README.skills.md b/docs/README.skills.md index 2e3530a45e..a6401fe734 100644 --- a/docs/README.skills.md +++ b/docs/README.skills.md @@ -330,6 +330,7 @@ See [CONTRIBUTING.md](../CONTRIBUTING.md#adding-skills) for guidelines on how to | [power-platform-architect](../skills/power-platform-architect/SKILL.md)
`gh skills install github/awesome-copilot power-platform-architect` | Use this skill when the user needs to transform business requirements, use case descriptions, or meeting transcripts into a technical Power Platform solution architecture, including component selection and Mermaid.js diagrams. | None | | [power-platform-mcp-connector-suite](../skills/power-platform-mcp-connector-suite/SKILL.md)
`gh skills install github/awesome-copilot power-platform-mcp-connector-suite` | Generate complete Power Platform custom connector with MCP integration for Copilot Studio - includes schema generation, troubleshooting, and validation | None | | [powerbi-modeling](../skills/powerbi-modeling/SKILL.md)
`gh skills install github/awesome-copilot powerbi-modeling` | Power BI semantic modeling assistant for building optimized data models. Use when working with Power BI semantic models, creating measures, designing star schemas, configuring relationships, implementing RLS, or optimizing model performance. Triggers on queries about DAX calculations, table relationships, dimension/fact table design, naming conventions, model documentation, cardinality, cross-filter direction, calculation groups, and data model best practices. Always connects to the active model first using power-bi-modeling MCP tools to understand the data structure before providing guidance. | `references/MEASURES-DAX.md`
`references/PERFORMANCE.md`
`references/RELATIONSHIPS.md`
`references/RLS.md`
`references/STAR-SCHEMA.md` | +| [pr-artifact-explorer](../skills/pr-artifact-explorer/SKILL.md)
`gh skills install github/awesome-copilot pr-artifact-explorer` | Open, share, and inspect GitHub PRs, issues, Actions artifacts, and local or HTTP(S) web previews in the Artifact Explorer canvas, with viewport presets, zoom, screenshots, and recoverable download jobs. | None | | [pr-dashboard](../skills/pr-dashboard/SKILL.md)
`gh skills install github/awesome-copilot pr-dashboard` | Open a GitHub PR dashboard in the browser. Use when the user asks to see their pull requests, open the PR dashboard, show PRs for a date range, or check PR status. Trigger phrases include "show my PRs", "open PR dashboard", "pull request dashboard". | `assets/dashboard.html`
`scripts/lib/utils.mjs`
`scripts/pr-dashboard-cli.mjs` | | [pr-screenshots](../skills/pr-screenshots/SKILL.md)
`gh skills install github/awesome-copilot pr-screenshots` | Embed before/after screenshots and annotated images in pull request descriptions. Covers PR description patterns, image upload for Azure DevOps and GitHub, and sizing best practices. | None | | [prd](../skills/prd/SKILL.md)
`gh skills install github/awesome-copilot prd` | Generate high-quality Product Requirements Documents (PRDs) for software systems and AI-powered features. Includes executive summaries, user stories, technical specifications, and risk analysis. | None | diff --git a/extensions/pr-artifact-explorer/README.md b/extensions/pr-artifact-explorer/README.md index 84e2f70444..c975b0dfb9 100644 --- a/extensions/pr-artifact-explorer/README.md +++ b/extensions/pr-artifact-explorer/README.md @@ -22,6 +22,24 @@ Artifact Explorer is a community-built Copilot canvas extension with the interna - Keeps large files available for direct download and falls back to the original artifact archive when a ZIP entry uses an unsupported encoding. - Provides per-artifact cleanup, clear-all cleanup, and a cache usage view. - Uses a responsive Primer interface that follows Copilot's light and dark themes. +- Runs downloads, indexing, and decompression as recoverable background jobs that are independent of any request or view. Closing the view, retrying, or restarting the canvas never kills them, and a completed ZIP is reused on retry. A provider termination is reported honestly as `interrupted` with a Retry action. +- Soft limits (download size, ZIP entries, central-directory size, streamed entry size, idle time) never stop work. When one is crossed the job keeps running and the canvas asks for a larger value; the new limit must be at least the live value at submission and is checked atomically against live progress. +- Supports ZIP64 and validates the full central directory. The only hard stops are real integrity, safe-integer, path, and free-disk guards; there are no hidden size ceilings. +- Provides a browser-style preview for localhost and HTTP(S) URLs: Mobile/Tablet/Desktop/Native/Custom viewport presets, windowed zoom (separate from the viewport), back/forward/refresh, natural-language navigation, and a keyboard-hint overlay (`?`). Pages that forbid framing are reported, never bypassed. +- Captures real Playwright/Chromium screenshots with device emulation. `screenshot` defaults to a fresh render (labelled `fresh-render`); `mode: "controlled"` captures the live isolated Chromium page (`controlled-current`). PNGs are saved under the session `files/artifact-explorer-screenshots` folder. +- Offers an isolated controlled Chromium (in-memory profile, no login state) with real back/forward/refresh that survives device changes, for sites that block embedding. +- Includes copy buttons after titles and a `#number` link to the canonical GitHub issue or pull request, with an adjacent copy-link button. +- Ships a built-in Docs tab and a sharing skill (`pr-artifact-explorer`) for share links, artifact IDs, and routes. + +## Screenshot setup + +Screenshots need Playwright and a Chromium browser. Nothing is installed silently: + +```text +npm install playwright-core # then: npx playwright install chromium +``` + +Optional environment variables: `PR_ARTIFACT_EXPLORER_PLAYWRIGHT` (path to a `playwright`/`playwright-core` package) and `PR_ARTIFACT_EXPLORER_CHROMIUM` (path to a Chromium/Chrome/Edge executable). Without a runtime the action returns explicit setup instructions. A fresh isolated profile is used for every capture; no login profile is persisted. ## Security and local data @@ -55,7 +73,15 @@ Reload extensions, then ask Copilot to open the `pr-artifact-explorer` canvas. Y ## Agent actions - `open_pull_request { repository, pullNumber }` - navigate an open canvas to a pull request. -- `inspect_artifact { repository, artifactId }` - download, index, detect, and open an Actions artifact. +- `open_target { input }` - open any share link, URL, issue/PR, artifact, or route. +- `inspect_artifact { repository, artifactId }` - start a recoverable job to download, index, detect, and open an Actions artifact. +- `job_status`, `retry_job`, `cancel_job`, `set_limit { kind, value }` - manage jobs and soft limits. +- `restart_canvas` - restart the instance (same port and token) without stopping jobs. +- `navigate_browser`, `set_viewport`, `set_zoom`, `screenshot` - drive the browser preview. +- `controlled_navigate`, `controlled_back`, `controlled_forward`, `controlled_refresh`, `controlled_close` - drive the isolated controlled Chromium. +- `share { input, preset?, zoom?, width?, height? }` - build shareable links that round-trip through `open_target`. +- `share { input }` - produce a shareable link, route, and text for a target. +- `docs { section? }` - open the built-in Docs tab. - `cache_status` - report local artifact cache usage. - `clear_cache { artifactId? }` - remove one cached artifact or clear the entire cache. - `accounts` - list sanitized GitHub account metadata available to the extension. diff --git a/extensions/pr-artifact-explorer/assets/app.css b/extensions/pr-artifact-explorer/assets/app.css index d25e82b41a..0dd1cc1b5b 100644 --- a/extensions/pr-artifact-explorer/assets/app.css +++ b/extensions/pr-artifact-explorer/assets/app.css @@ -512,6 +512,8 @@ select { display: inline-flex; gap: var(--base-size-6, 6px); align-items: center; + flex: none; + white-space: nowrap; font-weight: 400; } @@ -3812,3 +3814,308 @@ select { border-top: 0; } } + +.icon-copy { --octicon-url: url("/assets/octicons/copy.svg"); } +.icon-arrow-left { --octicon-url: url("/assets/octicons/arrow-left.svg"); } +.icon-arrow-right { --octicon-url: url("/assets/octicons/arrow-right.svg"); } +.icon-book { --octicon-url: url("/assets/octicons/book.svg"); } +.icon-plus { --octicon-url: url("/assets/octicons/plus.svg"); } +.icon-dash { --octicon-url: url("/assets/octicons/dash.svg"); } +.icon-device-camera { --octicon-url: url("/assets/octicons/device-camera.svg"); } +.icon-keyboard { --octicon-url: url("/assets/octicons/keyboard.svg"); } +.icon-device-mobile { --octicon-url: url("/assets/octicons/device-mobile.svg"); } + +.header-button { background: none; border: 0; cursor: pointer; font: inherit; } +.connection-state { color: var(--app-attention); font-size: 12px; margin-left: 8px; } + +.title-copy, +.icon-button { + align-items: center; + background: transparent; + border: 1px solid transparent; + border-radius: var(--app-radius); + color: var(--app-fg-muted); + cursor: pointer; + display: inline-flex; + font: inherit; + justify-content: center; + min-height: 28px; + min-width: 28px; + padding: 0 6px; + vertical-align: middle; +} +.title-copy:hover, +.icon-button:hover:not(:disabled) { background: var(--app-bg-muted); border-color: var(--app-border); color: var(--app-fg); } +.title-copy:focus-visible, +.icon-button:focus-visible { outline: 2px solid var(--app-accent); outline-offset: 1px; } +.icon-button:disabled { cursor: not-allowed; opacity: 0.45; } +.icon-button[aria-pressed="true"] { background: var(--app-bg-muted); border-color: var(--app-border); } +.page-title-number-link { color: var(--app-fg-muted); font-weight: 300; text-decoration: none; } +.page-title-number-link:hover { color: var(--app-accent); text-decoration: underline; } + +.job-panel { + background: var(--app-bg); + border: 1px solid var(--app-border); + border-radius: var(--app-radius); + bottom: 16px; + box-shadow: 0 8px 24px rgba(31, 35, 40, 0.18); + display: grid; + gap: 10px; + max-height: 60vh; + max-width: 420px; + overflow: auto; + padding: 12px; + position: fixed; + right: 16px; + z-index: 40; +} +.job-panel[hidden] { display: none; } +.job-card { border-top: 1px solid var(--app-border-muted); display: grid; gap: 6px; padding-top: 8px; } +.job-card:first-child { border-top: 0; padding-top: 0; } +.job-card progress { width: 100%; } +.job-card .job-meta { color: var(--app-fg-muted); font-size: 12px; } +.job-card .job-error { color: var(--app-danger); font-size: 12px; } +.job-prompt { background: var(--app-bg-muted); border-left: 3px solid var(--app-attention); display: grid; gap: 6px; padding: 8px; } +.job-prompt form { align-items: center; display: flex; flex-wrap: wrap; gap: 6px; } +.job-prompt input { max-width: 140px; } +.job-actions { display: flex; gap: 6px; } + +.browser-view { display: grid; min-width: 0; gap: 0; } +.app-shell:has(.browser-view) .breadcrumb-bar { display: none; } +.app-main:has(.browser-view) { max-width: none; padding: 0; margin: 0; } +.browser-toolbar { + display: grid; + gap: 4px; + padding: 8px 12px; + background: var(--app-bg); + border-bottom: 1px solid var(--app-border-muted); +} +.browser-navigation, +.browser-view-controls, +.browser-zoom-controls { display: flex; align-items: center; gap: 4px; min-width: 0; } +.browser-navigation form { display: flex; flex: 1; min-width: 0; } +.browser-toolbar .browser-address { width: 100%; min-width: 0; height: 32px; font-size: 13px; } +.browser-toolbar .icon-button { width: 32px; min-width: 32px; height: 32px; padding: 0; } +.browser-toolbar .icon-button:hover:not(:disabled) { border-color: transparent; } +.browser-view-controls .form-select { width: 112px; min-width: 92px; height: 32px; font-size: 12px; } +.browser-zoom-controls { gap: 0; } +.browser-zoom-label { font-size: 12px; font-variant-numeric: tabular-nums; width: 42px; text-align: center; } +.browser-controls-spacer { flex: 1; } +.browser-status { color: var(--app-fg-muted); font-size: 12px; } +.browser-notice { background: var(--app-bg-muted); border-bottom: 1px solid var(--app-border); padding: 8px 12px; font-size: 13px; } +.browser-notice[hidden] { display: none; } +.browser-stage { + background: var(--app-bg-inset); + min-height: max(320px, calc(100dvh - 133px)); + min-width: 0; + max-width: 100%; + overflow: auto; + padding: 16px; +} +.browser-scale-box { margin: 0 auto; position: relative; } +.browser-scale-box[hidden], +.browser-empty[hidden] { display: none; } +.browser-empty { max-width: 360px; margin: 80px auto; text-align: center; font-size: 13px; } +.browser-empty strong { font-size: 16px; font-weight: 600; } +.browser-empty p { color: var(--app-fg-muted); margin: 8px 0 0; } +.browser-frame { + background: #fff; + border: 0; + box-sizing: content-box; + outline: 1px solid var(--app-border); + display: block; + transform-origin: 0 0; +} +.browser-shots { display: grid; gap: 8px; grid-template-columns: repeat(auto-fill, minmax(200px, 1fr)); } +.browser-shots:not(:empty) { padding: 12px; } +.browser-shots figure { border: 1px solid var(--app-border); border-radius: var(--app-radius); margin: 0; padding: 6px; } +.browser-shots img { max-width: 100%; } +.browser-shots figcaption { color: var(--app-fg-muted); font-size: 12px; } + +.kbd-hints { background: var(--app-bg); border: 1px solid var(--app-border); border-radius: var(--app-radius); padding: 12px; } +.kbd-hints[hidden] { display: none; } +.kbd-hints dl { display: grid; gap: 4px 16px; grid-template-columns: auto 1fr; margin: 0; } +.kbd-hints dt { white-space: nowrap; } +kbd { background: var(--app-bg-muted); border: 1px solid var(--app-border); border-radius: 4px; font-family: var(--app-mono); font-size: 11px; padding: 1px 5px; } + +.docs-view { display: grid; gap: 40px; grid-template-columns: 200px minmax(0, 1fr); max-width: 1040px; margin: 8px auto 40px; } +.docs-nav { display: grid; align-content: start; align-self: start; gap: 12px; position: sticky; top: 106px; font-size: 13px; } +.docs-search { width: 100%; min-width: 0; font-size: 13px; } +.docs-link-list { display: grid; gap: 2px; } +.docs-link-list a { border-radius: var(--app-radius); color: var(--app-fg-muted); padding: 8px; text-decoration: none; line-height: 1.4; } +.docs-link-list a:hover { background: var(--app-bg-muted); color: var(--app-fg); } +.docs-link-list a[aria-current="page"] { background: var(--app-bg-muted); color: var(--app-fg); font-weight: 600; } +.docs-link-list a:focus-visible { outline: 2px solid var(--focus-outlineColor, var(--app-accent)); outline-offset: -2px; } +.docs-link-list a[hidden] { display: none; } +.docs-topic-select { display: none; } +.docs-search-status { color: var(--app-fg-muted); font-size: 12px; margin: 0; } +.docs-body { min-width: 0; max-width: 72ch; font-size: 16px; line-height: 1.65; overflow-wrap: anywhere; } +.docs-body h1 { margin: 0 0 20px; font-size: 26px; line-height: 1.25; font-weight: 600; } +.docs-body h2 { margin: 32px 0 12px; font-size: 20px; line-height: 1.35; font-weight: 600; } +.docs-body p { margin: 0 0 16px; } +.docs-body .docs-lead { margin-bottom: 24px; color: var(--app-fg-muted); font-size: 16px; } +.docs-body a { text-underline-offset: 3px; } +.docs-body code { padding: 2px 4px; background: var(--app-bg-muted); border-radius: 4px; font-family: var(--app-mono); font-size: 0.85em; } +.docs-steps { padding-left: 24px; margin: 0 0 24px; } +.docs-steps li { padding-left: 4px; margin-bottom: 16px; } +.docs-steps li::marker { color: var(--app-fg-muted); font-weight: 600; font-variant-numeric: tabular-nums; } +.docs-figure { margin: 28px 0; } +.docs-figure img { display: block; width: 100%; height: auto; border: 1px solid var(--app-border); border-radius: var(--app-radius); } +.docs-figure figcaption { margin-top: 8px; color: var(--app-fg-muted); font-size: 12px; line-height: 1.5; } +.docs-figure:has(img[src$="continuing-job.png"]) { max-width: 420px; } +.docs-next { display: flex; flex-wrap: wrap; gap: 8px 20px; padding-top: 20px; margin-top: 32px; border-top: 1px solid var(--app-border-muted); font-size: 14px; } +.docs-next strong { flex-basis: 100%; font-weight: 600; } +.docs-body .kbd-list { display: grid; grid-template-columns: minmax(120px, 0.8fr) minmax(0, 1.2fr); margin: 24px 0; font-size: 14px; } +.docs-body .kbd-list dt, +.docs-body .kbd-list dd { margin: 0; padding: 12px 0; border-bottom: 1px solid var(--app-border-muted); } +.docs-body kbd { font-size: 12px; } +.docs-details { margin-top: 28px; padding: 16px 0; border-block: 1px solid var(--app-border-muted); font-size: 14px; } +.docs-details summary { font-weight: 600; cursor: pointer; } +.docs-details[open] summary { margin-bottom: 16px; } +.docs-details p:last-child { margin-bottom: 0; } +.docs-details summary:focus-visible { outline: 2px solid var(--focus-outlineColor, var(--app-accent)); outline-offset: 4px; } +@media (max-width: 720px) { + .docs-view { grid-template-columns: minmax(0, 1fr); gap: 24px; margin-top: 0; } + .docs-nav { position: static; grid-template-columns: minmax(0, 1fr) minmax(0, 1fr); gap: 8px; } + .docs-topic-select { display: block; width: 100%; min-width: 0; font-size: 13px; } + .docs-link-list { display: none; } + .docs-nav[data-searching="true"] .docs-link-list { display: grid; grid-column: 1 / -1; } + .docs-search-status { grid-column: 1 / -1; } + .docs-body h1 { font-size: 26px; } + .docs-body .kbd-list { grid-template-columns: minmax(112px, 0.85fr) minmax(0, 1.15fr); } +} + +.browser-frame[hidden] { display: none; } +.preview-open-browser { margin-bottom: 8px; } + +.app-header { + display: flex; + min-height: 48px; + padding: 8px 12px; + gap: 12px; +} +.app-brand { flex: none; font-size: 13px; } +.repository-form { flex: 1; max-width: 420px; margin: 0 auto 0 0; } +.repository-combobox { min-width: 0; } +.repository-input-shell { height: 32px; } +.repository-input { height: 30px; font-size: 13px; } +.repository-menu-button { height: 30px; } +.app-navigation { gap: 4px; } +.app-header .header-cache-item { + display: flex; + flex: none; + min-width: 0; + gap: 8px; + margin-right: 0; +} +.app-navigation .cache-link { min-height: 32px; padding: 0 8px; border-radius: var(--app-radius); font-size: 12px; } +.app-navigation .cache-link:hover, +.app-navigation .cache-link[aria-current="page"], +.app-navigation .cache-link[aria-expanded="true"] { background: var(--headerSearch-borderColor, rgb(255 255 255 / 12%)); text-decoration: none; } +.app-navigation .cache-link:focus-visible { outline: 2px solid var(--focus-outlineColor, var(--app-accent)); outline-offset: 2px; } +.account-chip { width: 32px; height: 32px; } +.account-avatar, +.account-avatar-fallback { width: 28px; height: 28px; } +.breadcrumb-bar { top: 48px; } + +.explorer-popover { + position: fixed; + inset: auto; + width: min(320px, calc(100vw - 16px)); + margin: 0; + padding: 8px; + overflow-y: auto; + color: var(--app-fg); + background: var(--app-bg); + border: 1px solid var(--app-border); + border-radius: var(--app-radius); + box-shadow: var(--shadow-floating-small, 0 4px 12px rgb(31 35 40 / 15%)); + font: 13px/1.5 var(--app-font); +} +.app-options { width: min(240px, calc(100vw - 16px)); } +.popover-section { padding: 8px; } +.popover-section + .popover-section { border-top: 1px solid var(--app-border-muted); } +.popover-section h2 { margin: 0 0 4px; font-size: 13px; font-weight: 600; } +.popover-action { + display: flex; + width: 100%; + min-height: 36px; + align-items: center; + gap: 8px; + padding: 6px 8px; + color: var(--app-fg); + background: transparent; + border: 0; + border-radius: var(--app-radius); + font: inherit; + text-align: left; + text-decoration: none; + cursor: pointer; +} +.popover-action:hover:not(:disabled) { background: var(--app-bg-muted); color: var(--app-fg); text-decoration: none; } +.popover-action:focus-visible { outline: 2px solid var(--focus-outlineColor, var(--app-accent)); outline-offset: -2px; } +.popover-action:disabled { opacity: 0.65; cursor: not-allowed; } +.popover-action[aria-pressed="true"] { background: var(--app-bg-muted); } +.popover-description { margin: 4px 8px 8px; color: var(--app-fg-muted); font-size: 12px; } +.popover-button-row { display: flex; gap: 6px; margin-top: 8px; } +.popover-button-row [aria-pressed="true"] { border-color: var(--app-accent); } +.toggle-state { margin-left: auto; color: var(--app-fg-muted); font-size: 12px; } +.toggle-state::after { content: "Off"; } +[aria-pressed="true"] > .toggle-state::after { content: "On"; color: var(--app-success); } +.browser-dimensions { display: flex; align-items: end; gap: 8px; margin-top: 8px; } +.browser-dimensions[hidden] { display: none; } +.browser-dimensions label { min-width: 0; flex: 1; font-size: 12px; color: var(--app-fg-muted); } +.browser-dimensions input { width: 100%; min-width: 0; margin-top: 4px; font-size: 13px; } +.browser-dimensions > span { line-height: 32px; color: var(--app-fg-muted); } +.browser-options .kbd-hints { padding: 8px 0 0; border: 0; font-size: 12px; } +.browser-options .kbd-hints dl { gap: 8px; } +.browser-options .kbd-hints dd { margin: 0; } +.browser-options .kbd-hints dt { white-space: normal; } +.manual-copy-dialog { + width: min(480px, calc(100vw - 32px)); + padding: 16px; + color: var(--app-fg); + background: var(--app-bg); + border: 1px solid var(--app-border); + border-radius: var(--app-radius); + font: 13px/1.5 var(--app-font); +} +.manual-copy-dialog::backdrop { background: var(--overlay-backdrop-bgColor, rgb(31 35 40 / 40%)); } +.manual-copy-dialog h2 { margin: 0; font-size: 16px; font-weight: 600; } +.manual-copy-dialog p { margin: 8px 0; color: var(--app-fg-muted); } +.manual-copy-dialog textarea { + width: 100%; + min-height: 96px; + padding: 8px; + color: var(--app-fg); + background: var(--app-bg); + border: 1px solid var(--app-border); + border-radius: var(--app-radius); + font: 12px/1.5 var(--app-mono); + resize: vertical; +} +.manual-copy-dialog textarea:focus-visible { outline: 2px solid var(--focus-outlineColor, var(--app-accent)); outline-offset: 1px; } +.manual-copy-dialog form { display: flex; justify-content: end; margin-top: 12px; } + +@media (max-width: 767px) { + .app-header { gap: 4px 8px; } + .app-navigation { margin-left: auto; } + .account-control { margin-left: 0; } + .repository-form { flex: 1 1 100%; order: 3; max-width: none; } + .breadcrumb-bar { top: auto; } + .browser-stage { min-height: max(320px, calc(100dvh - 169px)); } +} +@media (max-width: 480px) { + .app-header { padding: 6px 8px; } + .app-navigation .cache-link { padding: 0 6px; } + .app-navigation > a > .octicon { display: none; } + .browser-toolbar { padding: 6px 8px; } + .browser-controls-spacer { display: none; } + .browser-view-controls .form-select { flex: 1; width: 92px; } + .browser-view-controls .app-button { padding: 0 8px; } + .browser-stage { min-height: max(320px, calc(100dvh - 161px)); } +} +@media (max-width: 380px) { + .browser-shot-label { display: none; } + #br-shot { min-width: 32px; padding: 0; } +} \ No newline at end of file diff --git a/extensions/pr-artifact-explorer/assets/app.js b/extensions/pr-artifact-explorer/assets/app.js index bbc2969c79..589a0d886c 100644 --- a/extensions/pr-artifact-explorer/assets/app.js +++ b/extensions/pr-artifact-explorer/assets/app.js @@ -674,6 +674,19 @@ function parseRoute() { filePath: query.get("file"), }; } + if (parts[0] === "issue" && parts[1] && parts[2]) { + return { + name: "issue", + repository: decodeURIComponent(parts[1]), + issueNumber: Number(parts[2]), + }; + } + if (parts[0] === "docs") { + return { name: "docs", section: parts[1] ? decodeURIComponent(parts[1]) : null }; + } + if (parts[0] === "browser") { + return { name: "browser", query }; + } if (parts[0] === "cache") return { name: "cache" }; if (parts[0] === "accounts") return { name: "accounts" }; return { @@ -3151,10 +3164,7 @@ function renderPullPayload(repository, pullNumber, payload, cache) { view.innerHTML = `
-

- ${titleHtml(pull.title)} - #${pull.number} -

+ ${pageTitleHtml(pull.title, pull.number, pull.url)}
@@ -3949,6 +3959,13 @@ async function previewArtifactFile(entry, sequence) { sandbox="allow-scripts allow-same-origin allow-forms allow-modals allow-downloads" referrerpolicy="no-referrer" >`; + const openInBrowser = document.createElement("a"); + openInBrowser.className = "btn btn-sm preview-open-browser"; + openInBrowser.textContent = "Open in browser view"; + openInBrowser.title = "Preview at mobile, tablet or desktop sizes with zoom, history and screenshots"; + openInBrowser.href = browserHash({ url: result.url, preset: "desktop" }); + openInBrowser.addEventListener("click", () => sessionStorage.setItem("pae.shareRoute", location.hash.replace(/([?&])v=[^&]*&?/, "$1").replace(/[?&]$/, ""))); + preview.prepend(openInBrowser); const frame = preview.querySelector("iframe[data-theme-aware-preview]"); if (frame) { frame.style.colorScheme = theme; @@ -4492,6 +4509,10 @@ async function renderRoute({ force = false } = {}) { await renderArtifact(route, sequence); } else if (route.name === "cache") await renderCache(sequence); else if (route.name === "accounts") await renderAccountsPage(sequence); + else if (route.name === "issue") await renderIssue(route, sequence); + else if (route.name === "docs") renderDocs(route); + else if (route.name === "browser") renderBrowser(route); + if (route.name !== "browser") disposeBrowser(); } catch (error) { if (sequence === renderSequence) renderError(error); } @@ -4526,6 +4547,7 @@ function routeFromInput(value) { } async function navigateToRepository(value) { + if (!isPlainRepositoryInput(value) && (await navigateNaturalLanguage(value))) return; const target = repositoryTargetFromInput(value); const searchIcon = repositoryCombobox.querySelector(".repository-search-icon"); repositoryInput.readOnly = true; @@ -4588,10 +4610,14 @@ async function inspectArtifactButton(button) { for (const control of controls) control.disabled = true; statusButton.setAttribute("aria-label", "Downloading artifact"); try { - await api("/api/artifacts/inspect", { + const started = await api("/api/artifacts/inspect", { method: "POST", body: { artifactId, repository }, }); + const finalJob = await waitForJob(started.job.id); + if (finalJob.status !== "succeeded") { + throw new Error(finalJob.error || `Artifact job ${finalJob.status}.`); + } updateCacheHeader(await api("/api/cache")); artifactDownloadProgress.delete(String(artifactId)); location.hash = artifactHash(repository, pullNumber, artifactId); @@ -5292,13 +5318,13 @@ view.addEventListener("keydown", (event) => { openPullSignal.focus(); return; } - if (event.key === "Escape" && !document.getElementById("pull-author-panel")?.hidden) { + if (event.key === "Escape" && !document.getElementById("pull-author-panel")?.hidden === false) { event.preventDefault(); setPullAuthorPanelOpen(false); document.querySelector("[data-toggle-pull-author]")?.focus(); return; } - if (event.key === "Escape" && !document.getElementById("pull-state-panel")?.hidden) { + if (event.key === "Escape" && !document.getElementById("pull-state-panel")?.hidden === false) { event.preventDefault(); setPullStatePanelOpen(false); document.querySelector("[data-toggle-pull-state]")?.focus(); @@ -5334,19 +5360,22 @@ async function initialize() { events.addEventListener("refresh", () => { void renderRoute(); }); + events.addEventListener("job", (event) => handleJobEvent(JSON.parse(event.data))); + events.addEventListener("snapshot", (event) => handleSnapshotEvent(JSON.parse(event.data))); + events.addEventListener("restart", () => handleRestartEvent()); + events.addEventListener("browser-command", (event) => + handleBrowserCommand(JSON.parse(event.data)), + ); + events.addEventListener("error", () => setConnectionState(false)); + events.addEventListener("open", () => setConnectionState(true)); + installJobPanel(); + installGlobalShortcuts(); if (!location.hash || location.hash === "#/") { const input = bootstrapState.initialInput ?? {}; - if (typeof input.url === "string" && input.url) { - location.hash = routeFromInput(input.url); - return; - } - if (typeof input.repository === "string" && input.pullNumber) { - location.hash = pullHash(input.repository, input.pullNumber); - return; - } - if (typeof input.repository === "string") { - location.hash = pullsHashForRepository(input.repository); + const initialRoute = await initialRouteFromInput(input); + if (initialRoute) { + location.hash = initialRoute; return; } location.hash = pullsHashForRepository(bootstrapState.prefs.repository); diff --git a/extensions/pr-artifact-explorer/assets/browser.js b/extensions/pr-artifact-explorer/assets/browser.js new file mode 100644 index 0000000000..94d5ad31ea --- /dev/null +++ b/extensions/pr-artifact-explorer/assets/browser.js @@ -0,0 +1,1095 @@ +"use strict"; +/* Browser preview, jobs, docs, copy helpers and shortcuts. Loaded before app.js; app.js globals are used only at call time. */ + +const BROWSER_PRESETS = { + native: { label: "Native (fit window)", width: null, height: null, dpr: 1 }, + mobile: { label: "Mobile 390×844", width: 390, height: 844, dpr: 3 }, + tablet: { label: "Tablet 768×1024", width: 768, height: 1024, dpr: 2 }, + desktop: { label: "Desktop 1440×900", width: 1440, height: 900, dpr: 1 }, + custom: { label: "Custom size", width: 1024, height: 768, dpr: 1 }, +}; +const ZOOM_MIN = 0.25; +const ZOOM_MAX = 3; +const ZOOM_STEP = 0.25; + +let browserState = null; +let browserCleanup = null; +const jobsById = new Map(); +let jobWarnings = []; +let jobPanel = null; +const jobWaiters = new Map(); + +/* ---------- base64url + view encoding (matches targets.mjs) ---------- */ + +function encodeViewClient(view) { + const body = { v: 1 }; + if (view.url) body.url = view.url; + if (view.preset) body.preset = view.preset; + if (view.width) body.w = view.width; + if (view.height) body.h = view.height; + if (view.zoom) body.z = view.zoom; + if (view.orientation) body.o = view.orientation; + const bytes = new TextEncoder().encode(JSON.stringify(body)); + let binary = ""; + for (const byte of bytes) binary += String.fromCharCode(byte); + return btoa(binary).replaceAll("+", "-").replaceAll("/", "_").replace(/=+$/, ""); +} + +function decodeViewClient(text) { + if (!text) return {}; + try { + const padded = text.replaceAll("-", "+").replaceAll("_", "/"); + const binary = atob(padded + "=".repeat((4 - (padded.length % 4)) % 4)); + const body = JSON.parse(new TextDecoder().decode(Uint8Array.from(binary, (c) => c.charCodeAt(0)))); + return { url: body.url, preset: body.preset, width: body.w, height: body.h, zoom: body.z, orientation: body.o }; + } catch { + return {}; + } +} + +function browserHash(view) { + return `#/browser?v=${encodeViewClient(view)}`; +} + +/* ---------- copy helpers ---------- */ + +async function copyText(text, label = "Copied") { + try { + await navigator.clipboard.writeText(text); + showToast(`${label} to clipboard.`); + return true; + } catch { + const area = document.createElement("textarea"); + area.value = text; + area.setAttribute("readonly", ""); + area.style.position = "fixed"; + area.style.opacity = "0"; + document.body.append(area); + area.select(); + let ok = false; + try { + ok = document.execCommand("copy"); + } catch { + ok = false; + } + area.remove(); + if (!ok) { + const previousFocus = document.activeElement; + const dialog = document.createElement("dialog"); + dialog.className = "manual-copy-dialog"; + dialog.setAttribute("aria-labelledby", "manual-copy-title"); + dialog.innerHTML = `

Copy manually

Your browser blocked clipboard access. Select this text and copy it.

`; + dialog.querySelector("textarea").value = text; + dialog.addEventListener("close", () => { + dialog.remove(); + if (previousFocus instanceof HTMLElement && previousFocus.isConnected) previousFocus.focus(); + }, { once: true }); + dialog.addEventListener("keydown", (event) => { + if (event.key === "Escape") event.stopPropagation(); + }); + document.body.append(dialog); + dialog.showModal(); + dialog.querySelector("textarea").select(); + } + showToast(ok ? `${label} to clipboard.` : "Copy failed. Select the text and copy manually.", ok ? "info" : "error"); + return ok; + } +} + +function copyButtonHtml(text, label, iconName = "copy") { + return ``; +} + +function pageTitleHtml(title, number, url) { + const text = String(title ?? ""); + const numberHtml = + Number.isInteger(number) && url + ? `#${number}${copyButtonHtml(url, `Copy link to #${number}`, "copy")}` + : Number.isInteger(number) + ? `#${number}` + : ""; + return `

${titleHtml(text)}${copyButtonHtml(text, "Copy title")}${numberHtml}

`; +} + +document.addEventListener("click", (event) => { + const button = event.target instanceof Element ? event.target.closest("[data-copy]") : null; + if (!button) return; + event.preventDefault(); + const label = button.dataset.copyLabel ?? "Copied"; + void copyText(button.dataset.copy ?? "", label.replace(/^Copy /, "Copied ")); +}); + +/* ---------- natural-language navigation ---------- */ + +function isPlainRepositoryInput(value) { + return /^[\w.-]+\/[\w.-]+$/.test(String(value ?? "").trim()); +} + +async function navigateNaturalLanguage(value) { + const input = String(value ?? "").trim(); + if (!input) return false; + try { + const parsed = await api("/api/targets/parse", { + method: "POST", + body: { input, repository: bootstrapState?.prefs?.repository }, + }); + if (parsed.target?.kind === "command") { + handleBrowserCommand(parsed.target); + return true; + } + if (!parsed.route) throw new Error("That request cannot be opened."); + location.hash = parsed.route; + if (location.hash === parsed.route) void renderRoute(); + return true; + } catch (error) { + showToast(error instanceof Error ? error.message : String(error), "error"); + return true; + } +} + +async function initialRouteFromInput(input) { + if (input.route) return String(input.route).startsWith("#") ? input.route : `#${input.route}`; + const repository = input.repository ?? bootstrapState.prefs.repository; + if (input.artifactId && input.repository) { + return `#/artifact/${encodeURIComponent(repository)}/${Number(input.pullNumber ?? 0)}/${Number(input.artifactId)}`; + } + if (input.url) { + const parsed = await api("/api/targets/parse", { method: "POST", body: { input: input.url, repository } }); + if (parsed.target?.kind === "url") { + return browserHash({ url: parsed.target.url, preset: input.preset, width: input.width, height: input.height, zoom: input.zoom }); + } + return parsed.route; + } + if (input.pullNumber && input.repository) return pullHash(repository, input.pullNumber); + if (input.repository) return pullsHashForRepository(repository); + return null; +} + +/* ---------- connection and restart ---------- */ + +function setConnectionState(connected) { + const el = document.getElementById("connection-state"); + if (!el) return; + el.dataset.state = connected ? "connected" : "reconnecting"; + el.textContent = connected ? "Connected" : "Reconnecting…"; + el.hidden = connected; +} + +function handleRestartEvent() { + setConnectionState(false); + showToast("Restarting the canvas. Running downloads continue in the background."); +} + +document.addEventListener("DOMContentLoaded", () => { + installDisclosurePopover("app-options", "app-options-button"); + document.getElementById("app-options")?.addEventListener("click", (event) => { + if (event.target instanceof Element && event.target.closest("a, button")) { + document.getElementById("app-options").hidePopover(); + } + }); + const updateNavigation = () => { + for (const [id, route] of [["browser-link", "#/browser"], ["docs-link", "#/docs"]]) { + const link = document.getElementById(id); + if (location.hash.startsWith(route)) link?.setAttribute("aria-current", "page"); + else link?.removeAttribute("aria-current"); + } + }; + window.addEventListener("hashchange", updateNavigation); + updateNavigation(); + document.getElementById("restart-button")?.addEventListener("click", async (event) => { + const button = event.currentTarget; + button.disabled = true; + try { + const result = await api("/api/restart", { method: "POST", body: {} }); + showToast(`Restarting. ${result.jobsPreserved ?? 0} running job(s) will continue.`); + let attempts = 0; + const poll = async () => { + attempts += 1; + try { + await api("/api/jobs"); + setConnectionState(true); + button.disabled = false; + void renderRoute({ force: true }); + } catch { + if (attempts < 40) setTimeout(poll, 500); + else { + button.disabled = false; + showToast("The canvas did not come back. Use the Restart canvas action or reopen it.", "error"); + } + } + }; + setTimeout(poll, 600); + } catch (error) { + button.disabled = false; + showToast(error instanceof Error ? error.message : String(error), "error"); + } + }); +}); + +/* ---------- jobs and soft limits ---------- */ + +function handleSnapshotEvent(snapshot) { + jobsById.clear(); + for (const job of snapshot.jobs ?? []) jobsById.set(job.id, job); + jobWarnings = snapshot.warnings ?? []; + if (snapshot.persistError) jobWarnings = [...jobWarnings, `Settings could not be saved: ${snapshot.persistError}`]; + renderJobPanel(); +} + +function handleJobEvent(job) { + const wasActive = jobsById.get(job.id)?.status === "running"; + jobsById.set(job.id, job); + if (job.kind !== "stream" && job.progress) updateArtifactDownloadProgress({ artifactId: job.artifactId, artifactName: job.artifactName, stage: job.stage, ...job.progress }); + if (job.status !== "running") { + jobWaiters.get(job.id)?.forEach((resolve) => resolve(job)); + jobWaiters.delete(job.id); + if (wasActive && job.kind === "stream" && job.status === "succeeded") jobsById.delete(job.id); + } + renderJobPanel(); +} + +function waitForJob(id) { + return new Promise((resolve) => { + const current = jobsById.get(id); + if (current && current.status !== "running") return resolve(current); + const list = jobWaiters.get(id) ?? []; + list.push(resolve); + jobWaiters.set(id, list); + const poll = async () => { + if (!jobWaiters.get(id)?.includes(resolve)) return; + try { + const { job } = await api(`/api/jobs/${encodeURIComponent(id)}`); + if (job && job.status !== "running") { + jobsById.set(id, job); + jobWaiters.get(id)?.forEach((fn) => fn(job)); + jobWaiters.delete(id); + renderJobPanel(); + return; + } + } catch { + /* the SSE stream will deliver the result after reconnect */ + } + setTimeout(poll, 3000); + }; + setTimeout(poll, 3000); + }); +} + +function formatLimitValue(value, unit) { + if (unit === "bytes") return formatBytes(value); + if (unit === "seconds") return `${value}s`; + return Number(value).toLocaleString(); +} + +function installJobPanel() { + if (jobPanel) return; + jobPanel = document.createElement("aside"); + jobPanel.className = "job-panel"; + jobPanel.setAttribute("aria-label", "Background jobs"); + jobPanel.setAttribute("aria-live", "polite"); + jobPanel.hidden = true; + document.body.append(jobPanel); + jobPanel.addEventListener("click", (event) => { + const button = event.target instanceof Element ? event.target.closest("[data-job-action]") : null; + if (!button) return; + const id = button.dataset.jobId; + const action = button.dataset.jobAction; + if (action === "cancel") void jobCommand(id, "cancel"); + else if (action === "retry") void retryJob(id); + else if (action === "dismiss") { + jobsById.delete(id); + renderJobPanel(); + } + }); + jobPanel.addEventListener("submit", (event) => { + const form = event.target; + if (!(form instanceof HTMLFormElement) || !form.dataset.limitKind) return; + event.preventDefault(); + void submitLimit(form); + }); +} + +async function jobCommand(id, command) { + try { + await api(`/api/jobs/${encodeURIComponent(id)}/${command}`, { method: "POST", body: {} }); + } catch (error) { + showToast(error instanceof Error ? error.message : String(error), "error"); + } +} + +async function retryJob(id) { + const job = jobsById.get(id); + if (!job || job.kind === "stream") return; + try { + const started = await api("/api/artifacts/inspect", { + method: "POST", + body: { artifactId: job.artifactId, repository: job.repository }, + }); + jobsById.set(started.job.id, started.job); + if (started.job.id !== id) jobsById.delete(id); + renderJobPanel(); + showToast("Retrying. A completed download is reused instead of fetched again."); + } catch (error) { + showToast(error instanceof Error ? error.message : String(error), "error"); + } +} + +async function submitLimit(form) { + const kind = form.dataset.limitKind; + const unit = form.dataset.limitUnit; + const raw = Number(new FormData(form).get("value")); + const value = unit === "bytes" ? Math.round(raw * 1024 * 1024) : Math.round(raw); + const response = await fetch("/api/limits", { + method: "PUT", + headers: { "content-type": "application/json", "x-pr-artifact-explorer-token": capabilityToken }, + body: JSON.stringify({ kind, value }), + }); + const payload = await response.json().catch(() => ({})); + if (response.status === 409) { + showToast(`That is below the current live value. The new minimum is ${formatLimitValue(payload.minimum, unit)}.`, "error"); + const input = form.querySelector("input"); + if (input) input.min = String(unit === "bytes" ? Math.ceil(payload.minimum / 1048576) : payload.minimum); + return; + } + if (!response.ok) { + showToast(payload.error ?? "The limit could not be saved.", "error"); + return; + } + showToast(`${LIMIT_LABELS[kind] ?? kind} limit raised. Work was not interrupted.`); + if (payload.limits) handleSnapshotLimits(payload.limits); +} + +const LIMIT_LABELS = { + downloadBytes: "Download size", + zipEntries: "ZIP entries", + centralDirectoryBytes: "ZIP directory size", + streamedEntryBytes: "Decompressed file size", + idleSeconds: "Idle warning", +}; + +function handleSnapshotLimits() { + renderJobPanel(); +} + +function jobCardHtml(job) { + const active = job.status === "running"; + const pct = Number.isFinite(job.progress?.percent) ? Math.max(0, Math.min(100, job.progress.percent)) : null; + const title = job.kind === "stream" ? `Decompressing ${job.artifactName}` : job.artifactName; + const prompts = (job.prompts ?? []) + .map((prompt) => { + const min = prompt.unit === "bytes" ? Math.ceil(prompt.minimum / 1048576) : prompt.minimum; + const unitLabel = prompt.unit === "bytes" ? "MiB" : prompt.unit === "seconds" ? "seconds" : ""; + return `
+
${escapeHtml(prompt.label)} is ${escapeHtml(formatLimitValue(prompt.current, prompt.unit))}, above your ${escapeHtml(formatLimitValue(prompt.limit, prompt.unit))} warning. ${active ? "Work is continuing." : ""} Allow a larger value (at least ${escapeHtml(formatLimitValue(prompt.minimum, prompt.unit))}).
+ + +
`; + }) + .join(""); + const status = { running: "Running", succeeded: "Done", failed: "Failed", cancelled: "Cancelled", interrupted: "Interrupted" }[job.status] ?? job.status; + return `
+ ${escapeHtml(title)} +
${escapeHtml(status)}${job.stage && active ? ` · ${escapeHtml(job.stage)}` : ""}${job.attempt > 1 ? ` · attempt ${job.attempt}` : ""}
+ ${active ? `` : ""} + ${job.error ? `
${escapeHtml(job.error)}
` : ""} + ${prompts} +
+ ${active ? `` : ""} + ${!active && job.kind !== "stream" && job.status !== "succeeded" ? `` : ""} + ${!active ? `` : ""} +
+
`; +} + +function renderJobPanel() { + if (!jobPanel) return; + const visible = [...jobsById.values()].filter((job) => job.status === "running" || job.status === "failed" || job.status === "interrupted" || (job.prompts?.length ?? 0) > 0); + const warnings = jobWarnings.map((text) => `
${escapeHtml(text)}
`).join(""); + jobPanel.hidden = visible.length === 0 && !warnings; + if (jobPanel.contains(document.activeElement) && document.activeElement.tagName === "INPUT") return; + jobPanel.innerHTML = `${warnings}${visible.map(jobCardHtml).join("")}`; +} + +/* ---------- docs ---------- */ + +const SHORTCUT_REFERENCE = `
+
?
Show or hide shortcuts
+
g then d
Open Docs
+
g then b
Open Browser
+
/
Focus the address box
+
Alt + ← / →
Go back / forward
+
Ctrl + R
Refresh the preview
+
+ / − / 0
Zoom in / out / reset
+
Shift + S
Take a screenshot
+
Shift + C
Toggle controlled browser
+
`; + +function docsFigure(filename, alt, caption, width, height) { + const altText = String(alt).replaceAll("&", "&").replaceAll('"', """).replaceAll("<", "<").replaceAll(">", ">"); + return `
${altText}
${caption}
`; +} + +const DOCS_SECTIONS = [ + ["overview", "Getting started", ` +

Start with the change you want to understand. Open a pull request, inspect its build artifacts, or bring a local website into the browser—without leaving the canvas.

+

Your first look

+
    +
  1. Find your repository. Use the field in the header to enter owner/repository, or paste a GitHub pull request URL. You can also open Browser and enter a request such as open PR 123 in github/awesome-copilot.
    2. +
  2. Open the pull request. Choose a change from the list to see its workflow artifacts. An issue URL opens issue details instead; issues do not have PR artifacts.
    3. +
  3. Choose what to inspect. Open an artifact to browse its files or preview a supported file. A website artifact can open in Browser for a closer look at different screen sizes.
    4. +
+

Artifact Explorer reads build outputs. It does not run artifact programs, install their dependencies, or execute their build scripts.

+

Already have a page running?

+

Open Browser, enter an HTTP(S) or localhost URL, and press Enter. Keep your development server running on the same machine as the preview service.

+ ${docsFigure("preview-controls", "Artifact Explorer previewing a sample localhost website, with Mobile selected and compact navigation, zoom, Screenshot and Options controls.", "The redesigned browser, showing a sample localhost page and illustrative account/repository metadata.", 882, 480)} +
Where next?Open a PR or artifactPreview a local website
`], + ["artifacts", "PRs and artifacts", ` +

Move from a proposed change to the files it produced. A repository, PR URL, artifact link, or plain-language request can be your starting point.

+

Open a pull request

+
    +
  1. Choose a repository. Enter github/awesome-copilot in the header, or use the repository quick switch. Pins and favorites make frequently used repositories easier to return to.
    2. +
  2. Find the change. Select a pull request from the list. To go straight to one, paste its GitHub URL or enter open PR 123 in Browser using the current repository context.
    3. +
  3. Inspect an artifact. Choose an available workflow artifact, then browse the file list. Select a supported file to read, watch, or preview it.
    4. +
+

Jump straight to an artifact

+

Paste a GitHub artifact URL or an Explorer share route into the address field. Explorer resolves the target; you do not need to reconstruct its local preview address.

+

When an artifact is missing

+

Check that the workflow completed and uploaded an artifact. Availability also depends on your account’s repository access and the artifact’s retention period. Keep the original workflow or PR open when you need to confirm those details.

+
Keep exploringShare a specific viewUnderstand background downloads
`], + ["browser", "Pages and device sizes", ` +

See the page, not a wall of controls. The address bar handles navigation; the second row gives you device size, visual zoom, and a screenshot.

+

Preview a local or published page

+
    +
  1. Start your site. Keep your local development server running, or use an existing HTTP(S) address.
    2. +
  2. Open Browser. Enter a URL such as http://localhost:3000 and press Enter. A short localhost address such as localhost:3000 works too.
    3. +
  3. Navigate. Use Back, Forward, and Refresh for addresses opened through the toolbar. Use the page’s own controls for navigation inside an embedded page; cross-origin history is not observable by Explorer.
    4. +
+

Size and zoom do different jobs

+

Device size changes the layout. Mobile uses 390 × 844 CSS pixels, Tablet 768 × 1024, and Desktop 1440 × 900. Native follows the panel. Choose Custom to reveal width and height in Options; Rotate switches orientation.

+

Zoom changes only what you see. The − and + buttons scale the preview without changing its CSS viewport. In Options, Fit makes it fit the available width, and 100% resets the visual scale.

+ ${docsFigure("preview-controls", "Mobile preview controls with visual zoom separate from the device preset.", "Sample mobile preview: the device sets the page layout; zoom adjusts its display size.", 882, 480)} +

If the page will not embed

+

Some sites deliberately refuse to appear in an iframe. Explorer reports the restriction rather than bypassing it. Open Options → Controlled browser to use an isolated Chromium view with its own real history.

+
NextCapture the right page stateFix a blank or unavailable preview
`], + ["sharing", "Sharing a view", ` +

Give a teammate the change and the view you meant—not a temporary local address they cannot open.

+

Share the preview

+
    +
  1. Set up the view. Open the page or website artifact and choose its device preset, custom size, and zoom.
    2. +
  2. Copy its route. Open Options → Copy share link. Explorer includes the view settings. For a website artifact, it uses the stable artifact route instead of the local preview port.
    3. +
  3. Open it in Explorer. Your teammate can paste the copied route into the address field. They still need access to the repository and an available artifact. A shared localhost URL needs a running server on their own machine.
    4. +
+

Share the GitHub context

+

The copy button beside a title copies the title alone. The linked #number opens the canonical GitHub issue or PR; its adjacent copy button copies that GitHub link. Use those when the conversation is about the change rather than a particular preview.

+

If clipboard access is blocked

+

Explorer offers a manual-copy dialog with selectable text. Copy that text using your browser’s standard shortcut, then close the dialog. The route is the same one the copy action would have written.

+
NextAttach visual evidence
`], + ["screenshots", "Taking screenshots", ` +

A useful screenshot tells the reviewer what they are seeing. Choose the viewport first, and be clear about whether you captured a fresh render or the controlled browser’s current state.

+

Capture a page

+
    +
  1. Open the address. Choose the device preset or custom dimensions you want to document. Visual zoom does not change the capture’s viewport.
    2. +
  2. Choose the capture mode. Normal Browser loads the URL fresh in headless Chromium. Options → Controlled browser captures the isolated browser’s current page state instead.
    3. +
  3. Select Screenshot. The saved result appears below the preview. Its caption identifies the capture mode, viewport, and saved file path; use the thumbnail link to download it.
    4. +
+ ${docsFigure("preview-options", "Preview Options showing viewport dimensions, Rotate, Fit, 100%, Controlled browser, Copy share link and Keyboard shortcuts, with Screenshot visible in the toolbar.", "Options keeps secondary controls together. This capture uses a sample localhost page and illustrative account metadata.", 882, 480)} +

Fresh render or current state?

+

Fresh render starts from the address again. It does not include an unsaved form, scroll position, or other live iframe state. Explorer cannot read that state across origins.

+

Controlled current state captures the isolated Chromium session, not the embedded iframe. A form edited only in the iframe is not transferred when you switch modes.

+
Set up Chromium if capture is unavailable

Setup is explicit; Explorer does not install anything silently. Use an existing Playwright installation, or run npm install playwright and npx playwright install chromium in the intended environment.

You can set PR_ARTIFACT_EXPLORER_PLAYWRIGHT to an existing Playwright installation and PR_ARTIFACT_EXPLORER_CHROMIUM to a Chromium or Chrome executable. Installed Chrome and Edge are tried as a fallback.

Files are saved in the session’s artifact-explorer-screenshots folder.

`], + ["jobs", "Work that keeps going", ` +

You can keep reviewing while an artifact downloads. Downloads, extraction, and indexing run as background jobs; leaving the page or restarting the canvas does not cancel them.

+

A warning is not a stop sign

+

Soft limits flag work larger or slower than your current warning settings: download size, ZIP entry count, directory size, decompressed file size, and idle time. When a limit is crossed, the job panel shows the live value and work continues.

+
    +
  1. Read the live minimum. The prompt shows what the job has already reached. That number can rise while you decide.
    2. +
  2. Allow a larger value. Enter a new limit at least as large as the current minimum, then select Allow larger. If the live value has overtaken your entry, Explorer shows the new minimum.
    3. +
  3. Continue reviewing—or cancel deliberately. Navigate elsewhere while the job progresses. Use Cancel only when you want to stop that job.
    4. +
+ ${docsFigure("continuing-job", "A running sample site-preview download at 65%, with a Download size warning, a live minimum of 272 MiB, an Allow larger action and a separate Cancel button.", "Illustrative job data: the sample download has exceeded a 256 MiB warning. Its live minimum is 272 MiB; work is still continuing.", 420, 257)} +

What can actually stop a job?

+

Cancel is explicit. Corrupt archives, CRC mismatches, unsafe paths, integrity failures, and a real lack of disk space are true errors—not warnings that can be dismissed by raising a limit.

+

After an interruption

+

An unexpected exit can leave a job marked Interrupted. Choose Retry to resume the workflow; a completed download can be reused. Failed jobs keep their error visible so you can fix the cause before retrying.

+
Need to reconnect?Restart and recover safely
`], + ["recovery", "Troubleshooting", ` +

Start with the message beside the preview or job. It usually tells you whether to check the server, change browser mode, or retry the work.

+

The preview is blank or unreachable

+
    +
  1. Check the address. Use HTTP(S), confirm the port, and keep the local server running on the preview service’s machine.
    2. +
  2. Refresh the page. Use the browser row’s Refresh action after the server is ready.
    3. +
  3. Read an embedding warning. If the site refuses iframes, choose Options → Controlled browser. Raising a download limit cannot fix an embedding restriction.
    4. +
+

The canvas is reconnecting

+

Wait for the connection to return. If you need a clean canvas restart, open More → Restart canvas. Running downloads continue independently; restart is not a substitute for Cancel.

+

A job failed or an artifact is unavailable

+

Check the error, repository access, workflow result, and artifact retention. For a recoverable failed or interrupted job, use Retry. Integrity and disk-space errors need their underlying cause resolved first.

+

A screenshot failed

+

Open a reachable address before capturing, and check Chromium availability. See Taking screenshots for explicit setup and the difference between fresh and current-state captures.

`], + ["shortcuts", "Keyboard shortcuts", ` +

Keep common actions close at hand. These shortcuts work when focus is in the Explorer, outside a text field—not inside the previewed website.

+ ${SHORTCUT_REFERENCE} +

Navigate without a mouse

+

Use Tab to move through the header, address bar, and preview controls. Open Options or More with Enter, then Tab through their actions. Escape closes the menu and returns focus to its trigger.

+

The g shortcuts are a sequence: press g, then the second key. Browser navigation, zoom, and capture shortcuts apply while Browser is open.

+
New here?Start with a guided first lookLearn the preview controls
`], +]; + +function renderDocs(route) { + const active = DOCS_SECTIONS.some(([id]) => id === route.section) ? route.section : DOCS_SECTIONS[0][0]; + setBreadcrumbs([{ label: "Artifact Explorer", href: pullsHashForRepository(bootstrapState.prefs.repository) }, { label: "Docs" }]); + const [, , html] = DOCS_SECTIONS.find(([id]) => id === active); + view.innerHTML = `
+ +

${escapeHtml(DOCS_SECTIONS.find(([id]) => id === active)[1])}

${html}
+
`; + window.scrollTo({ top: 0, left: 0, behavior: "instant" }); + document.getElementById("docs-topic").addEventListener("change", (event) => { + location.hash = `#/docs/${event.target.value}`; + }); + const searchText = new Map(DOCS_SECTIONS.map(([id, label, body]) => { + const plain = new DOMParser().parseFromString(body, "text/html").body.textContent; + return [id, `${label} ${plain}`.toLocaleLowerCase()]; + })); + document.getElementById("docs-search").addEventListener("input", (event) => { + const query = event.target.value.trim().toLocaleLowerCase(); + const words = query.split(/\s+/).filter(Boolean); + let count = 0; + for (const link of view.querySelectorAll("[data-doc-topic]")) { + const matches = words.every(word => searchText.get(link.dataset.docTopic).includes(word)); + link.hidden = !matches; + if (matches) count += 1; + } + view.querySelector(".docs-nav").dataset.searching = String(Boolean(query)); + const status = document.getElementById("docs-search-status"); + status.hidden = !query; + status.textContent = count ? `${count} matching topic${count === 1 ? "" : "s"}` : "No matching topics. Try “preview”, “share”, or “limits”."; + }); +} + +/* ---------- issue ---------- */ + +async function renderIssue(route, sequence) { + setBreadcrumbs([{ label: route.repository, href: pullsHashForRepository(route.repository) }, { label: `Issue #${route.issueNumber}` }]); + loadingView(); + const payload = await api(`/api/issues/${route.issueNumber}?repo=${encodeURIComponent(route.repository)}`); + if (sequence !== renderSequence) return; + const issue = payload.issue; + const pullLink = issue.isPullRequest ? `

This is a pull request. Open its artifacts.

` : ""; + view.innerHTML = `
+ ${pageTitleHtml(issue.title, issue.number, issue.url)} +

${escapeHtml(issue.state)} · opened by ${escapeHtml(issue.author ?? "unknown")} · ${issue.comments} comment(s)

+ ${issue.labels.length ? `

${issue.labels.map((l) => `${escapeHtml(l)}`).join(" ")}

` : ""} + ${pullLink} + 
${escapeHtml(issue.body)}
+
`; +} + +/* ---------- browser preview ---------- */ + +function disposeBrowser() { + browserCleanup?.(); + browserCleanup = null; + browserState = null; +} + +function clampZoom(value) { + return Math.min(ZOOM_MAX, Math.max(ZOOM_MIN, Math.round(value * 100) / 100)); +} + +function installDisclosurePopover(panelId, triggerId) { + const panel = document.getElementById(panelId); + const trigger = document.getElementById(triggerId); + if (!panel || !trigger) return () => {}; + const position = (opening = false) => { + if (opening !== true && !panel.matches(":popover-open")) return; + const rect = trigger.getBoundingClientRect(); + const width = panel.offsetWidth || Number.parseFloat(getComputedStyle(panel).width) || 320; + panel.style.maxHeight = `${Math.max(120, window.innerHeight - rect.bottom - 16)}px`; + panel.style.top = `${rect.bottom + 6}px`; + panel.style.left = `${Math.max(8, Math.min(rect.right - width, window.innerWidth - width - 8))}px`; + }; + const toggle = (event) => { + trigger.setAttribute("aria-expanded", String(event.newState === "open")); + position(); + }; + const restoreFocus = (event) => { + if (event.newState === "open") position(true); + if (event.newState === "closed" && panel.contains(document.activeElement)) trigger.focus(); + }; + const dismiss = (event) => { + if (event.key !== "Escape" || !panel.matches(":popover-open") || document.querySelector("dialog[open]")) return; + event.preventDefault(); + event.stopImmediatePropagation(); + panel.hidePopover(); + trigger.focus(); + }; + panel.addEventListener("beforetoggle", restoreFocus); + panel.addEventListener("toggle", toggle); + window.addEventListener("resize", position); + document.addEventListener("keydown", dismiss, true); + return () => { + panel.removeEventListener("toggle", toggle); + panel.removeEventListener("beforetoggle", restoreFocus); + window.removeEventListener("resize", position); + document.removeEventListener("keydown", dismiss, true); + }; +} + +function renderBrowser(route) { + disposeBrowser(); + const initial = decodeViewClient(route.query.get("v")); + const preset = BROWSER_PRESETS[initial.preset] ? initial.preset : localStorage.getItem("pae.preset") || "native"; + browserState = { + url: initial.url ?? "", + preset: BROWSER_PRESETS[preset] ? preset : "native", + width: initial.width ?? BROWSER_PRESETS.custom.width, + height: initial.height ?? BROWSER_PRESETS.custom.height, + zoom: Number.isFinite(initial.zoom) ? clampZoom(initial.zoom) : 1, + fit: !Number.isFinite(initial.zoom), + orientation: initial.orientation === "landscape" ? "landscape" : "portrait", + history: [], + index: -1, + shots: [], + probe: null, + controlled: false, + }; + setBreadcrumbs([{ label: "Artifact Explorer", href: pullsHashForRepository(bootstrapState.prefs.repository) }, { label: "Browser" }]); + const state = browserState; + view.innerHTML = `
+

Browser preview

+
+
+ + + +
+
+
+ +
+ + + +
+ + + +
+
+
+
+

Viewport

+
+ +
+ + + +
+
+
+ +

Use for sites that refuse embedding. Screenshots capture the current page state.

+
+
+ + + +
+
+ +
+
Open a page

Enter an HTTP(S) or localhost URL in the address bar, or open a website artifact.

+
+
+
+
`; + + const $ = (id) => document.getElementById(id); + const frame = $("br-frame"); + const stage = $("br-stage"); + const cframe = $("br-cframe"); + const disposeOptions = installDisclosurePopover("br-options", "br-options-button"); + let controlledKey = ""; + + function viewport() { + const p = BROWSER_PRESETS[state.preset]; + let w = state.preset === "custom" ? state.width : p.width; + let h = state.preset === "custom" ? state.height : p.height; + if (state.preset === "native") { + // Native follows the panel size only; zoom never changes the emulated viewport. + w = Math.max(320, Math.floor(stage.clientWidth - 34)); + h = Math.max(480, Math.floor(window.innerHeight * 0.7)); + } else if (state.orientation === "landscape") { + [w, h] = [h, w]; + } + return { w, h }; + } + + function applyLayout() { + const { w, h } = viewport(); + if (state.fit && state.preset !== "native") state.zoom = clampZoom(Math.min(1, (stage.clientWidth - 34) / w)); + if (state.preset === "native" && state.fit) state.zoom = 1; + for (const el of [frame, cframe]) { + el.style.width = `${w}px`; + el.style.height = `${h}px`; + el.style.transform = `scale(${state.zoom})`; + el.classList.toggle("is-mobile", state.preset === "mobile"); + } + frame.hidden = state.controlled; + cframe.hidden = !state.controlled; + const box = $("br-box"); + box.style.width = `${w * state.zoom}px`; + box.style.height = `${h * state.zoom}px`; + $("br-zoom-label").textContent = `${Math.round(state.zoom * 100)}%`; + $("br-width").disabled = $("br-height").disabled = state.preset !== "custom"; + $("br-dimensions").hidden = state.preset !== "custom"; + $("br-rotate").disabled = state.preset === "native"; + $("br-rotate").setAttribute("aria-pressed", String(state.orientation === "landscape")); + $("br-fit").setAttribute("aria-pressed", String(state.fit)); + $("br-zoom-out").disabled = state.zoom <= ZOOM_MIN; + $("br-zoom-in").disabled = state.zoom >= ZOOM_MAX; + $("br-empty").hidden = Boolean(state.url); + box.hidden = !state.url; + $("br-back").disabled = !state.controlled && state.index <= 0; + $("br-forward").disabled = !state.controlled && state.index >= state.history.length - 1; + $("br-controlled").setAttribute("aria-pressed", String(state.controlled)); + const key = `${state.preset}:${w}x${h}`; + if (state.controlled && controlledKey && key !== controlledKey) void syncControlled(); + controlledKey = key; + const dpr = BROWSER_PRESETS[state.preset].dpr; + $("br-status").textContent = `${w} × ${h} CSS px${dpr > 1 ? ` · ${dpr}× screenshot pixels` : ""}`; + localStorage.setItem("pae.preset", state.preset); + void api("/api/browser/state", { method: "POST", body: { url: state.url, preset: state.preset, width: w, height: h, zoom: state.zoom } }).catch(() => {}); + if (location.hash.startsWith("#/browser")) { + const next = browserHash({ url: state.url || undefined, preset: state.preset, width: state.preset === "custom" ? state.width : undefined, height: state.preset === "custom" ? state.height : undefined, zoom: state.fit ? undefined : state.zoom }); + history.replaceState(null, "", next); + } + } + + const controlledBody = () => { + const { w, h } = viewport(); + return { preset: state.preset === "native" ? "custom" : state.preset, width: w, height: h }; + }; + + async function showControlledFrame() { + const res = await fetch("/api/controlled/frame", { + method: "POST", + headers: { "x-pr-artifact-explorer-token": capabilityToken, "Content-Type": "application/json" }, + body: "{}", + }); + if (!res.ok) throw new Error(`Controlled view failed (${res.status}).`); + const previous = cframe.src; + cframe.src = URL.createObjectURL(await res.blob()); + if (previous.startsWith("blob:")) URL.revokeObjectURL(previous); + } + + async function controlledCall(action, body = {}) { + try { + const { controlled } = await api(`/api/controlled/${action}`, { method: "POST", body }); + if (browserState !== state) return; + if (controlled?.url) { + state.url = controlled.url; + $("br-address").value = controlled.url; + } + await showControlledFrame(); + applyLayout(); + } catch (error) { + $("br-notice").hidden = false; + $("br-notice").textContent = error instanceof Error ? error.message : String(error); + } + } + + const syncControlled = () => controlledCall("viewport", controlledBody()); + + async function setControlled(on) { + state.controlled = on; + $("br-notice").hidden = true; + applyLayout(); + if (on && state.url) await controlledCall("navigate", { url: state.url, ...controlledBody() }); + else if (!on && state.url) frame.src = state.url; + else if (on) showToast("Controlled browser is ready. Enter an address."); + } + + async function load(url, { push = true } = {}) { + state.url = url; + $("br-address").value = url; + const notice = $("br-notice"); + notice.hidden = true; + if (state.controlled) { + if (push) { + state.history = state.history.slice(0, state.index + 1); + state.history.push(url); + state.index = state.history.length - 1; + } + applyLayout(); + if (url) await controlledCall("navigate", { url, ...controlledBody() }); + return; + } + if (push) { + state.history = state.history.slice(0, state.index + 1); + state.history.push(url); + state.index = state.history.length - 1; + } + applyLayout(); + if (!url) { + frame.removeAttribute("src"); + return; + } + try { + const probe = await api("/api/probe", { method: "POST", body: { url } }); + if (browserState !== state) return; + if (!probe.reachable) { + notice.hidden = false; + notice.textContent = `${probe.reason} Check that the server is running, then press Refresh.`; + } else if (!probe.embeddable) { + notice.hidden = false; + notice.textContent = `${probe.reason} This site refuses to be embedded, so it will appear blank here. The restriction is not bypassed. `; + const open = document.createElement("button"); + open.type = "button"; + open.className = "btn btn-sm"; + open.textContent = "Open in controlled browser"; + open.addEventListener("click", () => void setControlled(true)); + notice.append(open); + } + } catch (error) { + notice.hidden = false; + notice.textContent = error instanceof Error ? error.message : String(error); + } + frame.src = url; + } + + async function submitAddress(text) { + const value = text.trim(); + if (!value) return; + if (/^https?:\/\//i.test(value)) return load(value); + if (/^localhost(:\d+)?(\/|$)/i.test(value) || /^127\.0\.0\.1/.test(value)) return load(`http://${value}`); + await navigateNaturalLanguage(value); + } + + const go = (delta) => { + if (state.controlled) return void controlledCall("history", { direction: delta < 0 ? "back" : "forward" }); + const next = state.index + delta; + if (next < 0 || next >= state.history.length) return; + state.index = next; + void load(state.history[next], { push: false }); + }; + const refresh = () => { + if (state.controlled) return void controlledCall("history", { direction: "refresh" }); + if (!state.url) return; + try { + frame.contentWindow.location.reload(); + } catch { + frame.src = state.url; + } + }; + const setZoom = (value) => { + state.fit = false; + state.zoom = clampZoom(value); + applyLayout(); + }; + const screenshot = async () => { + if (!state.url) return showToast("Open an address first.", "error"); + const button = $("br-shot"); + button.disabled = true; + const { w, h } = viewport(); + try { + const { capture } = state.controlled + ? await api("/api/controlled/screenshot", { method: "POST", body: { fullPage: false } }) + : await api("/api/capture", { + method: "POST", + body: { url: state.url, preset: state.preset === "native" ? "custom" : state.preset, width: w, height: h, fullPage: false }, + }); + const file = capture.path.split(/[\\/]/).pop(); + const src = `/api/screenshots/${file}?token=${encodeURIComponent(capabilityToken)}`; + const res = await fetch(`/api/screenshots/${file}`, { headers: { "x-pr-artifact-explorer-token": capabilityToken } }); + const blobUrl = URL.createObjectURL(await res.blob()); + const figure = document.createElement("figure"); + figure.innerHTML = `Screenshot of ${escapeHtml(capture.finalUrl ?? state.url)}
${capture.source === "controlled-current" ? "Current page state of the controlled Chromium" : "Fresh render (not the live frame's current state)"}, ${capture.viewport?.width ?? w}×${capture.viewport?.height ?? h}. Saved to ${escapeHtml(capture.path)}.
`; + $("br-shots").prepend(figure); + void src; + } catch (error) { + showToast(error instanceof Error ? error.message : String(error), "error"); + } finally { + button.disabled = false; + } + }; + + $("br-form").addEventListener("submit", (event) => { + event.preventDefault(); + void submitAddress($("br-address").value); + }); + $("br-back").addEventListener("click", () => go(-1)); + $("br-forward").addEventListener("click", () => go(1)); + $("br-refresh").addEventListener("click", refresh); + $("br-preset").addEventListener("change", (event) => { + state.preset = event.target.value; + state.fit = true; + applyLayout(); + if (state.preset === "custom") { + $("br-options").showPopover(); + $("br-width").focus(); + } + }); + $("br-width").addEventListener("change", (event) => { + state.width = Number(event.target.value); + applyLayout(); + }); + $("br-height").addEventListener("change", (event) => { + state.height = Number(event.target.value); + applyLayout(); + }); + $("br-rotate").addEventListener("click", () => { + state.orientation = state.orientation === "portrait" ? "landscape" : "portrait"; + applyLayout(); + }); + $("br-zoom-out").addEventListener("click", () => setZoom(state.zoom - ZOOM_STEP)); + $("br-zoom-in").addEventListener("click", () => setZoom(state.zoom + ZOOM_STEP)); + $("br-100").addEventListener("click", () => setZoom(1)); + $("br-fit").addEventListener("click", () => { + state.fit = true; + applyLayout(); + }); + $("br-shot").addEventListener("click", () => void screenshot()); + $("br-controlled").addEventListener("click", () => void setControlled(!state.controlled)); + $("br-copy").addEventListener("click", () => { + const { w, h } = viewport(); + const view = { preset: state.preset, width: state.preset === "custom" ? w : undefined, height: state.preset === "custom" ? h : undefined, zoom: state.fit ? undefined : state.zoom, orientation: state.orientation === "landscape" ? "landscape" : undefined }; + let sourceRoute = null; + try { + sourceRoute = state.url && new URL(state.url, location.href).origin === location.origin ? sessionStorage.getItem("pae.shareRoute") : null; + } catch { + sourceRoute = null; + } + // Artifact previews live on an ephemeral local port, so share the stable artifact route instead. + const route = sourceRoute ? `${sourceRoute}${sourceRoute.includes("?") ? "&" : "?"}v=${encodeViewClient(view)}` : browserHash({ ...view, url: state.url || undefined }); + void copyText(route, sourceRoute ? "Copied artifact share route" : "Copied share route"); + }); + $("br-kbd").addEventListener("click", (event) => { + const hints = $("br-hints"); + hints.hidden = !hints.hidden; + event.currentTarget.setAttribute("aria-pressed", String(!hints.hidden)); + event.currentTarget.setAttribute("aria-expanded", String(!hints.hidden)); + if (!hints.hidden && !$("br-options").matches(":popover-open")) $("br-options").showPopover(); + }); + + const onResize = () => applyLayout(); + window.addEventListener("resize", onResize); + state.api = { go, refresh, setZoom, screenshot, load, applyLayout, viewport, setControlled }; + browserCleanup = () => { + window.removeEventListener("resize", onResize); + disposeOptions(); + }; + + applyLayout(); + if (state.url) void load(state.url); +} + +function handleBrowserCommand(command) { + const state = browserState; + if (!state?.api) { + showToast("Open the Browser tab to use that command.", "error"); + return; + } + switch (command.command) { + case "back": + return state.api.go(-1); + case "forward": + return state.api.go(1); + case "refresh": + return state.api.refresh(); + case "zoom": + if (Number.isFinite(command.zoom)) return state.api.setZoom(command.zoom); + if (command.step) return state.api.setZoom(state.zoom + command.step * 0.25); + if (command.fit) { + state.fit = true; + return state.api.applyLayout(); + } + return undefined; + case "viewport": + if (BROWSER_PRESETS[command.preset]) { + state.preset = command.preset; + state.fit = true; + } + if (Number.isInteger(command.width)) state.width = command.width; + if (Number.isInteger(command.height)) state.height = command.height; + if (Number.isInteger(command.width) || Number.isInteger(command.height)) state.preset = "custom"; + document.getElementById("br-preset").value = state.preset; + document.getElementById("br-width").value = state.width; + document.getElementById("br-height").value = state.height; + return state.api.applyLayout(); + case "screenshot": + return state.api.screenshot(); + case "rotate": + return document.getElementById("br-rotate")?.click(); + default: + return undefined; + } +} + +/* ---------- global shortcuts ---------- */ + +function installGlobalShortcuts() { + let chord = null; + document.addEventListener("keydown", (event) => { + const target = event.target; + const typing = target instanceof HTMLElement && (target.isContentEditable || ["INPUT", "TEXTAREA", "SELECT"].includes(target.tagName)); + if (event.key === "Escape" && typing) { + target.blur(); + return; + } + if (typing || event.ctrlKey || event.metaKey) { + if (event.ctrlKey && event.key.toLowerCase() === "r" && browserState?.api && !typing) { + event.preventDefault(); + browserState.api.refresh(); + } + return; + } + if (event.altKey && browserState?.api) { + if (event.key === "ArrowLeft") { + event.preventDefault(); + browserState.api.go(-1); + } else if (event.key === "ArrowRight") { + event.preventDefault(); + browserState.api.go(1); + } + return; + } + if (chord) { + const next = chord; + chord = null; + if (next === "g" && event.key === "d") location.hash = "#/docs"; + else if (next === "g" && event.key === "b") location.hash = "#/browser"; + return; + } + if (event.key === "g") { + chord = "g"; + setTimeout(() => (chord = null), 1200); + } else if (event.key === "/") { + event.preventDefault(); + (document.getElementById("br-address") ?? repositoryInput)?.focus(); + } else if (event.key === "?") { + const hints = document.getElementById("br-hints"); + if (hints) document.getElementById("br-kbd").click(); + else location.hash = "#/docs/shortcuts"; + } else if (browserState?.api) { + if (event.key === "+" || event.key === "=") browserState.api.setZoom(browserState.zoom + ZOOM_STEP); + else if (event.key === "-") browserState.api.setZoom(browserState.zoom - ZOOM_STEP); + else if (event.key === "0") browserState.api.setZoom(1); + else if (event.key === "S") void browserState.api.screenshot(); + else if (event.key === "C") void browserState.api.setControlled(!browserState.controlled); + } + }); +} diff --git a/extensions/pr-artifact-explorer/assets/docs/continuing-job.png b/extensions/pr-artifact-explorer/assets/docs/continuing-job.png new file mode 100644 index 0000000000000000000000000000000000000000..6dd0621f75c220239f3d389e4d75b9dbadf8041a GIT binary patch literal 14356 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 literal 0 HcmV?d00001 diff --git a/extensions/pr-artifact-explorer/assets/docs/preview-controls.png b/extensions/pr-artifact-explorer/assets/docs/preview-controls.png new file mode 100644 index 0000000000000000000000000000000000000000..07d747e24213b5e20ce0cb58c68ce77a93b19d8e GIT binary patch literal 23207 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 literal 0 HcmV?d00001 diff --git a/extensions/pr-artifact-explorer/assets/docs/preview-options.png b/extensions/pr-artifact-explorer/assets/docs/preview-options.png new file mode 100644 index 0000000000000000000000000000000000000000..a166c0917f9715f4adaa6c949ed330bbecbcc3c5 GIT binary patch literal 38797 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 Ux76}vj=Yd21~;yk>p92%7tH0s`2YX_ literal 0 HcmV?d00001 diff --git a/extensions/pr-artifact-explorer/assets/octicons/arrow-left.svg b/extensions/pr-artifact-explorer/assets/octicons/arrow-left.svg new file mode 100644 index 0000000000..41b279bcde --- /dev/null +++ b/extensions/pr-artifact-explorer/assets/octicons/arrow-left.svg @@ -0,0 +1 @@ + diff --git a/extensions/pr-artifact-explorer/assets/octicons/arrow-right.svg b/extensions/pr-artifact-explorer/assets/octicons/arrow-right.svg new file mode 100644 index 0000000000..85850442a4 --- /dev/null +++ b/extensions/pr-artifact-explorer/assets/octicons/arrow-right.svg @@ -0,0 +1 @@ + diff --git a/extensions/pr-artifact-explorer/assets/octicons/book.svg b/extensions/pr-artifact-explorer/assets/octicons/book.svg new file mode 100644 index 0000000000..5b348ee98f --- /dev/null +++ b/extensions/pr-artifact-explorer/assets/octicons/book.svg @@ -0,0 +1 @@ + diff --git a/extensions/pr-artifact-explorer/assets/octicons/copy.svg b/extensions/pr-artifact-explorer/assets/octicons/copy.svg new file mode 100644 index 0000000000..286640e646 --- /dev/null +++ b/extensions/pr-artifact-explorer/assets/octicons/copy.svg @@ -0,0 +1 @@ + diff --git a/extensions/pr-artifact-explorer/assets/octicons/dash.svg b/extensions/pr-artifact-explorer/assets/octicons/dash.svg new file mode 100644 index 0000000000..b9fe1f7942 --- /dev/null +++ b/extensions/pr-artifact-explorer/assets/octicons/dash.svg @@ -0,0 +1 @@ + diff --git a/extensions/pr-artifact-explorer/assets/octicons/device-camera.svg b/extensions/pr-artifact-explorer/assets/octicons/device-camera.svg new file mode 100644 index 0000000000..bcbb0d7cec --- /dev/null +++ b/extensions/pr-artifact-explorer/assets/octicons/device-camera.svg @@ -0,0 +1 @@ + diff --git a/extensions/pr-artifact-explorer/assets/octicons/device-mobile.svg b/extensions/pr-artifact-explorer/assets/octicons/device-mobile.svg new file mode 100644 index 0000000000..b28d67e8f1 --- /dev/null +++ b/extensions/pr-artifact-explorer/assets/octicons/device-mobile.svg @@ -0,0 +1 @@ + diff --git a/extensions/pr-artifact-explorer/assets/octicons/keyboard.svg b/extensions/pr-artifact-explorer/assets/octicons/keyboard.svg new file mode 100644 index 0000000000..c37218bc61 --- /dev/null +++ b/extensions/pr-artifact-explorer/assets/octicons/keyboard.svg @@ -0,0 +1 @@ + diff --git a/extensions/pr-artifact-explorer/assets/octicons/plus.svg b/extensions/pr-artifact-explorer/assets/octicons/plus.svg new file mode 100644 index 0000000000..2f3ca6ea63 --- /dev/null +++ b/extensions/pr-artifact-explorer/assets/octicons/plus.svg @@ -0,0 +1 @@ + diff --git a/extensions/pr-artifact-explorer/backend-gaps.test.mjs b/extensions/pr-artifact-explorer/backend-gaps.test.mjs new file mode 100644 index 0000000000..910055b408 --- /dev/null +++ b/extensions/pr-artifact-explorer/backend-gaps.test.mjs @@ -0,0 +1,179 @@ +import assert from "node:assert/strict"; +import { mkdtemp, readFile, rm, writeFile } from "node:fs/promises"; +import { tmpdir } from "node:os"; +import { join } from "node:path"; +import { Writable } from "node:stream"; +import test from "node:test"; +import { crc32, deflateRawSync } from "node:zlib"; +import { JobRegistry } from "./jobs.mjs"; +import { LimitPolicy } from "./limits.mjs"; +import { readEntryPrefix, readZipIndex, streamZipEntry } from "./zip.mjs"; + +const u16 = (v) => Buffer.from(Uint16Array.of(v).buffer); +const u32 = (v) => Buffer.from(Uint32Array.of(v).buffer); + +function entryRecords(name, content, { deflate = false } = {}) { + const raw = Buffer.from(content); + const data = deflate ? deflateRawSync(raw) : raw; + const nameBuf = Buffer.from(name); + const checksum = crc32(raw); + const method = deflate ? 8 : 0; + const local = Buffer.concat([ + u32(0x04034b50), u16(20), u16(0), u16(method), u16(0), u16(0x21), + u32(checksum), u32(data.length), u32(raw.length), u16(nameBuf.length), u16(0), nameBuf, data, + ]); + const central = Buffer.concat([ + u32(0x02014b50), u16(20), u16(20), u16(0), u16(method), u16(0), u16(0x21), + u32(checksum), u32(data.length), u32(raw.length), + u16(nameBuf.length), u16(0), u16(0), u16(0), u16(0), u32(0), u32(0), nameBuf, + ]); + return { local, central, data, raw }; +} + +function archive({ local, central }, centralBytes = central, count = 1) { + return Buffer.concat([ + local, centralBytes, + u32(0x06054b50), u16(0), u16(0), u16(count), u16(count), u32(centralBytes.length), u32(local.length), u16(0), + ]); +} + +async function inTemp(fn) { + const dir = await mkdtemp(join(tmpdir(), "backend-gaps-")); + try { + return await fn(dir); + } finally { + await rm(dir, { recursive: true, force: true }); + } +} + +test("central directory records beyond the first 1MiB chunk are validated against the count", () => + inTemp(async (dir) => { + const parts = entryRecords("index.html", "

hi

"); + const padded = Buffer.concat([parts.central, Buffer.alloc(1024 * 1024), parts.central]); + const path = join(dir, "bad.zip"); + await writeFile(path, archive(parts, padded, 1)); + await assert.rejects(readZipIndex(path), /entry count mismatch/i); + + const good = join(dir, "good.zip"); + await writeFile(good, archive(parts)); + assert.equal((await readZipIndex(good)).entries.length, 1); + })); + +test("a directory declaring more entries than it contains is rejected", () => + inTemp(async (dir) => { + const parts = entryRecords("index.html", "x"); + const path = join(dir, "short.zip"); + await writeFile(path, archive(parts, parts.central, 2)); + await assert.rejects(readZipIndex(path), /entry count mismatch/i); + })); + +test("readEntryPrefix inflates a bounded prefix from a streamed source", () => + inTemp(async (dir) => { + const parts = entryRecords("big.txt", "a".repeat(5 * 1024 * 1024), { deflate: true }); + const path = join(dir, "big.zip"); + await writeFile(path, archive(parts)); + const entry = (await readZipIndex(path)).entries[0]; + const prefix = await readEntryPrefix(path, entry, 8 * 1024); + assert.equal(prefix.length, 8 * 1024); + assert.ok(prefix.every((byte) => byte === 0x61)); + })); + +test("streamZipEntry reports live progress and soft-limit crossings without stopping the stream", () => + inTemp(async (dir) => { + const parts = entryRecords("big.txt", "b".repeat(2 * 1024 * 1024), { deflate: true }); + const path = join(dir, "s.zip"); + await writeFile(path, archive(parts)); + const entry = (await readZipIndex(path)).entries[0]; + let received = 0; + const sink = new Writable({ + write(chunk, _enc, cb) { + received += chunk.length; + cb(); + }, + }); + const progress = []; + const warned = []; + await streamZipEntry(path, entry, sink, null, { + softLimit: 1024, + onProgress: (bytes) => progress.push(bytes), + onSoftLimit: (kind, bytes) => warned.push([kind, bytes]), + }); + assert.equal(received, 2 * 1024 * 1024); + assert.ok(progress.length > 0 && progress.at(-1) === received); + assert.ok(warned.length > 0 && warned.every(([kind]) => kind === "streamedEntryBytes")); + })); + +test("tracked decompression streams prompt once past the limit and are submit-checked against live bytes", () => + inTemp(async (dir) => { + const policy = new LimitPolicy(join(dir, "limits.json")); + const registry = new JobRegistry(policy); + const tracker = registry.track({ repository: "a/b", artifactId: 1, name: "x.bin" }); + tracker.update(policy.get("streamedEntryBytes") + 500); + const snap = registry.snapshot(tracker.job); + assert.equal(snap.prompts[0].kind, "streamedEntryBytes"); + assert.throws(() => policy.submit("streamedEntryBytes", policy.get("streamedEntryBytes") + 10), /below|minimum|current/i); + tracker.finish(); + assert.equal(registry.get(tracker.job.id), null); + })); + +test("concurrent limit submits persist deterministically without temp-file races", () => + inTemp(async (dir) => { + const file = join(dir, "limits.json"); + const policy = new LimitPolicy(file); + const base = policy.get("downloadBytes"); + for (let i = 1; i <= 30; i++) policy.submit("downloadBytes", base + i * 1000); + await policy.flush(); + assert.equal(policy.persistError, null); + const disk = JSON.parse(await readFile(file, "utf8")); + assert.equal(disk.downloadBytes ?? disk.limits?.downloadBytes, base + 30_000); + assert.equal(policy.get("downloadBytes"), base + 30_000); + })); + +test("corrupt saved limits surface a recoverable warning and keep defaults", () => + inTemp(async (dir) => { + const file = join(dir, "limits.json"); + await writeFile(file, "{ not json"); + const policy = new LimitPolicy(file); + const defaults = policy.get("downloadBytes"); + await policy.load(); + assert.match(policy.loadWarning, /corrupt/i); + assert.equal(policy.get("downloadBytes"), defaults); + })); + +test("running jobs persist without secrets and recover as interrupted", () => + inTemp(async (dir) => { + const file = join(dir, "jobs.json"); + const policy = new LimitPolicy(join(dir, "limits.json")); + const first = new JobRegistry(policy, { file }); + let release; + const gate = new Promise((resolve) => (release = resolve)); + const job = first.start("acct:a/b:7", { repository: "a/b", artifactId: 7, account: "acct" }, () => gate); + await first.flush(); + const raw = await readFile(file, "utf8"); + assert.ok(!/token/i.test(raw)); + + const second = new JobRegistry(policy, { file }); + await second.load(); + const recovered = second.snapshot(second.get(job.id)); + assert.equal(recovered.status, "interrupted"); + assert.match(recovered.error, /interrupted/i); + assert.equal(recovered.account, "acct"); + await second.flush(); + const retry = second.start("acct:a/b:7", { repository: "a/b", artifactId: 7, account: "acct" }, async () => "ok"); + assert.equal(retry.attempt, 2); + assert.equal(await retry.promise, "ok"); + + release(); + await job.promise; + await first.flush(); + await second.flush(); + })); + +test("a corrupt job history file surfaces a warning", () => + inTemp(async (dir) => { + const file = join(dir, "jobs.json"); + await writeFile(file, "oops"); + const registry = new JobRegistry(new LimitPolicy(join(dir, "limits.json")), { file }); + await registry.load(); + assert.match(registry.loadWarning, /corrupt/i); + })); diff --git a/extensions/pr-artifact-explorer/cache.mjs b/extensions/pr-artifact-explorer/cache.mjs index 58b23a1ff8..1eb46865b7 100644 --- a/extensions/pr-artifact-explorer/cache.mjs +++ b/extensions/pr-artifact-explorer/cache.mjs @@ -13,20 +13,27 @@ import { join } from "node:path"; import { Readable, Transform } from "node:stream"; import { pipeline } from "node:stream/promises"; import { - ARTIFACT_DOWNLOAD_IDLE_TIMEOUT_MS, CACHE_ROOT, - MAX_ARCHIVE_BYTES, + JOBS_FILE, MAX_INLINE_PREVIEW_BYTES, MIN_CACHE_FREE_BYTES, } from "./constants.mjs"; import { CacheMaintenanceCoordinator } from "./cache-coordinator.mjs"; import { analyzeArtifact, hasRootIndexHtml } from "./detector.mjs"; import { getArtifact, openArtifactDownload } from "./github.mjs"; -import { findZipEntry, readEntryPrefix, readZipEntry, readZipIndex } from "./zip.mjs"; +import { JobRegistry } from "./jobs.mjs"; +import { limitPolicy } from "./limits.mjs"; +import { + findZipEntry, + readEntryPrefix, + readZipEntry, + readZipIndex, + streamZipEntry, +} from "./zip.mjs"; -const downloads = new Map(); const indexCache = new Map(); const maintenance = new CacheMaintenanceCoordinator(); +export const jobRegistry = new JobRegistry(limitPolicy, { file: JOBS_FILE }); let reservedDownloadBytes = 0; let metadataWriteSequence = 0; @@ -86,25 +93,7 @@ function formatBytes(value) { async function downloadCapacityBytes() { const filesystem = await statfs(CACHE_ROOT); const available = Number(filesystem.bavail) * Number(filesystem.bsize); - return Math.max( - 0, - Math.min( - MAX_ARCHIVE_BYTES, - available - MIN_CACHE_FREE_BYTES - reservedDownloadBytes, - ), - ); -} - -function assertDownloadFits(bytes, capacity) { - if (!Number.isFinite(bytes) || bytes <= 0) return; - if (bytes > MAX_ARCHIVE_BYTES) { - throw new Error("Artifact exceeds the 4 GiB ZIP download limit."); - } - if (bytes > capacity) { - throw new Error( - `Not enough free disk space to cache this artifact. ${formatBytes(bytes)} is required, with ${formatBytes(capacity)} available after the safety reserve.`, - ); - } + return Math.max(0, available - MIN_CACHE_FREE_BYTES - reservedDownloadBytes); } async function downloadArchive( @@ -113,13 +102,13 @@ async function downloadArchive( artifact, archivePath, onProgress, - externalSignal = null, + signal = null, + onActivity = () => {}, ) { const declaredBytes = Number(artifact.sizeInBytes); let reservedBytes = 0; const reserve = async (totalBytes) => { if (!Number.isFinite(totalBytes) || totalBytes <= reservedBytes) return; - assertDownloadFits(totalBytes, MAX_ARCHIVE_BYTES); const additionalBytes = totalBytes - reservedBytes; const capacity = await downloadCapacityBytes(); if (additionalBytes > capacity) { @@ -136,32 +125,11 @@ async function downloadArchive( }; await reserve(declaredBytes); - const controller = new AbortController(); - if (externalSignal?.aborted) { - controller.abort(externalSignal.reason); - } else if (externalSignal) { - externalSignal.addEventListener("abort", () => controller.abort(externalSignal.reason), { once: true }); - } - let idleTimer; - const resetIdleTimeout = () => { - clearTimeout(idleTimer); - idleTimer = setTimeout(() => { - controller.abort(new Error("Artifact download stalled for 60 seconds.")); - }, ARTIFACT_DOWNLOAD_IDLE_TIMEOUT_MS); - }; - resetIdleTimeout(); - let response; try { - response = await openArtifactDownload(token, repository, artifact.id, { - signal: controller.signal, - }); + response = await openArtifactDownload(token, repository, artifact.id, { signal }); } catch (error) { - clearTimeout(idleTimer); releaseReservation(); - if (controller.signal.aborted && controller.signal.reason instanceof Error) { - throw controller.signal.reason; - } throw error; } @@ -169,8 +137,6 @@ async function downloadArchive( try { await reserve(expectedLength); } catch (error) { - clearTimeout(idleTimer); - controller.abort(error); releaseReservation(); throw error; } @@ -219,17 +185,17 @@ async function downloadArchive( const limiter = new Transform({ transform(chunk, _encoding, callback) { received += chunk.length; - if (received > MAX_ARCHIVE_BYTES) { - callback(new Error("Artifact exceeded the 4 GiB ZIP download limit.")); - return; - } - if (reservedBytes > 0 && received > reservedBytes) { - callback(new Error("Artifact download exhausted the available cache space.")); + onActivity({ downloadBytes: received }); + const proceed = () => { + report(); + callback(null, chunk); + }; + if (received <= reservedBytes) { + proceed(); return; } - resetIdleTimeout(); - report(); - callback(null, chunk); + // The declared size was too small; grow the reservation, still honouring the disk guard. + reserve(received + 64 * 1024 * 1024).then(proceed, (error) => callback(error)); }, }); @@ -238,17 +204,17 @@ async function downloadArchive( Readable.fromWeb(response.body), limiter, createWriteStream(temporary, { flags: "wx" }), + ...(signal ? [{ signal }] : []), ); report(true); await rename(temporary, archivePath); } catch (error) { await rm(temporary, { force: true }); - if (controller.signal.aborted && controller.signal.reason instanceof Error) { - throw controller.signal.reason; + if (signal?.aborted) { + throw signal.reason instanceof Error ? signal.reason : error; } throw error; } finally { - clearTimeout(idleTimer); releaseReservation(); } return { @@ -258,78 +224,126 @@ async function downloadArchive( }; } -async function buildMetadata(token, repository, artifactId, onProgress, signal = null) { - const paths = pathsFor(artifactId); - const artifact = await getArtifact(token, repository, paths.id); - if (artifact.expired) { - throw new Error("This GitHub Actions artifact has expired."); +function downloadMarker(paths) { + return `${paths.archive}.complete.json`; +} + +async function readDownloadMarker(paths, repository) { + try { + const marker = JSON.parse(await readFile(downloadMarker(paths), "utf8")); + const archive = await stat(paths.archive); + if ( + archive.isFile() && + marker.repository === repository && + marker.receivedBytes === archive.size + ) { + return marker; + } + } catch (error) { + if (error?.code !== "ENOENT" && !(error instanceof SyntaxError)) throw error; } + return null; +} +/** + * Downloads (unless a completed ZIP is already present) and indexes an artifact. + * A completed ZIP is never deleted because indexing failed, so retries only redo + * the indexing step. + */ +async function buildMetadata(token, repository, artifactId, job) { + const paths = pathsFor(artifactId); + const signal = job.controller.signal; + const artifact = await getArtifact(token, repository, paths.id); await mkdir(CACHE_ROOT, { recursive: true }); - onProgress?.({ + const progressOf = (patch) => ({ artifactId: artifact.id, artifactName: artifact.name, - stage: "preparing", - receivedBytes: 0, totalBytes: artifact.sizeInBytes, - percent: 0, - bytesPerSecond: 0, - etaSeconds: null, + ...patch, }); - const transfer = await downloadArchive( - token, - repository, - artifact, - paths.archive, - onProgress, - signal, - ); - const compressedBytes = transfer.receivedBytes; - try { - onProgress?.({ - artifactId: artifact.id, + const publish = (progress, live) => { + jobRegistry.update(job, { + stage: progress.stage, + progress, artifactName: artifact.name, + live, + }); + }; + + let marker = await readDownloadMarker(paths, repository); + let transfer; + if (marker) { + transfer = { bytesPerSecond: 0, receivedBytes: marker.receivedBytes, totalBytes: marker.receivedBytes }; + } else { + if (artifact.expired) { + throw new Error("This GitHub Actions artifact has expired."); + } + await removeArtifactFiles(paths); + publish(progressOf({ stage: "preparing", receivedBytes: 0, percent: 0, bytesPerSecond: 0, etaSeconds: null })); + transfer = await downloadArchive( + token, + repository, + artifact, + paths.archive, + (progress) => publish(progress, { downloadBytes: progress.receivedBytes }), + signal, + (live) => jobRegistry.update(job, { live }), + ); + await writeJsonAtomic(downloadMarker(paths), { + repository, + receivedBytes: transfer.receivedBytes, + completedAt: new Date().toISOString(), + }); + } + + const compressedBytes = transfer.receivedBytes; + publish( + progressOf({ stage: "indexing", receivedBytes: compressedBytes, totalBytes: transfer.totalBytes, percent: 100, bytesPerSecond: transfer.bytesPerSecond, etaSeconds: 0, - }); - const index = await readZipIndex(paths.archive); - const PREFIX_BYTES = 8 * 1024; - const analysis = await analyzeArtifact(index, async (entry) => { - return readEntryPrefix(paths.archive, entry, PREFIX_BYTES); - }); - const timestamp = new Date().toISOString(); - const metadata = { - artifact, - repository, - downloadedAt: timestamp, - lastAccessedAt: timestamp, - compressedBytes, - analysis, - }; - await writeJsonAtomic(paths.metadata, metadata); - indexCache.set(paths.id, { archivePath: paths.archive, index }); - onProgress?.({ - artifactId: artifact.id, - artifactName: artifact.name, + }), + { downloadBytes: compressedBytes }, + ); + const index = await readZipIndex(paths.archive, { + softLimits: { + zipEntries: () => limitPolicy.get("zipEntries"), + centralDirectoryBytes: () => limitPolicy.get("centralDirectoryBytes"), + }, + onSoftLimit: (kind, current) => jobRegistry.update(job, { live: { [kind]: current }, activity: false }), + onProgress: () => jobRegistry.update(job, {}), + }); + if (signal.aborted) throw signal.reason; + const PREFIX_BYTES = 8 * 1024; + const analysis = await analyzeArtifact(index, async (entry) => { + if (signal.aborted) throw signal.reason; + return readEntryPrefix(paths.archive, entry, PREFIX_BYTES); + }); + const timestamp = new Date().toISOString(); + const metadata = { + artifact, + repository, + downloadedAt: timestamp, + lastAccessedAt: timestamp, + compressedBytes, + analysis, + }; + await writeJsonAtomic(paths.metadata, metadata); + indexCache.set(paths.id, { archivePath: paths.archive, index }); + publish( + progressOf({ stage: "ready", receivedBytes: compressedBytes, totalBytes: transfer.totalBytes, percent: 100, bytesPerSecond: transfer.bytesPerSecond, etaSeconds: 0, - }); - return metadata; - } catch (error) { - await Promise.all([ - rm(paths.archive, { force: true }), - rm(paths.metadata, { force: true }), - ]); - throw error; - } + }), + ); + return metadata; } async function cachedMetadata(artifactId) { @@ -346,73 +360,54 @@ async function cachedMetadata(artifactId) { return metadata; } -export async function inspectArtifact( - token, - repository, - artifactId, - { onProgress } = {}, -) { +/** + * Starts (or reattaches to) the background job for an artifact. The job runs + * independently of any HTTP request or view; call `retry` semantics by simply + * starting again after a failure. + */ +export async function startArtifactJob(token, repository, artifactId, { account = null } = {}) { const paths = pathsFor(artifactId); while (true) { const barrier = maintenance.inspectionBarrier(paths.id); if (!barrier) break; await barrier; } - const key = `${repository}:${paths.id}`; - const active = downloads.get(key); - if (active) { - if (onProgress) active.listeners.add(onProgress); - try { - return await active.operation; - } finally { - if (onProgress) active.listeners.delete(onProgress); - } - } - - const listeners = new Set(onProgress ? [onProgress] : []); - const emit = (progress) => { - for (const listener of listeners) listener(progress); - }; - const externalController = new AbortController(); - const operation = (async () => { - const existing = await cachedMetadata(paths.id); - if (existing?.repository === repository && existing.analysis) { - existing.lastAccessedAt = new Date().toISOString(); - await writeJsonAtomic(paths.metadata, existing); - emit({ - artifactId: Number(paths.id), - artifactName: existing.artifact?.name ?? `Artifact ${paths.id}`, - stage: "ready", - receivedBytes: existing.compressedBytes, - totalBytes: existing.compressedBytes, - percent: 100, - bytesPerSecond: 0, - etaSeconds: 0, - cached: true, - }); - return existing; - } - if (existing) { + const key = `${account ?? "anonymous"}:${repository}:${paths.id}`; + return jobRegistry.start( + key, + { repository, artifactId: paths.id, account }, + async (job) => { + const existing = await cachedMetadata(paths.id); + if (existing?.repository === repository && existing.analysis) { + existing.lastAccessedAt = new Date().toISOString(); + await writeJsonAtomic(paths.metadata, existing); + jobRegistry.update(job, { + stage: "ready", + artifactName: existing.artifact?.name, + progress: { + artifactId: Number(paths.id), + artifactName: existing.artifact?.name ?? `Artifact ${paths.id}`, + stage: "ready", + receivedBytes: existing.compressedBytes, + totalBytes: existing.compressedBytes, + percent: 100, + bytesPerSecond: 0, + etaSeconds: 0, + cached: true, + }, + }); + return existing; + } indexCache.delete(paths.id); - await removeArtifactFiles(paths); - } - return buildMetadata(token, repository, paths.id, emit, externalController.signal); - })(); - const download = { listeners, operation, abort: () => externalController.abort(new Error("Cache cleared.")) }; - downloads.set(key, download); - try { - return await operation; - } catch (error) { - emit({ - artifactId: Number(paths.id), - stage: "error", - message: error instanceof Error ? error.message : String(error), - }); - throw error; - } finally { - if (downloads.get(key) === download) downloads.delete(key); - listeners.clear(); - } + await rm(paths.metadata, { force: true }); + return buildMetadata(token, repository, paths.id, job); + }, + ); +} + +export async function inspectArtifact(token, repository, artifactId) { + const job = await startArtifactJob(token, repository, artifactId); + return job.promise; } export async function getCachedArtifact(artifactId, { touch = true } = {}) { @@ -445,6 +440,40 @@ export async function getCachedEntry(artifactId, entryPath) { return { metadata, archivePath: paths.archive, index, entry }; } +/** + * Streams a cached entry to `writable`. A tracked stream job appears (with a soft-limit + * prompt) only once the live decompressed size crosses the current limit; the stream + * itself is never stopped by it, only by explicit cancel, a closed client or an + * integrity failure. + */ +export async function streamCachedEntry(context, writable, transform = null) { + const outer = new AbortController(); + let tracker = null; + const ensure = () => { + if (tracker) return; + tracker = jobRegistry.track({ + repository: context.metadata?.repository, + artifactId: context.metadata?.artifact?.id, + name: context.entry.name, + }); + tracker.signal.addEventListener("abort", () => outer.abort(), { once: true }); + }; + const limit = () => limitPolicy.get("streamedEntryBytes"); + if (context.entry.uncompressedSize > limit()) ensure(); + try { + await streamZipEntry(context.archivePath, context.entry, writable, transform, { + signal: outer.signal, + softLimit: limit, + onSoftLimit: ensure, + onProgress: (bytes) => tracker?.update(bytes), + }); + tracker?.finish(); + } catch (error) { + tracker?.finish(error); + throw error; + } +} + export async function readCachedEntry(artifactId, entryPath, maxBytes = MAX_INLINE_PREVIEW_BYTES) { const context = await getCachedEntry(artifactId, entryPath); return { @@ -457,29 +486,45 @@ async function removeArtifactFiles(paths) { await Promise.all([ rm(paths.archive, { force: true }), rm(paths.metadata, { force: true }), + rm(downloadMarker(paths), { force: true }), ]); } -export async function deleteCachedArtifact(artifactId) { +export class JobsActiveError extends Error { + constructor(jobs) { + super("Artifact jobs are still running. Cancel them explicitly to continue."); + this.name = "JobsActiveError"; + this.code = "jobs_active"; + this.jobs = jobs; + } +} + +async function cancelAndSettle(jobs, reason) { + for (const job of jobs) jobRegistry.cancel(job.id, reason); + await Promise.allSettled(jobs.map((job) => job.promise)); +} + +export async function deleteCachedArtifact(artifactId, { cancelJobs = false } = {}) { const paths = pathsFor(artifactId); + const jobs = jobRegistry.activeJobs().filter((job) => job.artifactId === paths.id); + if (jobs.length && !cancelJobs) { + throw new JobsActiveError(jobs.map((job) => jobRegistry.snapshot(job))); + } return maintenance.deleteArtifact(paths.id, async () => { indexCache.delete(paths.id); - const suffix = `:${paths.id}`; - const matches = [...downloads.entries()] - .filter(([key]) => key.endsWith(suffix)) - .map(([, entry]) => entry); - for (const entry of matches) entry.abort?.(); - await Promise.allSettled(matches.map((entry) => entry.operation)); + await cancelAndSettle(jobs, "Artifact deleted."); await removeArtifactFiles(paths); return { deleted: paths.id }; }); } -export async function clearArtifactCache() { +export async function clearArtifactCache({ cancelJobs = false } = {}) { + const jobs = jobRegistry.activeJobs(); + if (jobs.length && !cancelJobs) { + throw new JobsActiveError(jobs.map((job) => jobRegistry.snapshot(job))); + } return maintenance.clearCache(async () => { - const inflight = [...downloads.values()]; - for (const entry of inflight) entry.abort?.(); - await Promise.allSettled(inflight.map((entry) => entry.operation)); + await cancelAndSettle(jobs, "Cache cleared."); indexCache.clear(); await rm(CACHE_ROOT, { recursive: true, force: true }); await mkdir(CACHE_ROOT, { recursive: true }); diff --git a/extensions/pr-artifact-explorer/capture.mjs b/extensions/pr-artifact-explorer/capture.mjs new file mode 100644 index 0000000000..2b4cdee8ad --- /dev/null +++ b/extensions/pr-artifact-explorer/capture.mjs @@ -0,0 +1,346 @@ +import { createRequire } from "node:module"; +import { mkdir, writeFile } from "node:fs/promises"; +import { createHash, randomUUID } from "node:crypto"; +import { join } from "node:path"; +import { DATA_ROOT, EXTENSION_ROOT } from "./constants.mjs"; + +export const SCREENSHOT_ROOT = join(DATA_ROOT, "screenshots"); +let screenshotRoot = SCREENSHOT_ROOT; + +/** Directs screenshot output to the owning session's files area; falls back to the cache root. */ +export function setScreenshotRoot(dir) { + screenshotRoot = dir || SCREENSHOT_ROOT; +} + +export function getScreenshotRoot() { + return screenshotRoot; +} +const SETUP_ENV = "PR_ARTIFACT_EXPLORER_PLAYWRIGHT"; + +export const VIEWPORT_PRESETS = Object.freeze({ + mobile: { label: "Mobile", width: 390, height: 844, deviceScaleFactor: 3, isMobile: true, hasTouch: true }, + tablet: { label: "Tablet", width: 768, height: 1024, deviceScaleFactor: 2, isMobile: true, hasTouch: true }, + desktop: { label: "Desktop", width: 1440, height: 900, deviceScaleFactor: 1, isMobile: false, hasTouch: false }, +}); + +export class CaptureError extends Error { + constructor(code, message) { + super(message); + this.name = "CaptureError"; + this.code = code; + } +} + +export const SETUP_INSTRUCTIONS = [ + "Screenshots need Playwright with a Chromium browser. Nothing is installed automatically.", + `1. In the extension folder run: npm install playwright (or set ${SETUP_ENV} to an existing playwright/playwright-core install path)`, + "2. Install the browser once: npx playwright install chromium", +].join("\n"); + +async function loadPlaywright() { + const candidates = [process.env[SETUP_ENV], EXTENSION_ROOT].filter(Boolean); + for (const base of candidates) { + for (const name of ["playwright", "playwright-core"]) { + try { + const require = createRequire(join(base, "noop.js")); + const resolved = require.resolve(name, { paths: [base] }); + const mod = await import(new URL(`file:///${resolved.replaceAll("\\", "/")}`).href); + const chromium = mod.chromium ?? mod.default?.chromium; + if (chromium) return chromium; + } catch { + // try the next candidate + } + } + // The env var may point straight at a package directory. + try { + const require = createRequire(join(base, "noop.js")); + const mod = require(base); + if (mod?.chromium) return mod.chromium; + } catch { + // fall through to the setup error + } + } + throw new CaptureError("playwright_missing", `Playwright is not available.\n${SETUP_INSTRUCTIONS}`); +} + +export function resolveViewport({ preset, width, height, deviceScaleFactor, orientation } = {}) { + const base = preset && preset !== "native" ? VIEWPORT_PRESETS[preset] : null; + if (preset && preset !== "native" && preset !== "custom" && !base) { + throw new CaptureError("invalid_viewport", `Unknown preset "${preset}". Use native, mobile, tablet, desktop or custom.`); + } + let w = width ?? base?.width ?? 1280; + let h = height ?? base?.height ?? 800; + for (const [label, value] of [["width", w], ["height", h]]) { + if (!Number.isInteger(value) || value < 200 || value > 4000) { + throw new CaptureError("invalid_viewport", `${label} must be an integer between 200 and 4000.`); + } + } + if (orientation === "landscape" && h > w) [w, h] = [h, w]; + if (orientation === "portrait" && w > h) [w, h] = [h, w]; + return { + width: w, + height: h, + deviceScaleFactor: deviceScaleFactor ?? base?.deviceScaleFactor ?? 1, + isMobile: base?.isMobile ?? false, + hasTouch: base?.hasTouch ?? false, + }; +} + +function assertHttpUrl(value) { + let url; + try { + url = new URL(value); + } catch { + throw new CaptureError("invalid_url", "A valid http(s) URL is required."); + } + if (url.protocol !== "http:" && url.protocol !== "https:") { + throw new CaptureError("invalid_url", "Only http and https URLs can be captured."); + } + return url; +} + +async function launchChromium() { + const chromium = await loadPlaywright(); + let browser; + const failures = []; + const attempts = [ + ...(process.env.PR_ARTIFACT_EXPLORER_CHROMIUM + ? [{ executablePath: process.env.PR_ARTIFACT_EXPLORER_CHROMIUM }] + : []), + {}, + { channel: "chrome" }, + { channel: "msedge" }, + ]; + for (const options of attempts) { + try { + browser = await chromium.launch({ headless: true, ...options }); + break; + } catch (error) { + failures.push(error?.message?.split("\n")[0] ?? String(error)); + } + } + if (!browser) { + throw new CaptureError( + "chromium_missing", + `Chromium could not be launched: ${failures[0]}\n${SETUP_INSTRUCTIONS}`, + ); + } + return browser; +} + +async function savePng(png, outputDir) { + await mkdir(outputDir, { recursive: true }); + const file = join(outputDir, `screenshot-${Date.now()}-${randomUUID().slice(0, 8)}.png`); + await writeFile(file, png); + return { path: file, bytes: png.length, sha256: createHash("sha256").update(png).digest("hex") }; +} + +/** + * Renders the URL in a fresh, isolated headless Chromium and saves a PNG. + * This is a NEW render, not a snapshot of the page currently shown in the canvas. + */ +export async function captureScreenshot({ url, fullPage = false, outputDir = getScreenshotRoot(), ...viewportOptions }) { + const target = assertHttpUrl(url); + const viewport = resolveViewport(viewportOptions); + const browser = await launchChromium(); + try { + // A new context has no cookies or profile data and is discarded afterwards. + const context = await browser.newContext({ + viewport: { width: viewport.width, height: viewport.height }, + deviceScaleFactor: viewport.deviceScaleFactor, + isMobile: viewport.isMobile, + hasTouch: viewport.hasTouch, + }); + const page = await context.newPage(); + let status = null; + try { + const response = await page.goto(target.href, { waitUntil: "load", timeout: 30_000 }); + status = response?.status() ?? null; + } catch (error) { + throw new CaptureError("navigation_failed", `Could not load ${target.origin}: ${error?.message?.split("\n")[0] ?? error}`); + } + const png = await page.screenshot({ type: "png", fullPage: Boolean(fullPage) }); + const finalUrl = page.url(); + const dimensions = await page.evaluate(() => ({ + innerWidth: window.innerWidth, + innerHeight: window.innerHeight, + devicePixelRatio: window.devicePixelRatio, + })); + return { + ...(await savePng(png, outputDir)), + source: "fresh-render", + note: "Fresh headless Chromium render of the URL. It does not include unsaved page state from the canvas preview.", + requestedUrl: target.href, + finalUrl, + status, + fullPage: Boolean(fullPage), + viewport, + page: dimensions, + }; + } finally { + await browser.close(); + } +} + +/** + * An explicit, isolated, controlled Chromium: one in-memory context (no persistent profile, + * cookies or logins), real history, device emulation, and screenshots of the CURRENT page. + * Used for sites that refuse to be embedded in an iframe. + */ +export class ControlledBrowser { + #browser = null; + #context = null; + #page = null; + #viewport = null; + #starting = null; + + get active() { + return Boolean(this.#page); + } + + async #ensure(viewportOptions) { + if (this.#page) return; + this.#starting ??= (async () => { + this.#browser = await launchChromium(); + this.#viewport = resolveViewport(viewportOptions); + await this.#open(); + })().finally(() => { + this.#starting = null; + }); + await this.#starting; + } + + async #open() { + const v = this.#viewport; + this.#context = await this.#browser.newContext({ + viewport: { width: v.width, height: v.height }, + deviceScaleFactor: v.deviceScaleFactor, + isMobile: v.isMobile, + hasTouch: v.hasTouch, + }); + this.#page = await this.#context.newPage(); + } + + async #state() { + const page = this.#page; + const history = await page.evaluate(() => ({ + innerWidth: window.innerWidth, + innerHeight: window.innerHeight, + devicePixelRatio: window.devicePixelRatio, + })).catch(() => null); + const nav = await page.evaluate(() => { + const entries = performance.getEntriesByType("navigation"); + return { length: window.history.length, type: entries[0]?.type ?? null }; + }).catch(() => null); + return { url: page.url(), title: await page.title().catch(() => ""), viewport: this.#viewport, page: history, historyLength: nav?.length ?? null }; + } + + async navigate(url, viewportOptions = {}) { + const target = assertHttpUrl(url); + await this.#ensure(viewportOptions); + try { + const response = await this.#page.goto(target.href, { waitUntil: "load", timeout: 30_000 }); + return { ...(await this.#state()), status: response?.status() ?? null }; + } catch (error) { + throw new CaptureError("navigation_failed", `Could not load ${target.origin}: ${error?.message?.split("\n")[0] ?? error}`); + } + } + + async history(direction) { + if (!this.#page) throw new CaptureError("not_started", "Open a page in the controlled browser first."); + const verbs = { back: "goBack", forward: "goForward", refresh: "reload" }; + const verb = verbs[direction]; + if (!verb) throw new CaptureError("invalid_url", `Unknown history action "${direction}".`); + try { + // goBack/goForward resolve null when there is no such entry; that is not a failure. + await this.#page[verb]({ waitUntil: "load", timeout: 30_000 }); + // The context starts on about:blank; it is not user history, so never stay on it. + if (direction === "back" && this.#page.url() === "about:blank") await this.#page.goForward({ waitUntil: "load", timeout: 30_000 }); + } catch (error) { + throw new CaptureError("navigation_failed", `Could not ${direction === "refresh" ? "reload" : `go ${direction} to`} the page: ${error?.message?.split("\n")[0] ?? error}`); + } + return this.#state(); + } + + /** Real session history (about:blank excluded) so it can be replayed into a recreated context. */ + async #readHistory() { + const cdp = await this.#context.newCDPSession(this.#page); + try { + const { entries, currentIndex } = await cdp.send("Page.getNavigationHistory"); + const urls = []; + let index = -1; + entries.forEach((entry, i) => { + if (entry.url === "about:blank") return; + urls.push(entry.url); + if (i === currentIndex) index = urls.length - 1; + }); + return { urls, index: index < 0 ? urls.length - 1 : index }; + } finally { + await cdp.detach().catch(() => {}); + } + } + + /** + * Resizing keeps the page and its history. Changing device traits (mobile, touch, scale factor) needs + * a new browser context, so the logical history is replayed into it and the position is restored. + */ + async setViewport(viewportOptions) { + if (!this.#page) throw new CaptureError("not_started", "Open a page in the controlled browser first."); + const next = resolveViewport(viewportOptions); + const needsNewContext = next.isMobile !== this.#viewport.isMobile + || next.hasTouch !== this.#viewport.hasTouch + || next.deviceScaleFactor !== this.#viewport.deviceScaleFactor; + if (!needsNewContext) { + await this.#page.setViewportSize({ width: next.width, height: next.height }); + this.#viewport = next; + return this.#state(); + } + const { urls, index } = await this.#readHistory(); + const previous = this.#context; + const previousViewport = this.#viewport; + this.#viewport = next; + try { + await this.#open(); + for (const url of urls) { + await this.#page.goto(url, { waitUntil: "load", timeout: 30_000 }); + } + for (let i = urls.length - 1; i > index; i -= 1) { + await this.#page.goBack({ waitUntil: "load", timeout: 30_000 }); + } + } catch (error) { + await this.#context?.close().catch(() => {}); + this.#viewport = previousViewport; + this.#context = previous; + this.#page = previous.pages()[0] ?? this.#page; + throw new CaptureError("navigation_failed", `Could not re-open the page with the new device settings: ${error?.message?.split("\n")[0] ?? error}`); + } + await previous.close().catch(() => {}); + return this.#state(); + } + async screenshot({ fullPage = false, outputDir = getScreenshotRoot() } = {}) { + if (!this.#page) throw new CaptureError("not_started", "Open a page in the controlled browser first."); + const png = await this.#page.screenshot({ type: "png", fullPage: Boolean(fullPage) }); + const state = await this.#state(); + return { + ...(await savePng(png, outputDir)), + source: "controlled-current", + note: "Screenshot of the controlled Chromium's current page state, including navigation and unsaved page state.", + finalUrl: state.url, + fullPage: Boolean(fullPage), + viewport: state.viewport, + page: state.page, + }; + } + + /** Raw PNG of the current viewport for live display; not written to disk. */ + async frame() { + if (!this.#page) throw new CaptureError("not_started", "Open a page in the controlled browser first."); + return this.#page.screenshot({ type: "png" }); + } + + async close() { + const browser = this.#browser; + this.#browser = this.#context = this.#page = null; + await browser?.close().catch(() => {}); + } +} diff --git a/extensions/pr-artifact-explorer/capture.test.mjs b/extensions/pr-artifact-explorer/capture.test.mjs new file mode 100644 index 0000000000..ea871c7ece --- /dev/null +++ b/extensions/pr-artifact-explorer/capture.test.mjs @@ -0,0 +1,127 @@ +import assert from "node:assert/strict"; +import { existsSync } from "node:fs"; +import { mkdtemp, readFile, rm } from "node:fs/promises"; +import { createServer } from "node:http"; +import { tmpdir } from "node:os"; +import { join } from "node:path"; +import test from "node:test"; +import { CaptureError, ControlledBrowser, captureScreenshot, resolveViewport } from "./capture.mjs"; + +test("viewport presets and validation", () => { + assert.deepEqual(resolveViewport({ preset: "mobile" }).width, 390); + assert.equal(resolveViewport({ preset: "tablet" }).height, 1024); + assert.equal(resolveViewport({ preset: "desktop", orientation: "portrait" }).width, 900); + assert.equal(resolveViewport({ preset: "custom", width: 500, height: 600 }).width, 500); + assert.throws(() => resolveViewport({ preset: "watch" }), CaptureError); + assert.throws(() => resolveViewport({ width: 10, height: 600 }), /between 200/); +}); + +test("non-http URLs are refused before any browser starts", async () => { + await assert.rejects(captureScreenshot({ url: "file:///c:/x" }), { code: "invalid_url" }); + await assert.rejects(captureScreenshot({ url: "nope" }), { code: "invalid_url" }); +}); + +test("missing Playwright reports explicit setup instructions", async () => { + const saved = process.env.PR_ARTIFACT_EXPLORER_PLAYWRIGHT; + process.env.PR_ARTIFACT_EXPLORER_PLAYWRIGHT = join(tmpdir(), "no-such-playwright-dir"); + try { + await captureScreenshot({ url: "http://127.0.0.1:9/" }); + // Playwright may legitimately resolve from the extension folder in dev installs. + } catch (error) { + assert.ok(["playwright_missing", "chromium_missing", "navigation_failed"].includes(error.code)); + if (error.code === "playwright_missing") assert.match(error.message, /npx playwright install chromium/); + } finally { + if (saved === undefined) delete process.env.PR_ARTIFACT_EXPLORER_PLAYWRIGHT; + else process.env.PR_ARTIFACT_EXPLORER_PLAYWRIGHT = saved; + } +}); + +test("real Chromium emulates the preset and saves a PNG", async (t) => { + const server = createServer((req, res) => { + res.setHeader("content-type", "text/html"); + res.end(`
`); + }); + await new Promise((resolve) => server.listen(0, "127.0.0.1", resolve)); + const url = `http://127.0.0.1:${server.address().port}/`; + const dir = await mkdtemp(join(tmpdir(), "pae-shot-")); + t.after(async () => { + server.close(); + await rm(dir, { recursive: true, force: true }); + }); + let shot; + try { + shot = await captureScreenshot({ url, preset: "mobile", outputDir: dir }); + } catch (error) { + if (error.code === "playwright_missing" || error.code === "chromium_missing") { + t.skip(error.message.split("\n")[0]); + return; + } + throw error; + } + assert.equal(shot.source, "fresh-render"); + assert.equal(shot.page.innerWidth, 390); + assert.equal(shot.page.innerHeight, 844); + assert.equal(shot.page.devicePixelRatio, 3); + const bytes = await readFile(shot.path); + assert.equal(bytes.subarray(1, 4).toString(), "PNG"); + assert.ok(existsSync(shot.path)); + const full = await captureScreenshot({ url, preset: "desktop", fullPage: true, outputDir: dir }); + assert.ok(full.bytes > 0 && full.fullPage); + const fullPng = await readFile(full.path); + assert.ok(fullPng.readUInt32BE(20) >= 1800, "full page height should cover the 1800px page"); +}); + +test("controlled browser keeps real history, current state and viewport/zoom separation", async (t) => { + const server = createServer((req, res) => { + res.setHeader("content-type", "text/html"); + res.setHeader("x-frame-options", "DENY"); + res.end(`${req.url}
`); + }); + await new Promise((resolve) => server.listen(0, "127.0.0.1", resolve)); + const base = `http://127.0.0.1:${server.address().port}`; + const dir = await mkdtemp(join(tmpdir(), "pae-ctl-")); + const browser = new ControlledBrowser(); + t.after(async () => { + await browser.close(); + server.close(); + await rm(dir, { recursive: true, force: true }); + }); + await assert.rejects(browser.history("back"), { code: "not_started" }); + await assert.rejects(browser.navigate("file:///x"), { code: "invalid_url" }); + let state; + try { + state = await browser.navigate(`${base}/one`, { preset: "tablet" }); + } catch (error) { + if (error.code === "playwright_missing" || error.code === "chromium_missing") { + t.skip(error.message.split("\n")[0]); + return; + } + throw error; + } + assert.equal(state.page.innerWidth, 768); + await browser.navigate(`${base}/two`); + assert.match((await browser.history("back")).url, /\/one$/); + assert.match((await browser.history("forward")).url, /\/two$/); + assert.match((await browser.history("refresh")).url, /\/two$/); + const resized = await browser.setViewport({ preset: "custom", width: 500, height: 700 }); + assert.equal(resized.page.innerWidth, 500); + // Device-trait change recreates the context; the logical history must survive without about:blank. + const mobile = await browser.setViewport({ preset: "mobile" }); + assert.equal(mobile.page.innerWidth, 390); + assert.match(mobile.url, /\/two$/); + const back = await browser.history("back"); + assert.match(back.url, /\/one$/); + assert.equal(back.page.innerWidth, 390); + assert.match((await browser.history("forward")).url, /\/two$/); + assert.match((await browser.setViewport({ preset: "desktop" })).url, /\/two$/); + assert.match((await browser.history("back")).url, /\/one$/); + assert.match((await browser.history("back")).url, /\/one$/, "no entry before the first page is not an error and never reaches about:blank"); + await browser.history("forward"); + await assert.rejects(browser.navigate("http://127.0.0.1:1/"), { code: "navigation_failed" }); + const shot = await browser.screenshot({ outputDir: dir }); + assert.equal(shot.source, "controlled-current"); + assert.equal((await readFile(shot.path)).subarray(1, 4).toString(), "PNG"); + assert.equal((await browser.frame()).subarray(1, 4).toString(), "PNG"); + await browser.close(); + assert.equal(browser.active, false); +}); \ No newline at end of file diff --git a/extensions/pr-artifact-explorer/constants.mjs b/extensions/pr-artifact-explorer/constants.mjs index c10c0c8471..fb0f288425 100644 --- a/extensions/pr-artifact-explorer/constants.mjs +++ b/extensions/pr-artifact-explorer/constants.mjs @@ -8,17 +8,23 @@ export const ASSET_ROOT = join(EXTENSION_ROOT, "assets"); const copilotHome = process.env.COPILOT_HOME || join(homedir(), ".copilot"); export const DATA_ROOT = join(copilotHome, "extensions", "pr-artifact-explorer", "artifacts"); export const CACHE_ROOT = join(DATA_ROOT, "cache"); +export const JOBS_FILE = join(DATA_ROOT, "jobs.json"); export const PREFS_FILE = join(DATA_ROOT, "preferences.json"); export const GITHUB_API = "https://api.github.com"; export const USER_AGENT = "github-copilot-pr-artifact-explorer"; -// The indexer supports standard ZIP archives up to the ZIP32 boundary. -export const MAX_ARCHIVE_BYTES = (4 * 1024 * 1024 * 1024) - 2; +// Hard guards protect integrity and memory; they are not user-tunable. export const MIN_CACHE_FREE_BYTES = 512 * 1024 * 1024; -export const ARTIFACT_DOWNLOAD_IDLE_TIMEOUT_MS = 60_000; -export const MAX_CENTRAL_DIRECTORY_BYTES = 64 * 1024 * 1024; -export const MAX_ZIP_ENTRIES = 50_000; + +// Soft limits warn and prompt; work continues while a prompt is outstanding. +export const DEFAULT_SOFT_LIMITS = Object.freeze({ + downloadBytes: 4 * 1024 * 1024 * 1024, + zipEntries: 50_000, + centralDirectoryBytes: 64 * 1024 * 1024, + streamedEntryBytes: 512 * 1024 * 1024, + idleSeconds: 60, +}); export const MAX_INLINE_PREVIEW_BYTES = 4 * 1024 * 1024; export const MAX_TRX_PREVIEW_BYTES = 32 * 1024 * 1024; -export const MAX_STREAMED_ENTRY_BYTES = 512 * 1024 * 1024; +export const MAX_STREAMED_ENTRY_BYTES = DEFAULT_SOFT_LIMITS.streamedEntryBytes; diff --git a/extensions/pr-artifact-explorer/extension.mjs b/extensions/pr-artifact-explorer/extension.mjs index 926acf18e9..aa6cb960a8 100644 --- a/extensions/pr-artifact-explorer/extension.mjs +++ b/extensions/pr-artifact-explorer/extension.mjs @@ -8,16 +8,25 @@ import { clearArtifactCache, deleteCachedArtifact, getCacheSummary, - inspectArtifact, + jobRegistry, + startArtifactJob, } from "./cache.mjs"; import { broadcastCache, closeAllPreviews, + getBrowserState, + getControlledBrowser, navigateInstance, + restartInstance, + sendBrowserCommand, startInstance, stopInstance, } from "./server.mjs"; import { stopStaticPreviewsForArtifact } from "./preview.mjs"; +import { LimitError, limitPolicy } from "./limits.mjs"; +import { join } from "node:path"; +import { CaptureError, captureScreenshot, setScreenshotRoot } from "./capture.mjs"; +import { TargetError, describeShare, encodeView, parseTarget, routeFor } from "./targets.mjs"; import { loadPrefs, normalizeRepository, savePrefs } from "./state.mjs"; function positiveInteger(value, label) { @@ -28,13 +37,72 @@ function positiveInteger(value, label) { return number; } +function wrap(fn) { + return async (ctx) => { + try { + return await fn(ctx); + } catch (error) { + if (error instanceof CanvasError) throw error; + if (error instanceof TargetError || error instanceof CaptureError || error instanceof LimitError) { + throw new CanvasError(error.code ?? "invalid_input", error.message); + } + throw error; + } + }; +} + +async function resolveToken(repository) { + const prefs = await loadPrefs(); + const auth = await resolveAccounts({ preferredId: prefs.account, repository }); + if (!auth.activeToken) { + throw new CanvasError("github_auth_required", "No usable GitHub account was found."); + } + return { token: auth.activeToken, account: auth.active?.id ?? null }; +} + +async function startJob(ctx, repository, artifactId) { + const { token, account } = await resolveToken(repository); + const job = await startArtifactJob(token, repository, artifactId, { account }); + navigateInstance(ctx.instanceId, `#/artifact/${encodeURIComponent(repository)}/0/${artifactId}`); + return job; +} + +// Waits briefly so quick jobs return a result, but never cancels the job. +async function settleWithin(job, ms) { + let timer; + const outcome = await Promise.race([ + job.promise.then(() => "done", () => "failed"), + new Promise((resolve) => { + timer = setTimeout(() => resolve("running"), ms); + }), + ]); + clearTimeout(timer); + return outcome; +} + +const VIEW_PROPERTIES = { + preset: { type: "string", enum: ["native", "mobile", "tablet", "desktop", "custom"] }, + zoom: { type: "number", minimum: 0.25, maximum: 3 }, + width: { type: "integer", minimum: 200, maximum: 4000, description: "Custom viewport width in CSS pixels." }, + height: { type: "integer", minimum: 200, maximum: 4000, description: "Custom viewport height in CSS pixels." }, + orientation: { type: "string", enum: ["portrait", "landscape"] }, +}; + +function viewFragment(url, input = {}) { + let { width, height } = input; + if (width && height && ((input.orientation === "landscape" && height > width) || (input.orientation === "portrait" && width > height))) { + [width, height] = [height, width]; + } + return encodeView({ url, preset: input.preset ?? (width || height ? "custom" : undefined), width, height, zoom: input.zoom }); +} + const session = await joinSession({ canvases: [ createCanvas({ id: "pr-artifact-explorer", displayName: "Artifact Explorer", description: - "Browse GitHub pull requests and securely preview workflow artifacts, including static sites and asciinema recordings.", + "Browse GitHub pull requests and issues, securely preview workflow artifacts, and open local or web URLs in a responsive browser preview with device presets, zoom, history, and screenshots.", inputSchema: { type: "object", properties: { @@ -47,10 +115,21 @@ const session = await joinSession({ minimum: 1, description: "Pull request number to open.", }, + artifactId: { + type: "integer", + minimum: 1, + description: "Workflow artifact id to inspect (requires repository).", + }, url: { type: "string", - description: "GitHub pull request URL to open.", + description: + "A GitHub PR/issue/artifact URL, a shared artifact-explorer link, or an http(s) URL to preview in the browser view.", }, + route: { + type: "string", + description: "In-app route such as #/pull/owner%2Frepo/1, #/cache or #/docs.", + }, + ...VIEW_PROPERTIES, }, additionalProperties: false, }, @@ -67,7 +146,7 @@ const session = await joinSession({ required: ["repository", "pullNumber"], additionalProperties: false, }, - handler: (ctx) => { + handler: wrap((ctx) => { const repository = normalizeRepository(ctx.input?.repository); const pullNumber = positiveInteger(ctx.input?.pullNumber, "pullNumber"); const route = `#/pull/${encodeURIComponent(repository)}/${pullNumber}`; @@ -76,39 +155,69 @@ const session = await joinSession({ repository, pullNumber, }; + }), + }, + { + name: "open_target", + description: + "Navigate the canvas to any supported target: a PR/issue/artifact URL, a shared link, natural language (e.g. 'open PR 123 in owner/repo'), a docs request, or an http(s) URL in the browser preview. Never runs artifact code.", + inputSchema: { + type: "object", + properties: { + input: { type: "string", description: "URL, route, or natural-language request." }, + repository: { type: "string", description: "Default repository for bare numbers." }, + ...VIEW_PROPERTIES, + }, + required: ["input"], + additionalProperties: false, }, + handler: wrap(async (ctx) => { + const prefs = await loadPrefs(); + const target = parseTarget(ctx.input?.input, { + defaultRepository: ctx.input?.repository ?? prefs.repository, + }); + if (target.kind === "command") { + const controlled = getControlledBrowser(ctx.instanceId); + if (controlled?.active && ["back", "forward", "refresh"].includes(target.command)) { + return { target, controlled: await controlled.history(target.command) }; + } + throw new CanvasError("invalid_input", `"${target.command}" needs an open browser view; use open_target with a URL first, or the controlled_* actions.`); + } + const view = { ...target.view, ...Object.fromEntries(Object.entries(ctx.input ?? {}).filter(([k, v]) => v !== undefined && k in VIEW_PROPERTIES)) }; + const route = + target.kind === "url" + ? `#/browser?v=${viewFragment(target.url, view)}` + : routeFor(target); + return { navigated: navigateInstance(ctx.instanceId, route), target, route }; + }), }, { name: "inspect_artifact", - description: "Download, index, and smart-detect a GitHub Actions artifact.", + description: + "Start (or reattach to) a download/index job for a GitHub Actions artifact. The job runs independently of this call; completed ZIPs are reused. Inspection only: artifact programs and build scripts are never executed.", inputSchema: { type: "object", properties: { repository: { type: "string" }, artifactId: { type: "integer", minimum: 1 }, + waitSeconds: { type: "number", minimum: 0, maximum: 120 }, }, required: ["repository", "artifactId"], additionalProperties: false, }, - handler: async (ctx) => { + handler: wrap(async (ctx) => { const repository = normalizeRepository(ctx.input?.repository); const artifactId = positiveInteger(ctx.input?.artifactId, "artifactId"); - const prefs = await loadPrefs(); - const auth = await resolveAccounts({ - preferredId: prefs.account, - repository, - }); - if (!auth.activeToken) { - throw new CanvasError("github_auth_required", "No usable GitHub account was found."); - } - const metadata = await inspectArtifact(auth.activeToken, repository, artifactId); + const job = await startJob(ctx, repository, artifactId); + const outcome = await settleWithin(job, (ctx.input?.waitSeconds ?? 20) * 1000); await broadcastCache(); - navigateInstance( - ctx.instanceId, - `#/artifact/${encodeURIComponent(repository)}/0/${artifactId}`, - ); + const snapshot = jobRegistry.snapshot(job); + if (outcome !== "done") return { status: outcome, job: snapshot }; + const metadata = await job.promise; const entries = metadata.analysis.entries ?? []; return { + status: "done", + job: snapshot, artifact: metadata.artifact, analysis: { ...metadata.analysis, @@ -116,7 +225,199 @@ const session = await joinSession({ entriesTruncated: entries.length > 200, }, }; + }), + }, + { + name: "job_status", + description: "List download/index jobs with progress, attempt, and outstanding soft-limit prompts.", + handler: async () => ({ jobs: jobRegistry.list(), limits: limitPolicy.snapshot() }), + }, + { + name: "retry_job", + description: "Retry an artifact job. A completed ZIP is reused and only indexing re-runs.", + inputSchema: { + type: "object", + properties: { repository: { type: "string" }, artifactId: { type: "integer", minimum: 1 } }, + required: ["repository", "artifactId"], + additionalProperties: false, + }, + handler: wrap(async (ctx) => { + const repository = normalizeRepository(ctx.input?.repository); + const job = await startJob(ctx, repository, positiveInteger(ctx.input?.artifactId, "artifactId")); + return { job: jobRegistry.snapshot(job) }; + }), + }, + { + name: "cancel_job", + description: "Explicitly cancel a running artifact job.", + inputSchema: { + type: "object", + properties: { jobId: { type: "string" } }, + required: ["jobId"], + additionalProperties: false, + }, + handler: wrap((ctx) => { + const job = jobRegistry.get(String(ctx.input?.jobId ?? "")); + if (!job) throw new CanvasError("job_not_found", "Job was not found."); + jobRegistry.cancel(job.id); + return { job: jobRegistry.snapshot(job) }; + }), + }, + { + name: "set_limit", + description: + "Raise a soft limit (downloadBytes, zipEntries, centralDirectoryBytes, streamedEntryBytes, idleSeconds). The value must be at least the live value of any running job.", + inputSchema: { + type: "object", + properties: { kind: { type: "string" }, value: { type: "number", minimum: 1 } }, + required: ["kind", "value"], + additionalProperties: false, + }, + handler: wrap((ctx) => { + const result = limitPolicy.submit(ctx.input?.kind, ctx.input?.value); + return { ...result, limits: limitPolicy.snapshot() }; + }), + }, + { + name: "restart_canvas", + description: + "Completely restart the canvas server and reload the view. Running download/index jobs are preserved.", + handler: wrap(async (ctx) => { + const active = jobRegistry.activeJobs().length; + const result = await restartInstance(ctx.instanceId, (message) => + session.log(message, { level: "debug" }), + ); + if (!result) throw new CanvasError("not_open", "The canvas is not open."); + return { restarted: true, samePort: result.samePort, jobsPreserved: active, url: result.entry.url }; + }), + }, + { + name: "navigate_browser", + description: "Open an http(s) URL (including localhost) in the browser preview, optionally at a device preset and zoom.", + inputSchema: { + type: "object", + properties: { url: { type: "string" }, ...VIEW_PROPERTIES }, + required: ["url"], + additionalProperties: false, + }, + handler: wrap((ctx) => { + const target = parseTarget(ctx.input?.url); + if (target.kind !== "url") throw new CanvasError("invalid_input", "Provide an http(s) URL."); + const route = `#/browser?v=${viewFragment(target.url, ctx.input)}`; + return { navigated: navigateInstance(ctx.instanceId, route), url: target.url }; + }), + }, + ...["back", "forward", "refresh"].map((command) => ({ + name: `browser_${command}`, + description: `Browser preview: ${command}.`, + handler: wrap((ctx) => ({ sent: sendBrowserCommand(ctx.instanceId, { command }) })), + })), + { + name: "set_viewport", + description: "Set the browser preview device preset (native, mobile, tablet, desktop, custom) and optional size/orientation.", + inputSchema: { + type: "object", + properties: { + ...VIEW_PROPERTIES, + }, + additionalProperties: false, + }, + handler: wrap((ctx) => ({ + sent: sendBrowserCommand(ctx.instanceId, { command: "viewport", ...ctx.input }), + })), + }, + { + name: "set_zoom", + description: "Set browser preview visual zoom (0.25-3). Zoom scales the frame without changing the emulated viewport.", + inputSchema: { + type: "object", + properties: { zoom: { type: "number", minimum: 0.25, maximum: 3 }, fit: { type: "boolean" } }, + additionalProperties: false, }, + handler: wrap((ctx) => ({ + sent: sendBrowserCommand(ctx.instanceId, { command: "zoom", ...ctx.input }), + })), + }, + { + name: "screenshot", + description: + "Capture a real Chromium screenshot saved to the session files area. mode=fresh (default) renders the URL anew at the emulated viewport (not the live in-panel page state); mode=controlled captures the CURRENT page of the isolated controlled Chromium (see controlled_navigate). Requires Playwright; setup instructions are returned if missing.", + inputSchema: { + type: "object", + properties: { + url: { type: "string", description: "Defaults to the URL currently shown in the browser preview." }, + mode: { type: "string", enum: ["fresh", "controlled"] }, + fullPage: { type: "boolean" }, + ...VIEW_PROPERTIES, + }, + additionalProperties: false, + }, + handler: wrap(async (ctx) => { + if (ctx.input?.mode === "controlled") { + return getControlledBrowser(ctx.instanceId).screenshot({ fullPage: ctx.input?.fullPage === true }); + } + const state = getBrowserState(ctx.instanceId); + const url = ctx.input?.url ?? state?.url; + if (!url) throw new CanvasError("invalid_input", "No URL is open; pass url."); + return captureScreenshot({ + url, + fullPage: ctx.input?.fullPage === true, + preset: ctx.input?.preset ?? state?.preset ?? undefined, + width: ctx.input?.width, + height: ctx.input?.height, + orientation: ctx.input?.orientation, + }); + }), + }, + { + name: "controlled_navigate", + description: + "Open a URL in the explicit, isolated controlled Chromium (fresh in-memory profile, no logins) with real history and device emulation. Use for sites that refuse iframe embedding. Requires Playwright.", + inputSchema: { + type: "object", + properties: { url: { type: "string" }, ...VIEW_PROPERTIES }, + required: ["url"], + additionalProperties: false, + }, + handler: wrap(async (ctx) => { + const { url, preset, width, height, orientation } = ctx.input ?? {}; + return { controlled: await getControlledBrowser(ctx.instanceId).navigate(url, { preset, width, height, orientation }) }; + }), + }, + ...["back", "forward", "refresh"].map((direction) => ({ + name: `controlled_${direction}`, + description: `Controlled Chromium history: ${direction}.`, + handler: wrap(async (ctx) => ({ controlled: await getControlledBrowser(ctx.instanceId).history(direction) })), + })), + { + name: "controlled_close", + description: "Close the controlled Chromium and discard its in-memory profile.", + handler: wrap(async (ctx) => { + await getControlledBrowser(ctx.instanceId)?.close(); + return { closed: true }; + }), + }, + { + name: "share", + description: "Build a canonical GitHub URL and shareable link for a PR, issue, or artifact target.", + inputSchema: { + type: "object", + properties: { input: { type: "string" }, repository: { type: "string" }, ...VIEW_PROPERTIES }, + required: ["input"], + additionalProperties: false, + }, + handler: wrap((ctx) => { + const target = parseTarget(ctx.input?.input, { defaultRepository: ctx.input?.repository }); + if (target.kind === "command") throw new CanvasError("invalid_input", "Commands cannot be shared; share a URL or artifact target."); + const picked = Object.fromEntries(Object.entries(ctx.input ?? {}).filter(([k, v]) => v !== undefined && k in VIEW_PROPERTIES)); + const view = { ...target.view, ...picked }; + return { share: describeShare(target, Object.keys(view).length ? view : null) }; + }), + }, + { + name: "docs", + description: "Open the built-in Artifact Explorer documentation tab.", + handler: wrap((ctx) => ({ navigated: navigateInstance(ctx.instanceId, "#/docs") })), }, { name: "cache_status", @@ -134,20 +435,26 @@ const session = await joinSession({ additionalProperties: false, }, handler: async (ctx) => { - if (ctx.input?.artifactId != null) { - await stopStaticPreviewsForArtifact(ctx.input.artifactId); - const result = await deleteCachedArtifact( - positiveInteger(ctx.input.artifactId, "artifactId"), - ); + try { + if (ctx.input?.artifactId != null) { + const id = positiveInteger(ctx.input.artifactId, "artifactId"); + await stopStaticPreviewsForArtifact(id); + const result = await deleteCachedArtifact(id); + navigateInstance(ctx.instanceId, "#/cache"); + await broadcastCache({ refresh: true }); + return result; + } + await closeAllPreviews(); + const result = await clearArtifactCache(); navigateInstance(ctx.instanceId, "#/cache"); await broadcastCache({ refresh: true }); return result; + } catch (error) { + if (error?.code === "jobs_active") { + throw new CanvasError("jobs_active", error.message); + } + throw error; } - await closeAllPreviews(); - const result = await clearArtifactCache(); - navigateInstance(ctx.instanceId, "#/cache"); - await broadcastCache({ refresh: true }); - return result; }, }, { @@ -196,6 +503,7 @@ const session = await joinSession({ }, ], open: async (ctx) => { + if (session.workspacePath) setScreenshotRoot(join(session.workspacePath, "files", "artifact-explorer-screenshots")); const entry = await startInstance( ctx.instanceId, ctx.input, diff --git a/extensions/pr-artifact-explorer/github.mjs b/extensions/pr-artifact-explorer/github.mjs index 55d2670a3e..4bfa610839 100644 --- a/extensions/pr-artifact-explorer/github.mjs +++ b/extensions/pr-artifact-explorer/github.mjs @@ -541,6 +541,30 @@ export async function getPullRequest(token, repository, pullNumber) { ); } +export async function getIssue(token, repository, issueNumber) { + const number = Number.parseInt(issueNumber, 10); + if (!Number.isSafeInteger(number) || number <= 0) { + throw new Error("Issue number must be a positive integer."); + } + const item = await githubRequest( + token, + `/repos/${repositoryPath(repository)}/issues/${number}`, + ); + return { + number: item.number, + title: item.title, + state: item.state, + url: item.html_url, + isPullRequest: Boolean(item.pull_request), + author: item.user?.login ?? null, + labels: (item.labels ?? []).map((l) => (typeof l === "string" ? l : l.name)), + comments: item.comments ?? 0, + createdAt: item.created_at, + updatedAt: item.updated_at, + body: typeof item.body === "string" ? item.body.slice(0, 20_000) : "", + }; +} + async function mapLimit(items, limit, callback) { const results = new Array(items.length); let cursor = 0; diff --git a/extensions/pr-artifact-explorer/jobs-limits.test.mjs b/extensions/pr-artifact-explorer/jobs-limits.test.mjs new file mode 100644 index 0000000000..193b382967 --- /dev/null +++ b/extensions/pr-artifact-explorer/jobs-limits.test.mjs @@ -0,0 +1,117 @@ +import assert from "node:assert/strict"; +import { mkdtemp, rm } from "node:fs/promises"; +import { tmpdir } from "node:os"; +import { join } from "node:path"; +import test from "node:test"; +import { JobRegistry } from "./jobs.mjs"; +import { LimitError, LimitPolicy } from "./limits.mjs"; + +async function policy() { + const dir = await mkdtemp(join(tmpdir(), "limits-")); + return { dir, policy: new LimitPolicy(join(dir, "limits.json")) }; +} + +const tick = () => new Promise((resolve) => setImmediate(resolve)); + +test("crossing a soft limit prompts but never stops the job", async () => { + const { dir, policy: p } = await policy(); + try { + const registry = new JobRegistry(p); + let release; + const gate = new Promise((resolve) => (release = resolve)); + const job = registry.start("k", { repository: "o/r", artifactId: 1 }, async (j) => { + registry.update(j, { live: { downloadBytes: p.get("downloadBytes") + 1 } }); + await gate; + return "done"; + }); + await tick(); + const snap = registry.snapshot(job); + assert.equal(snap.status, "running"); + assert.equal(snap.prompts.length, 1); + assert.equal(snap.prompts[0].kind, "downloadBytes"); + release(); + assert.equal(await job.promise, "done"); + } finally { + await rm(dir, { recursive: true, force: true }); + } +}); + +test("submitted limits are checked against live progress atomically", async () => { + const { dir, policy: p } = await policy(); + try { + const registry = new JobRegistry(p); + let live = 100; + let release; + const gate = new Promise((resolve) => (release = resolve)); + const job = registry.start("k", { repository: "o/r", artifactId: 2 }, async (j) => { + registry.update(j, { live: { zipEntries: live } }); + await gate; + }); + await tick(); + assert.throws( + () => p.submit("zipEntries", 50), + (error) => error instanceof LimitError && error.code === "below_current" && error.minimum === 100, + ); + // Progress advances after the prompt: the new minimum is the live value at submit time. + live = 5000; + registry.update(job, { live: { zipEntries: live } }); + assert.throws(() => p.submit("zipEntries", 4999), /at least the current value/); + assert.equal(p.submit("zipEntries", 5000).limit, 5000); + assert.equal(registry.snapshot(job).prompts.length, 0); + assert.throws(() => p.submit("zipEntries", 0), (e) => e.code === "invalid_limit"); + assert.throws(() => p.submit("nope", 5), (e) => e.code === "unknown_limit"); + release(); + await job.promise; + } finally { + await rm(dir, { recursive: true, force: true }); + } +}); + +test("jobs are idempotent per key, cancellable, and retry increments the attempt", async () => { + const { dir, policy: p } = await policy(); + try { + const registry = new JobRegistry(p); + const first = registry.start("k", { repository: "o/r", artifactId: 3 }, (j) => + new Promise((_, reject) => j.controller.signal.addEventListener("abort", () => reject(j.controller.signal.reason))), + ); + const again = registry.start("k", { repository: "o/r", artifactId: 3 }, async () => "x"); + assert.equal(first, again); + assert.equal(registry.cancel(first.id), true); + await assert.rejects(first.promise); + assert.equal(registry.snapshot(first).status, "cancelled"); + const retry = registry.start("k", { repository: "o/r", artifactId: 3 }, async () => "ok"); + assert.equal(retry.attempt, 2); + assert.equal(await retry.promise, "ok"); + } finally { + await rm(dir, { recursive: true, force: true }); + } +}); + +test("a failed job reports the error without being treated as cancelled", async () => { + const { dir, policy: p } = await policy(); + try { + const registry = new JobRegistry(p); + const job = registry.start("k", { repository: "o/r", artifactId: 4 }, async () => { + throw new Error("boom"); + }); + await assert.rejects(job.promise, /boom/); + const snap = registry.snapshot(job); + assert.equal(snap.status, "failed"); + assert.equal(snap.error, "boom"); + } finally { + await rm(dir, { recursive: true, force: true }); + } +}); + +test("limits persist across policy instances", async () => { + const { dir, policy: p } = await policy(); + try { + p.submit("downloadBytes", 123456789); + await new Promise((resolve) => setTimeout(resolve, 100)); + const next = new LimitPolicy(join(dir, "limits.json")); + await next.load(); + assert.equal(next.get("downloadBytes"), 123456789); + } finally { + await rm(dir, { recursive: true, force: true }); + } +}); diff --git a/extensions/pr-artifact-explorer/jobs.mjs b/extensions/pr-artifact-explorer/jobs.mjs new file mode 100644 index 0000000000..673b0ede87 --- /dev/null +++ b/extensions/pr-artifact-explorer/jobs.mjs @@ -0,0 +1,411 @@ +import { randomUUID } from "node:crypto"; +import { mkdir, readFile, rename, rm, writeFile } from "node:fs/promises"; +import { dirname } from "node:path"; +import { LIMIT_KINDS } from "./limits.mjs"; + +const MAX_FINISHED_JOBS = 25; +const ACTIVE = new Set(["running"]); +const ALL_KINDS = Object.keys(LIMIT_KINDS); +const STREAM_KINDS = ["streamedEntryBytes"]; + +export class JobCancelled extends Error { + constructor(message = "The job was cancelled.") { + super(message); + this.name = "JobCancelled"; + } +} + +/** + * Tracks long-running artifact jobs independently of any HTTP request or UI + * view. Jobs only stop on explicit cancellation or a genuine fatal error; + * soft-limit crossings surface as `prompts` in the snapshot and never pause work. + */ +export class JobRegistry { + #jobs = new Map(); + #listeners = new Set(); + #policy; + #idleTimer = null; + #file; + #loaded = null; + #writing = null; + #dirty = false; + #sequence = 0; + persistError = null; + loadWarning = null; + + constructor(policy, { file = null } = {}) { + this.#policy = policy; + this.#file = file; + policy.onChange(() => { + for (const job of this.#jobs.values()) if (ACTIVE.has(job.status)) this.#emit(job); + }); + } + + subscribe(listener) { + this.#listeners.add(listener); + return () => this.#listeners.delete(listener); + } + + get(id) { + return this.#jobs.get(id) ?? null; + } + + findActive(key) { + for (const job of this.#jobs.values()) { + if (job.key === key && ACTIVE.has(job.status)) return job; + } + return null; + } + + latestFor(key) { + let found = null; + for (const job of this.#jobs.values()) if (job.key === key) found = job; + return found; + } + + activeJobs() { + return [...this.#jobs.values()].filter((job) => ACTIVE.has(job.status)); + } + + list() { + return [...this.#jobs.values()].map((job) => this.snapshot(job)); + } + + /** Starts the runner, or returns the already-running job for the same key. */ + start(key, meta, runner) { + const existing = this.findActive(key); + if (existing) return existing; + const previous = this.latestFor(key); + const controller = new AbortController(); + const job = { + id: randomUUID(), + key, + repository: meta.repository, + artifactId: String(meta.artifactId), + artifactName: meta.artifactName ?? `Artifact ${meta.artifactId}`, + account: meta.account ?? null, + attempt: (previous?.attempt ?? 0) + 1, + status: "running", + stage: "preparing", + progress: null, + live: {}, + lastActivityAt: Date.now(), + error: null, + result: null, + startedAt: new Date().toISOString(), + finishedAt: null, + controller, + unregister: [], + promise: null, + }; + for (const kind of ALL_KINDS) { + job.unregister.push( + this.#policy.trackLive(job.id, kind, () => { + if (kind === "idleSeconds") return this.#idleSeconds(job); + return job.live[kind] ?? 0; + }), + ); + } + this.#jobs.set(job.id, job); + this.#trim(); + this.#schedulePersist(); + job.promise = (async () => { + try { + job.result = await runner(job); + job.status = "succeeded"; + job.stage = "ready"; + } catch (error) { + if (controller.signal.aborted) { + job.status = "cancelled"; + job.error = "Cancelled."; + } else { + job.status = "failed"; + job.error = error instanceof Error ? error.message : String(error); + job.stage = "error"; + } + job.cause = error; + } finally { + job.finishedAt = new Date().toISOString(); + job.unregister.forEach((fn) => fn()); + job.unregister = []; + this.#emit(job); + this.#syncIdleTimer(); + this.#schedulePersist(); + } + if (job.status !== "succeeded") throw job.cause; + return job.result; + })(); + job.promise.catch(() => {}); + this.#syncIdleTimer(); + this.#emit(job); + return job; + } + + /** + * Tracks an in-flight decompression stream (content or static preview) so its + * live size can cross a soft limit and prompt without ever stopping the stream. + * Call `update(bytes)` per chunk and `finish(error?)` when the stream ends. + */ + track(meta) { + const controller = new AbortController(); + const job = { + id: randomUUID(), + kind: "stream", + key: `stream:${randomUUID()}`, + repository: meta.repository ?? null, + artifactId: String(meta.artifactId ?? ""), + artifactName: meta.name ?? "Streamed entry", + attempt: 1, + status: "running", + stage: "decompressing", + progress: null, + live: {}, + lastActivityAt: Date.now(), + error: null, + result: null, + startedAt: new Date().toISOString(), + finishedAt: null, + controller, + unregister: [], + promise: null, + }; + job.unregister.push( + this.#policy.trackLive(job.id, "streamedEntryBytes", () => job.live.streamedEntryBytes ?? 0), + ); + this.#jobs.set(job.id, job); + this.#syncIdleTimer(); + this.#emit(job); + let lastEmit = 0; + return { + job, + signal: controller.signal, + update: (bytes) => { + job.live.streamedEntryBytes = bytes; + job.lastActivityAt = Date.now(); + const now = Date.now(); + if (now - lastEmit >= 250) { + lastEmit = now; + this.#emit(job); + } + }, + finish: (error = null) => { + if (!ACTIVE.has(job.status)) return; + if (controller.signal.aborted) { + job.status = "cancelled"; + job.error = "Cancelled."; + } else if (error) { + job.status = "failed"; + job.error = error instanceof Error ? error.message : String(error); + } else { + job.status = "succeeded"; + } + job.finishedAt = new Date().toISOString(); + job.unregister.forEach((fn) => fn()); + job.unregister = []; + this.#emit(job); + this.#syncIdleTimer(); + // Finished streams are transient; only failures remain visible. + if (job.status === "succeeded" || job.status === "cancelled") this.#jobs.delete(job.id); + }, + }; + } + + /** Loads persisted, non-secret job history. Jobs that were running are honestly reported as interrupted. */ + load() { + if (!this.#file) return Promise.resolve(); + this.#loaded ??= (async () => { + let saved; + try { + saved = JSON.parse(await readFile(this.#file, "utf8")); + } catch (error) { + if (error?.code === "ENOENT") return; + if (error instanceof SyntaxError) { + this.loadWarning = `Saved job history at ${this.#file} is corrupt and was ignored (${error.message}).`; + return; + } + throw error; + } + let changed = false; + for (const entry of Array.isArray(saved?.jobs) ? saved.jobs : []) { + if (!entry?.id || !entry.key || this.#jobs.has(entry.id)) continue; + const wasRunning = entry.status === "running"; + this.#jobs.set(entry.id, { + id: String(entry.id), + key: String(entry.key), + repository: entry.repository ?? null, + artifactId: String(entry.artifactId ?? ""), + artifactName: entry.artifactName ?? `Artifact ${entry.artifactId}`, + account: entry.account ?? null, + attempt: Number(entry.attempt) || 1, + status: wasRunning ? "interrupted" : String(entry.status), + stage: wasRunning ? "interrupted" : String(entry.stage ?? "error"), + progress: entry.progress ?? null, + live: {}, + lastActivityAt: Date.now(), + error: wasRunning + ? "Interrupted: the provider stopped before this job finished. Retry to download it again." + : entry.error ?? null, + startedAt: entry.startedAt ?? null, + finishedAt: wasRunning ? new Date().toISOString() : entry.finishedAt ?? null, + unregister: [], + controller: null, + }); + changed ||= wasRunning; + } + this.#trim(); + if (changed) this.#schedulePersist(); + })(); + return this.#loaded; + } + + async flush() { + while (this.#writing) await this.#writing; + } + + #schedulePersist() { + if (!this.#file) return; + this.#dirty = true; + if (this.#writing) return; + this.#writing = (async () => { + try { + while (this.#dirty) { + this.#dirty = false; + try { + await this.#persist(); + this.persistError = null; + } catch (error) { + this.persistError = error instanceof Error ? error.message : String(error); + } + } + } finally { + this.#writing = null; + } + })(); + } + + async #persist() { + const jobs = [...this.#jobs.values()] + .filter((job) => job.kind !== "stream") + .map((job) => ({ + id: job.id, + key: job.key, + repository: job.repository, + artifactId: job.artifactId, + artifactName: job.artifactName, + account: job.account ?? null, + attempt: job.attempt, + status: job.status, + stage: job.stage, + error: job.error, + startedAt: job.startedAt, + finishedAt: job.finishedAt, + progress: job.progress, + })); + const temporary = `${this.#file}.${process.pid}.${++this.#sequence}.tmp`; + await mkdir(dirname(this.#file), { recursive: true }); + try { + await writeFile(temporary, `${JSON.stringify({ version: 1, jobs }, null, 2)}\n`, "utf8"); + await rename(temporary, this.#file); + } catch (error) { + await rm(temporary, { force: true }).catch(() => {}); + throw error; + } + } + + update(job, patch) { + if (patch.live) Object.assign(job.live, patch.live); + if (patch.stage) job.stage = patch.stage; + if (patch.progress) job.progress = patch.progress; + if (patch.artifactName) job.artifactName = patch.artifactName; + if (patch.activity !== false) job.lastActivityAt = Date.now(); + this.#emit(job); + } + + cancel(id, reason = "Cancelled by user.") { + const job = this.#jobs.get(id); + if (!job || !ACTIVE.has(job.status)) return false; + job.controller.abort(new JobCancelled(reason)); + return true; + } + + cancelAll(reason) { + const active = this.activeJobs(); + for (const job of active) job.controller.abort(new JobCancelled(reason)); + return active; + } + + #idleSeconds(job) { + if (!ACTIVE.has(job.status)) return 0; + return Math.floor((Date.now() - job.lastActivityAt) / 1000); + } + + snapshot(job) { + const prompts = []; + if (ACTIVE.has(job.status)) { + for (const kind of job.kind === "stream" ? STREAM_KINDS : ALL_KINDS) { + const current = kind === "idleSeconds" ? this.#idleSeconds(job) : job.live[kind] ?? 0; + const limit = this.#policy.get(kind); + if (current > limit) { + prompts.push({ + kind, + label: LIMIT_KINDS[kind].label, + unit: LIMIT_KINDS[kind].unit, + current, + limit, + minimum: this.#policy.minimum(kind), + }); + } + } + } + return { + id: job.id, + kind: job.kind ?? "artifact", + key: job.key, + repository: job.repository, + artifactId: job.artifactId, + artifactName: job.artifactName, + account: job.account ?? null, + attempt: job.attempt, + status: job.status, + stage: job.stage, + progress: job.progress, + error: job.error, + startedAt: job.startedAt, + finishedAt: job.finishedAt, + limits: this.#policy.snapshot(), + prompts, + }; + } + + #emit(job) { + const snapshot = this.snapshot(job); + for (const listener of this.#listeners) { + try { + listener(snapshot); + } catch { + // A faulty subscriber must not disturb job execution. + } + } + } + + #trim() { + const finished = [...this.#jobs.values()].filter((job) => !ACTIVE.has(job.status)); + for (const job of finished.slice(0, Math.max(0, finished.length - MAX_FINISHED_JOBS))) { + this.#jobs.delete(job.id); + } + } + + // Idle time changes without any event, so active jobs are re-broadcast once a second. + #syncIdleTimer() { + const active = this.activeJobs().length > 0; + if (active && !this.#idleTimer) { + this.#idleTimer = setInterval(() => { + for (const job of this.activeJobs()) this.#emit(job); + }, 1_000); + this.#idleTimer.unref?.(); + } else if (!active && this.#idleTimer) { + clearInterval(this.#idleTimer); + this.#idleTimer = null; + } + } +} diff --git a/extensions/pr-artifact-explorer/limits.mjs b/extensions/pr-artifact-explorer/limits.mjs new file mode 100644 index 0000000000..81b435946e --- /dev/null +++ b/extensions/pr-artifact-explorer/limits.mjs @@ -0,0 +1,166 @@ +import { mkdir, readFile, rename, rm, writeFile } from "node:fs/promises"; +import { dirname, join } from "node:path"; +import { DATA_ROOT, DEFAULT_SOFT_LIMITS } from "./constants.mjs"; + +export const LIMIT_KINDS = Object.freeze({ + downloadBytes: { label: "Download size", unit: "bytes" }, + zipEntries: { label: "ZIP entries", unit: "count" }, + centralDirectoryBytes: { label: "ZIP directory size", unit: "bytes" }, + streamedEntryBytes: { label: "Decompressed file size", unit: "bytes" }, + idleSeconds: { label: "Idle warning", unit: "seconds" }, +}); + +export const LIMITS_FILE = join(DATA_ROOT, "limits.json"); + +export class LimitError extends Error { + constructor(message, details = {}) { + super(message); + this.name = "LimitError"; + this.code = details.code ?? "limit_rejected"; + Object.assign(this, details); + } +} + +function normalizeValue(kind, value) { + const number = Number(value); + if (!Number.isFinite(number) || number <= 0) { + throw new LimitError(`${LIMIT_KINDS[kind].label} must be a positive number.`, { + code: "invalid_limit", + kind, + }); + } + return Math.ceil(number); +} + +/** + * Soft limits are warnings with a user-tunable threshold. They never stop work: + * crossing one raises a prompt while the job keeps running, and a submitted + * value is only accepted when it is at least the live value at that instant. + */ +export class LimitPolicy { + #values = { ...DEFAULT_SOFT_LIMITS }; + #live = new Map(); + #file; + #loaded = null; + #listeners = new Set(); + #writing = null; + #dirty = false; + #sequence = 0; + persistError = null; + loadWarning = null; + + constructor(file = LIMITS_FILE) { + this.#file = file; + } + + load() { + this.#loaded ??= (async () => { + try { + const saved = JSON.parse(await readFile(this.#file, "utf8")); + for (const kind of Object.keys(LIMIT_KINDS)) { + const value = Number(saved?.[kind]); + if (Number.isFinite(value) && value > 0) this.#values[kind] = Math.ceil(value); + } + } catch (error) { + if (error?.code === "ENOENT") return; + if (error instanceof SyntaxError) { + this.loadWarning = `Saved limits at ${this.#file} are corrupt and were ignored; defaults are in use (${error.message}).`; + return; + } + throw error; + } + })(); + return this.#loaded; + } + + get(kind) { + return this.#values[kind]; + } + + snapshot() { + return { ...this.#values }; + } + + onChange(listener) { + this.#listeners.add(listener); + return () => this.#listeners.delete(listener); + } + + /** Registers a function that returns the live value for a kind; returns an unregister callback. */ + trackLive(owner, kind, read) { + const key = `${owner}:${kind}`; + this.#live.set(key, { kind, read }); + return () => this.#live.delete(key); + } + + liveCurrent(kind) { + let current = 0; + for (const entry of this.#live.values()) { + if (entry.kind === kind) current = Math.max(current, Number(entry.read()) || 0); + } + return current; + } + + minimum(kind) { + return Math.max(this.liveCurrent(kind), 1); + } + + /** Synchronous so the live check and the write cannot interleave. */ + submit(kind, value) { + if (!LIMIT_KINDS[kind]) { + throw new LimitError(`Unknown limit: ${kind}.`, { code: "unknown_limit", kind }); + } + const requested = normalizeValue(kind, value); + const minimum = this.minimum(kind); + if (requested < minimum) { + throw new LimitError( + `${LIMIT_KINDS[kind].label} must be at least the current value (${minimum.toLocaleString()}).`, + { code: "below_current", kind, minimum, requested }, + ); + } + this.#values[kind] = requested; + for (const listener of this.#listeners) listener(kind, requested); + this.#schedulePersist(); + return { kind, limit: requested, minimum }; + } + + /** Resolves once every submitted value has been written (or failed; see persistError). */ + async flush() { + while (this.#writing) await this.#writing; + } + + // Writes are serialized; each write snapshots the latest values, so the last submit wins. + #schedulePersist() { + this.#dirty = true; + if (this.#writing) return; + this.#writing = (async () => { + try { + while (this.#dirty) { + this.#dirty = false; + try { + await this.#persist(); + this.persistError = null; + } catch (error) { + this.persistError = error instanceof Error ? error.message : String(error); + } + } + } finally { + this.#writing = null; + } + })(); + } + + async #persist() { + const temporary = `${this.#file}.${process.pid}.${++this.#sequence}.tmp`; + await mkdir(dirname(this.#file), { recursive: true }); + try { + await writeFile(temporary, `${JSON.stringify(this.#values, null, 2)}\n`, "utf8"); + await rename(temporary, this.#file); + } catch (error) { + await rm(temporary, { force: true }).catch(() => {}); + throw error; + } + } +} + +export const limitPolicy = new LimitPolicy(); diff --git a/extensions/pr-artifact-explorer/preview.mjs b/extensions/pr-artifact-explorer/preview.mjs index d6f2194fff..052867028b 100644 --- a/extensions/pr-artifact-explorer/preview.mjs +++ b/extensions/pr-artifact-explorer/preview.mjs @@ -1,10 +1,9 @@ import { createServer } from "node:http"; import { posix } from "node:path"; import { Transform } from "node:stream"; -import { getCachedEntry } from "./cache.mjs"; +import { getCachedEntry, streamCachedEntry } from "./cache.mjs"; import { mimeForPath } from "./detector.mjs"; import { isCanonicalHost } from "./security.mjs"; -import { streamZipEntry } from "./zip.mjs"; const previewServers = new Map(); const HTML_INJECTION_SEARCH_BYTES = 64 * 1024; @@ -188,9 +187,8 @@ async function servePreviewRequest( res.end(themeBridge); return; } - await streamZipEntry( - context.archivePath, - context.entry, + await streamCachedEntry( + context, res, themeBridge ? createHtmlInjectionTransform(themeBridge) : null, ); diff --git a/extensions/pr-artifact-explorer/render.mjs b/extensions/pr-artifact-explorer/render.mjs index a43f429207..e02382ae4b 100644 --- a/extensions/pr-artifact-explorer/render.mjs +++ b/extensions/pr-artifact-explorer/render.mjs @@ -23,6 +23,7 @@ export const HTML = ` + @@ -69,12 +70,32 @@ export const HTML = `
-
- + +
+ Cache + +

Running jobs continue during a restart.

+
-
Elapsed
${escapeHtml(formatSeconds(report.elapsed))}
-
Test time
${escapeHtml(formatSeconds(report.caseSeconds))}
+
Elapsed
${escapeHtml(formatSeconds(report.elapsed) || "Not recorded")}
+
Test time
${escapeHtml(formatSeconds(report.caseSeconds) || "Not recorded")}
${mismatch} diff --git a/extensions/pr-artifact-explorer/media-junit.test.mjs b/extensions/pr-artifact-explorer/media-junit.test.mjs index 994c9dfa51..8122b362c8 100644 --- a/extensions/pr-artifact-explorer/media-junit.test.mjs +++ b/extensions/pr-artifact-explorer/media-junit.test.mjs @@ -200,4 +200,19 @@ test("JUnit viewer detects, aggregates, escapes and falls back in real Chromium" return [...out.querySelectorAll("[data-trx-result]")].filter((r) => !r.hidden).length; }, FIXTURES.nested); assert.ok(filtered >= 1); + + const timing = await page.evaluate((cases) => cases.map(([xml]) => { + const out = document.getElementById("out"); + JunitPreview.render(xml, out, { highlightXml: (s) => s }); + return [out.querySelector("[data-junit-elapsed]")?.textContent, out.querySelector("[data-junit-test-time]")?.textContent]; + }), [ + [''], + [''], + [''], + [''], + ]); + assert.deepEqual(timing[0], ["Not recorded", "Not recorded"]); + assert.deepEqual(timing[1], ["0 s", "0 s"]); + assert.deepEqual(timing[2], ["Not recorded", "Not recorded"]); + assert.deepEqual(timing[3], ["1.5 s", "1 s"]); }); From 16c78af71dd1462258ca21ff67202751df62209a Mon Sep 17 00:00:00 2001 From: David Pine <7679720+IEvangelist@users.noreply.github.com> Date: Tue, 13 Oct 2026 10:17:57 -0500 Subject: [PATCH 05/29] Fix JUnit search to match contiguous phrases Per-term substring matching made 'Browser A' match every row via the 'a' term. Match the whole normalized phrase and cover it in the Chromium regression. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: 72ee5a2d-bcbb-4e0f-b86f-6ad56d4fc033 --- .../pr-artifact-explorer/assets/junit-preview.js | 7 +++---- .../pr-artifact-explorer/media-junit.test.mjs | 16 ++++++++++++++++ 2 files changed, 19 insertions(+), 4 deletions(-) diff --git a/extensions/pr-artifact-explorer/assets/junit-preview.js b/extensions/pr-artifact-explorer/assets/junit-preview.js index fc81bd153e..54f6a22ba7 100644 --- a/extensions/pr-artifact-explorer/assets/junit-preview.js +++ b/extensions/pr-artifact-explorer/assets/junit-preview.js @@ -347,17 +347,16 @@ function applyFilters(preview) { if (!preview) return; - const terms = String(preview.querySelector("[data-trx-search-input]")?.value ?? "") + const phrase = String(preview.querySelector("[data-trx-search-input]")?.value ?? "") .trim() .toLocaleLowerCase() - .split(/\s+/) - .filter(Boolean); + .replace(/\s+/g, " "); const category = preview.querySelector('[data-trx-filter][aria-pressed="true"]')?.dataset.trxFilter ?? "all"; const results = [...preview.querySelectorAll("[data-trx-result]")]; let visible = 0; for (const result of results) { const matches = (category === "all" || result.dataset.trxCategory === category) && - terms.every((term) => (result.dataset.trxSearch ?? "").includes(term)); + (result.dataset.trxSearch ?? "").replace(/\s+/g, " ").includes(phrase); result.hidden = !matches; if (matches) visible += 1; } diff --git a/extensions/pr-artifact-explorer/media-junit.test.mjs b/extensions/pr-artifact-explorer/media-junit.test.mjs index 8122b362c8..85da5ece8f 100644 --- a/extensions/pr-artifact-explorer/media-junit.test.mjs +++ b/extensions/pr-artifact-explorer/media-junit.test.mjs @@ -215,4 +215,20 @@ test("JUnit viewer detects, aggregates, escapes and falls back in real Chromium" assert.deepEqual(timing[1], ["0 s", "0 s"]); assert.deepEqual(timing[2], ["Not recorded", "Not recorded"]); assert.deepEqual(timing[3], ["1.5 s", "1 s"]); + + const search = await page.evaluate((xml) => { + const out = document.getElementById("out"); + JunitPreview.render(xml, out, { highlightXml: (s) => s }); + const preview = out.querySelector(".trx-preview"); + const input = preview.querySelector("[data-trx-search-input]"); + const visible = () => [...preview.querySelectorAll("[data-trx-result]")].filter((r) => !r.hidden).length; + input.value = "Browser A"; + JunitPreview.applyFilters(preview); + const a = [visible(), preview.querySelector("[data-trx-result-count]").textContent]; + input.value = "browser b"; + JunitPreview.applyFilters(preview); + return [a, visible()]; + }, ``); + assert.deepEqual(search[0], [2, "2 of 4 results"]); + assert.equal(search[1], 2); }); From f6dcaeea3272a0612525687f396fd357ad14b822 Mon Sep 17 00:00:00 2001 From: David Pine <7679720+IEvangelist@users.noreply.github.com> Date: Tue, 13 Oct 2026 10:22:29 -0500 Subject: [PATCH 06/29] Label all-skipped JUnit runs as Skipped Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: 72ee5a2d-bcbb-4e0f-b86f-6ad56d4fc033 --- .../pr-artifact-explorer/assets/junit-preview.js | 5 +++-- .../pr-artifact-explorer/media-junit.test.mjs | 14 ++++++++++++++ 2 files changed, 17 insertions(+), 2 deletions(-) diff --git a/extensions/pr-artifact-explorer/assets/junit-preview.js b/extensions/pr-artifact-explorer/assets/junit-preview.js index 54f6a22ba7..4fe9c873b3 100644 --- a/extensions/pr-artifact-explorer/assets/junit-preview.js +++ b/extensions/pr-artifact-explorer/assets/junit-preview.js @@ -269,8 +269,9 @@ .slice(0, MAX_RENDERED_RESULTS) .map(({ result }) => result); const bad = report.counts.error + report.counts.failed; - const outcome = bad > 0 ? "failed" : report.total === 0 ? "skipped" : "passed"; - const outcomeLabel = bad > 0 ? "Failed" : report.total === 0 ? "No tests" : "Passed"; + const allSkipped = report.total > 0 && report.counts.skipped === report.total; + const outcome = bad > 0 ? "failed" : report.total === 0 || allSkipped ? "skipped" : "passed"; + const outcomeLabel = bad > 0 ? "Failed" : report.total === 0 ? "No tests" : allSkipped ? "Skipped" : "Passed"; const mismatch = report.declaredTotal !== null && report.declaredTotal !== report.total ? `
${icon("eye")} The report declares ${report.declaredTotal.toLocaleString()} tests but contains ${report.total.toLocaleString()} test cases. Totals below are counted from the test cases.
` : ""; diff --git a/extensions/pr-artifact-explorer/media-junit.test.mjs b/extensions/pr-artifact-explorer/media-junit.test.mjs index 85da5ece8f..8ce4ca166d 100644 --- a/extensions/pr-artifact-explorer/media-junit.test.mjs +++ b/extensions/pr-artifact-explorer/media-junit.test.mjs @@ -231,4 +231,18 @@ test("JUnit viewer detects, aggregates, escapes and falls back in real Chromium" }, ``); assert.deepEqual(search[0], [2, "2 of 4 results"]); assert.equal(search[1], 2); + + const outcomes = await page.evaluate((reports) => reports.map((xml) => { + const out = document.getElementById("out"); + JunitPreview.render(xml, out, { highlightXml: (s) => s }); + const el = out.querySelector(".trx-run-outcome"); + return [el.textContent.trim(), el.className.includes("trx-outcome-skipped")]; + }), [ + '', + '', + '', + ]); + assert.deepEqual(outcomes[0], ["Skipped", true]); + assert.deepEqual(outcomes[1], ["Passed", false]); + assert.deepEqual(outcomes[2], ["No tests", true]); }); From 8f9a0c3851296436f33be7482a20a7335eda2522 Mon Sep 17 00:00:00 2001 From: David Pine <7679720+IEvangelist@users.noreply.github.com> Date: Tue, 13 Oct 2026 11:30:46 -0500 Subject: [PATCH 07/29] feat(artifact-explorer): universal Raw toggle, inherited browser theme, open in default browser Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: 72ee5a2d-bcbb-4e0f-b86f-6ad56d4fc033 --- .../pr-artifact-explorer/assets/app.css | 35 ++++ extensions/pr-artifact-explorer/assets/app.js | 96 ++++++++++- .../pr-artifact-explorer/assets/browser.js | 44 ++++- extensions/pr-artifact-explorer/capture.mjs | 21 ++- .../pr-artifact-explorer/external-open.mjs | 72 ++++++++ extensions/pr-artifact-explorer/preview.mjs | 24 ++- .../pr-artifact-explorer/raw-open.test.mjs | 160 ++++++++++++++++++ .../pr-artifact-explorer/raw-wiring.test.mjs | 37 ++++ extensions/pr-artifact-explorer/raw.mjs | 113 +++++++++++++ extensions/pr-artifact-explorer/server.mjs | 66 +++++++- skills/pr-artifact-explorer/SKILL.md | 3 + 11 files changed, 661 insertions(+), 10 deletions(-) create mode 100644 extensions/pr-artifact-explorer/external-open.mjs create mode 100644 extensions/pr-artifact-explorer/raw-open.test.mjs create mode 100644 extensions/pr-artifact-explorer/raw-wiring.test.mjs create mode 100644 extensions/pr-artifact-explorer/raw.mjs diff --git a/extensions/pr-artifact-explorer/assets/app.css b/extensions/pr-artifact-explorer/assets/app.css index 11bc0447e3..1523b91e69 100644 --- a/extensions/pr-artifact-explorer/assets/app.css +++ b/extensions/pr-artifact-explorer/assets/app.css @@ -2432,6 +2432,41 @@ select { align-items: center; } +.preview-mode { + display: inline-flex; + gap: 2px; +} + +.preview-mode [aria-pressed="true"] { + background: var(--app-bg-inset); + font-weight: 600; +} + +.raw-view { + display: flex; + min-height: 0; + padding: var(--base-size-12, 12px); + flex-direction: column; + gap: var(--base-size-8, 8px); +} + +.raw-note { + color: var(--app-fg-muted); + font-size: 12px; +} + +.raw-content { + margin: 0; + padding: var(--base-size-12, 12px); + overflow: auto; + background: var(--app-bg); + border: 1px solid var(--app-border); + border-radius: 6px; + font-family: var(--app-mono); + font-size: 12px; + white-space: pre; +} + .preview-path { min-width: 0; overflow: hidden; diff --git a/extensions/pr-artifact-explorer/assets/app.js b/extensions/pr-artifact-explorer/assets/app.js index 0bee4222bb..c3c8ec65b2 100644 --- a/extensions/pr-artifact-explorer/assets/app.js +++ b/extensions/pr-artifact-explorer/assets/app.js @@ -636,8 +636,11 @@ function pullHash(repository, pullNumber) { return `#/pull/${encodeURIComponent(repository)}/${Number(pullNumber)}`; } -function artifactHash(repository, pullNumber, artifactId, filePath = null) { - const query = filePath ? `?file=${encodeURIComponent(filePath)}` : ""; +function artifactHash(repository, pullNumber, artifactId, filePath = null, raw = false) { + const params = []; + if (filePath) params.push(`file=${encodeURIComponent(filePath)}`); + if (filePath && raw) params.push("view=raw"); + const query = params.length ? `?${params.join("&")}` : ""; return `#/artifact/${encodeURIComponent(repository)}/${Number(pullNumber)}/${Number(artifactId)}${query}`; } @@ -672,6 +675,7 @@ function parseRoute() { pullNumber: Number(parts[2]), artifactId: Number(parts[3]), filePath: query.get("file"), + raw: query.get("view") === "raw", }; } if (parts[0] === "issue" && parts[1] && parts[2]) { @@ -3922,6 +3926,77 @@ function stepPlayerTextSize(direction) { } } +let rawRequestToken = 0; + +function syncPreviewModeControl() { + const raw = currentArtifact?.rawMode === true; + for (const button of document.querySelectorAll("[data-preview-mode]")) { + const active = (button.dataset.previewMode === "raw") === raw; + button.setAttribute("aria-pressed", String(active)); + button.classList.toggle("is-active", active); + } +} + +async function setPreviewMode(mode) { + const artifact = currentArtifact; + if (!artifact?.selectedPath) return; + const raw = mode === "raw"; + if ((artifact.rawMode === true) === raw) return; + artifact.rawMode = raw; + history.replaceState( + null, + "", + artifactHash(artifact.repository, artifact.pullNumber, artifact.id, artifact.selectedPath, raw), + ); + const entry = artifact.analysis.entries.find((item) => item.path === artifact.selectedPath); + if (entry) await previewArtifactFile(entry, renderSequence); +} + +async function renderRawPreview(entry, preview, sequence) { + const artifact = currentArtifact; + const token = ++rawRequestToken; + const stale = () => + token !== rawRequestToken || + sequence !== renderSequence || + currentArtifact !== artifact || + artifact.selectedPath !== entry.path || + artifact.rawMode !== true; + preview.innerHTML = `
`; + let result; + try { + result = await api(`/api/artifacts/${artifact.id}/raw?path=${encodeURIComponent(entry.path)}`); + } catch (error) { + if (stale()) return; + const box = document.createElement("div"); + box.className = "preview-error"; + box.setAttribute("role", "alert"); + box.textContent = `Could not read the raw bytes: ${error instanceof Error ? error.message : String(error)}. Use Download to get the original file.`; + preview.replaceChildren(box); + return; + } + if (stale()) return; + const wrap = document.createElement("div"); + wrap.className = "raw-view"; + wrap.dataset.rawMode = result.mode; + const note = document.createElement("p"); + note.className = "raw-note"; + if (result.mode === "unsupported") { + note.textContent = result.reason || "These bytes cannot be inspected safely. Download the original artifact ZIP instead."; + wrap.append(note); + } else { + const parts = [formatBytes(result.size)]; + if (result.encoding) parts.push(result.encoding); + if (result.truncated) parts.push(`partial: showing the first ${formatBytes(result.shown)}; Download has the full file`); + note.textContent = [parts.join(" · "), result.note].filter(Boolean).join(" — "); + const pre = document.createElement("pre"); + pre.className = "raw-content"; + pre.tabIndex = 0; + pre.textContent = result.mode === "empty" ? "(empty file)" : result.content; + wrap.append(note, pre); + } + preview.replaceChildren(wrap); +} + async function previewArtifactFile(entry, sequence) { disposePlayer(); const artifact = currentArtifact; @@ -3942,6 +4017,11 @@ async function previewArtifactFile(entry, sequence) { downloadLink.hidden = false; const browserAction = document.getElementById("preview-open-browser"); if (browserAction) browserAction.hidden = true; + syncPreviewModeControl(entry); + if (artifact.rawMode) { + await renderRawPreview(entry, preview, sequence); + return; + } preview.innerHTML = `
@@ -4167,6 +4247,7 @@ async function selectArtifactFile(path, updateHash = true) { currentArtifact.pullNumber, currentArtifact.id, path, + currentArtifact.rawMode === true, ), ); } @@ -4229,6 +4310,7 @@ async function renderArtifact(route, sequence) { analysis, fileTree: createArtifactFileTreeState(analysis.entries, preferredPath), selectedPath: preferredPath, + rawMode: route.raw === true && Boolean(route.filePath), }; setBreadcrumbs(artifactBreadcrumbItems(currentArtifact, preferredPath)); const primary = analysis.primary; @@ -4285,6 +4367,10 @@ async function renderArtifact(route, sequence) { ${icon("eye")} ${preferredPath ? escapeHtml(preferredPath) : "Select a file"} + + + +
@@ -4950,6 +5036,12 @@ view.addEventListener("input", (event) => { }); view.addEventListener("click", (event) => { + const modeButton = event.target.closest("[data-preview-mode]"); + if (modeButton) { + event.preventDefault(); + void setPreviewMode(modeButton.dataset.previewMode); + return; + } const trxView = event.target.closest("[data-trx-view]"); if (trxView) { event.preventDefault(); diff --git a/extensions/pr-artifact-explorer/assets/browser.js b/extensions/pr-artifact-explorer/assets/browser.js index e3b332066e..c5cf635979 100644 --- a/extensions/pr-artifact-explorer/assets/browser.js +++ b/extensions/pr-artifact-explorer/assets/browser.js @@ -449,7 +449,7 @@ const DOCS_SECTIONS = [
  1. Choose a repository. Enter github/awesome-copilot in the header, or use the repository quick switch. Pins and favorites make frequently used repositories easier to return to.
  2. Find the change. Select a pull request from the list. To go straight to one, paste its GitHub URL or enter open PR 123 in the address bar (g then b) using the current repository context.
    3. -
  3. Inspect an artifact. Choose an available workflow artifact, then browse the file list. Select a supported file to read, watch, or preview it.
    4. +
  4. Inspect an artifact. Choose an available workflow artifact, then browse the file list. Select a supported file to read, watch, or preview it. Use Raw beside Download to see the original source or a bounded hex view; Preview returns to the rendered view.

Jump straight to an artifact

Paste a GitHub artifact URL or an Explorer share route into the address field. Explorer resolves the target; you do not need to reconstruct its local preview address.

@@ -468,6 +468,10 @@ const DOCS_SECTIONS = [

Device size changes the layout. Mobile uses 390 × 844 CSS pixels, Tablet 768 × 1024, and Desktop 1440 × 900. Native follows the panel. Choose Custom to reveal width and height in Options; Rotate switches orientation.

Zoom changes only what you see. The − and + buttons scale the preview without changing its CSS viewport. In Options, Fit makes it fit the available width, and 100% resets the visual scale.

${docsFigure("preview-controls", "Mobile preview controls with visual zoom separate from the device preset.", "Sample mobile preview: the device sets the page layout; zoom adjusts its display size.", 882, 480)} +

Open it in your default browser

+

Choose Options → Open in default browser to open the current page in your operating system’s browser. For a website artifact, Explorer restarts its local preview with your current light or dark theme and keeps the same route, query and hash. That local server runs only while Artifact Explorer is open; it is not a published site.

+

Theme

+

Explorer’s own controls follow the canvas theme. Website artifacts it serves, and its fresh screenshots and controlled Chromium, follow the current light or dark setting and update when it changes. External websites keep their own theme rules.

If the page will not embed

Some sites deliberately refuse to appear in an iframe. Explorer reports the restriction rather than bypassing it. Open Options → Controlled browser to use an isolated Chromium view with its own real history.

NextCapture the right page stateFix a blank or unavailable preview
`], @@ -705,6 +709,7 @@ function renderBrowser(route) {
+
@@ -781,7 +786,7 @@ function renderBrowser(route) { const controlledBody = () => { const { w, h } = viewport(); - return { preset: state.preset === "native" ? "custom" : state.preset, width: w, height: h }; + return { preset: state.preset === "native" ? "custom" : state.preset, width: w, height: h, theme: resolvedCanvasTheme() }; }; async function showControlledFrame() { @@ -868,6 +873,16 @@ function renderBrowser(route) { notice.hidden = false; notice.textContent = error instanceof Error ? error.message : String(error); } + let owned = false; + try { + owned = (await api("/api/browser/owned", { method: "POST", body: { url } })).owned === true; + } catch { + owned = false; + } + if (browserState !== state) return; + state.owned = owned; + if (owned) frame.setAttribute("data-theme-aware-preview", ""); + else frame.removeAttribute("data-theme-aware-preview"); frame.src = url; } @@ -910,7 +925,7 @@ function renderBrowser(route) { ? await api("/api/controlled/screenshot", { method: "POST", body: { fullPage: false } }) : await api("/api/capture", { method: "POST", - body: { url: state.url, preset: state.preset === "native" ? "custom" : state.preset, width: w, height: h, fullPage: false }, + body: { url: state.url, preset: state.preset === "native" ? "custom" : state.preset, width: w, height: h, fullPage: false, theme: resolvedCanvasTheme() }, }); const file = capture.path.split(/[\\/]/).pop(); const src = `/api/screenshots/${file}?token=${encodeURIComponent(capabilityToken)}`; @@ -969,7 +984,7 @@ function renderBrowser(route) { const view = { preset: state.preset, width: state.preset === "custom" ? w : undefined, height: state.preset === "custom" ? h : undefined, zoom: state.fit ? undefined : state.zoom, orientation: state.orientation === "landscape" ? "landscape" : undefined }; let sourceRoute = null; try { - sourceRoute = state.url && new URL(state.url, location.href).origin === location.origin ? sessionStorage.getItem("pae.shareRoute") : null; + sourceRoute = state.url && state.owned ? sessionStorage.getItem("pae.shareRoute") : null; } catch { sourceRoute = null; } @@ -977,6 +992,26 @@ function renderBrowser(route) { const route = sourceRoute ? `${sourceRoute}${sourceRoute.includes("?") ? "&" : "?"}v=${encodeViewClient(view)}` : browserHash({ ...view, url: state.url || undefined }); void copyText(route, sourceRoute ? "Copied artifact share route" : "Copied share route"); }); + $("br-open-external").addEventListener("click", async (event) => { + if (!state.url) return showToast("Open an address first.", "error"); + const button = event.currentTarget; + button.disabled = true; + try { + await api("/api/browser/open-external", { method: "POST", body: { url: state.url, theme: resolvedCanvasTheme() } }); + showToast("Opened in your default browser"); + } catch (error) { + showToast(error instanceof Error ? error.message : String(error), "error"); + } finally { + button.disabled = false; + } + }); + frame.addEventListener("load", () => { + if (frame.hasAttribute("data-theme-aware-preview")) syncPreviewTheme(); + }); + const themeObserver = new MutationObserver(() => { + if (state.controlled && browserState === state) void api("/api/controlled/theme", { method: "POST", body: { theme: resolvedCanvasTheme() } }).then(showControlledFrame).catch(() => {}); + }); + themeObserver.observe(document.documentElement, { attributes: true, attributeFilter: ["data-color-mode", "data-theme-tone"] }); $("br-kbd").addEventListener("click", (event) => { const hints = $("br-hints"); hints.hidden = !hints.hidden; @@ -990,6 +1025,7 @@ function renderBrowser(route) { state.api = { go, refresh, setZoom, screenshot, load, applyLayout, viewport, setControlled }; browserCleanup = () => { window.removeEventListener("resize", onResize); + themeObserver.disconnect(); disposeOptions(); }; diff --git a/extensions/pr-artifact-explorer/capture.mjs b/extensions/pr-artifact-explorer/capture.mjs index b90be9d596..7f32d24671 100644 --- a/extensions/pr-artifact-explorer/capture.mjs +++ b/extensions/pr-artifact-explorer/capture.mjs @@ -139,9 +139,16 @@ async function savePng(png, outputDir) { * Renders the URL in a fresh, isolated headless Chromium and saves a PNG. * This is a NEW render, not a snapshot of the page currently shown in the canvas. */ -export async function captureScreenshot({ url, fullPage = false, outputDir = getScreenshotRoot(), ...viewportOptions }) { +export function normalizeColorScheme(value) { + if (value === undefined || value === null) return undefined; + if (value === "light" || value === "dark") return value; + throw new CaptureError("invalid_viewport", 'Color scheme must be "light" or "dark".'); +} + +export async function captureScreenshot({ url, fullPage = false, outputDir = getScreenshotRoot(), colorScheme, ...viewportOptions }) { const target = assertHttpUrl(url); const viewport = resolveViewport(viewportOptions); + const scheme = normalizeColorScheme(colorScheme); const browser = await launchChromium(); try { // A new context has no cookies or profile data and is discarded afterwards. @@ -150,6 +157,7 @@ export async function captureScreenshot({ url, fullPage = false, outputDir = get deviceScaleFactor: viewport.deviceScaleFactor, isMobile: viewport.isMobile, hasTouch: viewport.hasTouch, + ...(scheme ? { colorScheme: scheme } : {}), }); const page = await context.newPage(); let status = null; @@ -169,6 +177,7 @@ export async function captureScreenshot({ url, fullPage = false, outputDir = get return { ...(await savePng(png, outputDir)), source: "fresh-render", + colorScheme: scheme ?? null, note: "Fresh headless Chromium render of the URL. It does not include unsaved page state from the canvas preview.", requestedUrl: target.href, finalUrl, @@ -193,11 +202,20 @@ export class ControlledBrowser { #page = null; #viewport = null; #starting = null; + #colorScheme = undefined; get active() { return Boolean(this.#page); } + async setColorScheme(value) { + const scheme = normalizeColorScheme(value); + if (!scheme || scheme === this.#colorScheme) return { colorScheme: this.#colorScheme ?? null }; + this.#colorScheme = scheme; + if (this.#page) await this.#page.emulateMedia({ colorScheme: scheme }); + return { colorScheme: scheme }; + } + async #ensure(viewportOptions) { if (this.#page) return; this.#starting ??= (async () => { @@ -217,6 +235,7 @@ export class ControlledBrowser { deviceScaleFactor: v.deviceScaleFactor, isMobile: v.isMobile, hasTouch: v.hasTouch, + ...(this.#colorScheme ? { colorScheme: this.#colorScheme } : {}), }); this.#page = await this.#context.newPage(); } diff --git a/extensions/pr-artifact-explorer/external-open.mjs b/extensions/pr-artifact-explorer/external-open.mjs new file mode 100644 index 0000000000..183576479f --- /dev/null +++ b/extensions/pr-artifact-explorer/external-open.mjs @@ -0,0 +1,72 @@ +import { spawn } from "node:child_process"; + +export class ExternalOpenError extends Error { + constructor(message, code = "invalid_url") { + super(message); + this.name = "ExternalOpenError"; + this.code = code; + } +} + +const MAX_URL_LENGTH = 2048; + +/** Returns a normalized http(s) URL or throws. Rejects credentials, control characters and other schemes. */ +export function validateExternalUrl(value) { + const text = String(value ?? ""); + if (!text || text.length > MAX_URL_LENGTH) throw new ExternalOpenError("Enter an http(s) URL (max 2048 characters)."); + // eslint-disable-next-line no-control-regex + if (/[\u0000-\u0020\u007f-\u009f]/.test(text)) throw new ExternalOpenError("The URL contains spaces or control characters."); + let parsed; + try { + parsed = new URL(text); + } catch { + throw new ExternalOpenError("Enter a valid http(s) URL."); + } + if (parsed.protocol !== "http:" && parsed.protocol !== "https:") { + throw new ExternalOpenError("Only http(s) URLs can be opened in the default browser."); + } + if (parsed.username || parsed.password) throw new ExternalOpenError("URLs with embedded credentials are not allowed."); + if (!parsed.hostname) throw new ExternalOpenError("The URL has no host."); + return parsed.href; +} + +export function launcherCommand(url, platform = process.platform) { + if (platform === "win32") return { command: "rundll32.exe", args: ["url.dll,FileProtocolHandler", url] }; + if (platform === "darwin") return { command: "open", args: [url] }; + return { command: "xdg-open", args: [url] }; +} + +function defaultOpener(url) { + const { command, args } = launcherCommand(url); + return new Promise((resolve, reject) => { + let child; + try { + child = spawn(command, args, { shell: false, windowsHide: true, detached: true, stdio: "ignore" }); + } catch (error) { + reject(error); + return; + } + child.once("error", reject); + child.once("spawn", () => { + child.unref(); + resolve(); + }); + }); +} + +let opener = defaultOpener; + +/** Test seam: replaces the OS launcher. Pass null to restore the default. */ +export function setExternalOpener(fn) { + opener = fn ?? defaultOpener; +} + +export async function openInDefaultBrowser(url) { + const safe = validateExternalUrl(url); + try { + await opener(safe); + } catch (error) { + throw new ExternalOpenError(`Could not launch the default browser: ${error.message}`, "launch_failed"); + } + return safe; +} diff --git a/extensions/pr-artifact-explorer/preview.mjs b/extensions/pr-artifact-explorer/preview.mjs index 052867028b..a90463df00 100644 --- a/extensions/pr-artifact-explorer/preview.mjs +++ b/extensions/pr-artifact-explorer/preview.mjs @@ -258,10 +258,32 @@ export async function startStaticPreview(artifactId, entryPath, options) { } serverEntry.host = `127.0.0.1:${address.port}`; const url = `http://127.0.0.1:${address.port}/`; - previewServers.set(key, { artifactId: String(artifactId), server, url, canvasOrigin: parentOrigin }); + previewServers.set(key, { + artifactId: String(artifactId), + entryPath: context.entry.name, + server, + url, + canvasOrigin: parentOrigin, + theme, + }); return url; } +/** Maps an origin back to the owned static preview serving it, or null for any foreign origin. */ +export function describeOwnedPreview(origin) { + for (const value of previewServers.values()) { + if (new URL(value.url).origin === origin) { + return { + artifactId: value.artifactId, + entryPath: value.entryPath, + theme: value.theme, + canvasOrigin: value.canvasOrigin, + }; + } + } + return null; +} + export async function stopStaticPreviewsForArtifact(artifactId) { const id = String(artifactId); const matching = [...previewServers.entries()].filter( diff --git a/extensions/pr-artifact-explorer/raw-open.test.mjs b/extensions/pr-artifact-explorer/raw-open.test.mjs new file mode 100644 index 0000000000..fe3403f3df --- /dev/null +++ b/extensions/pr-artifact-explorer/raw-open.test.mjs @@ -0,0 +1,160 @@ +import assert from "node:assert/strict"; +import { mkdir, mkdtemp, rm, writeFile } from "node:fs/promises"; +import { tmpdir } from "node:os"; +import { join } from "node:path"; +import test from "node:test"; +import { crc32, deflateRawSync } from "node:zlib"; +import { ExternalOpenError, launcherCommand, setExternalOpener, validateExternalUrl } from "./external-open.mjs"; + +const u16 = (v) => Buffer.from(Uint16Array.of(v).buffer); +const u32 = (v) => Buffer.from(Uint32Array.of(v).buffer); + +function zipOf(name, raw, { deflate = false, flags = 0, method } = {}) { + const data = Buffer.from(deflate ? deflateRawSync(raw) : raw); + const nameBuf = Buffer.from(name); + const m = method ?? (deflate ? 8 : 0); + const crc = crc32(raw); + const local = Buffer.concat([ + u32(0x04034b50), u16(20), u16(flags), u16(m), u16(0), u16(0x21), + u32(crc), u32(data.length), u32(raw.length), u16(nameBuf.length), u16(0), nameBuf, data, + ]); + const central = Buffer.concat([ + u32(0x02014b50), u16(20), u16(20), u16(flags), u16(m), u16(0), u16(0x21), + u32(crc), u32(data.length), u32(raw.length), + u16(nameBuf.length), u16(0), u16(0), u16(0), u16(0), u32(0), u32(0), nameBuf, + ]); + return Buffer.concat([ + local, central, + u32(0x06054b50), u16(0), u16(0), u16(1), u16(1), u32(central.length), u32(local.length), u16(0), + ]); +} + +const sharedHome = await mkdtemp(join(tmpdir(), "pae-raw-")); +process.env.COPILOT_HOME = sharedHome; + +test("hexDump formats offset, hex and ASCII without decoding", async () => { + const { hexDump } = await import("./raw.mjs"); + const dump = hexDump(Buffer.from([0x41, 0x00, 0xff, 0x7e]), 16); + assert.match(dump, /^00000010 {2}41 00 ff 7e/); + assert.match(dump, /\|A\.\.~\|$/); +}); + +test("raw view returns exact source, bounded hex, and explains unsupported entries", async (t) => { + const home = sharedHome; + const instanceId = `raw-${Date.now()}`; + const { startInstance, stopInstance } = await import("./server.mjs"); + const server = await startInstance(instanceId, null, () => {}); + t.after(async () => { + await stopInstance(instanceId); + await rm(home, { recursive: true, force: true }); + }); + const cache = join(home, "extensions", "pr-artifact-explorer", "artifacts", "cache"); + await mkdir(cache, { recursive: true }); + + const ugly = Buffer.from('{"b":1,\r\n "a" :[1,2],"é":"ü"}\r\n'); + const bin = Buffer.from(Array.from({ length: 40000 }, (_, i) => (i * 7) % 256)); + const bigText = Buffer.from("line of text\n".repeat(400000)); + const fixtures = [ + ["2001", "d/data.json", ugly, {}], + ["2002", "d/empty.txt", Buffer.alloc(0), {}], + ["2003", "d/movie.webm", bin, { deflate: true }], + ["2004", "d/big.log", bigText, { deflate: true }], + ["2005", "d/secret.txt", Buffer.from("x"), { flags: 1 }], + ["2006", "d/odd.txt", Buffer.from("abc"), { method: 14 }], + ["2007", "d/tiny.png", Buffer.from([0x89, 0x50, 0x4e, 0x47]), {}], + ]; + for (const [id, name, content, options] of fixtures) { + await writeFile(join(cache, `${id}.zip`), zipOf(name, content, options)); + await writeFile( + join(cache, `${id}.json`), + JSON.stringify({ repository: "o/r", artifact: { id: Number(id), name: "a" }, entries: [{ name, kind: "binary" }] }), + ); + } + const raw = async (id, name) => { + const response = await fetch( + `${server.origin}/api/artifacts/${id}/raw?path=${encodeURIComponent(name)}`, + { headers: { "x-pr-artifact-explorer-token": server.token } }, + ); + return { status: response.status, body: await response.json() }; + }; + + const json = await raw(2001, "d/data.json"); + assert.equal(json.status, 200, JSON.stringify(json.body)); + assert.equal(json.body.mode, "text"); + assert.equal(json.body.content, ugly.toString("utf8"), "JSON is not reserialized"); + assert.equal(json.body.truncated, false); + + const empty = await raw(2002, "d/empty.txt"); + assert.equal(empty.body.mode, "empty"); + assert.equal(empty.body.size, 0); + + const movie = await raw(2003, "d/movie.webm"); + assert.equal(movie.body.mode, "hex"); + assert.equal(movie.body.truncated, true); + assert.equal(movie.body.size, bin.length); + assert.equal(movie.body.shown, 16 * 1024); + assert.equal(movie.body.content.split("\n").length, 1024); + + const big = await raw(2004, "d/big.log"); + assert.equal(big.body.mode, "text"); + assert.equal(big.body.truncated, true); + assert.equal(big.body.size, bigText.length); + assert.ok(big.body.shown < bigText.length); + assert.equal(big.body.content, bigText.subarray(0, big.body.shown).toString("utf8")); + + const small = await raw(2007, "d/tiny.png"); + assert.equal(small.body.mode, "hex"); + assert.equal(small.body.truncated, false); + + const encrypted = await raw(2005, "d/secret.txt"); + assert.equal(encrypted.body.mode, "unsupported"); + assert.match(encrypted.body.reason, /encrypted/); + const odd = await raw(2006, "d/odd.txt"); + assert.equal(odd.body.mode, "unsupported"); + assert.match(odd.body.reason, /method 14/); + + const missing = await raw(2001, "d/nope.txt"); + assert.ok(missing.status >= 400); +}); + +test("external open validates URLs and routes through an injectable launcher", async (t) => { + assert.equal(validateExternalUrl("http://127.0.0.1:3000/a?b=1#c"), "http://127.0.0.1:3000/a?b=1#c"); + for (const bad of ["", "file:///etc/passwd", "javascript:alert(1)", "http://u:p@example.com/", "http://exa mple.com/", "http://a.com/\n", "ftp://x.com", "not a url"]) { + assert.throws(() => validateExternalUrl(bad), ExternalOpenError, bad); + } + assert.deepEqual(launcherCommand("http://a/", "win32"), { command: "rundll32.exe", args: ["url.dll,FileProtocolHandler", "http://a/"] }); + assert.equal(launcherCommand("http://a/", "darwin").command, "open"); + assert.equal(launcherCommand("http://a/", "linux").command, "xdg-open"); + + const home = await mkdtemp(join(tmpdir(), "pae-open-")); + process.env.COPILOT_HOME = home; + const { startInstance, stopInstance } = await import("./server.mjs"); + const instanceId = `open-${Date.now()}`; + const server = await startInstance(instanceId, null, () => {}); + const opened = []; + setExternalOpener(async (url) => { opened.push(url); }); + t.after(async () => { + setExternalOpener(null); + await stopInstance(instanceId); + await rm(home, { recursive: true, force: true }); + }); + const post = (body) => + fetch(`${server.origin}/api/browser/open-external`, { + method: "POST", + headers: { "content-type": "application/json", "x-pr-artifact-explorer-token": server.token }, + body: JSON.stringify(body), + }); + + const ok = await post({ url: "https://example.com/x?y=1#z", theme: "dark" }); + assert.equal(ok.status, 200); + assert.deepEqual(opened, ["https://example.com/x?y=1#z"]); + + const rejected = await post({ url: "javascript:alert(1)" }); + assert.equal(rejected.status, 400); + assert.equal(opened.length, 1, "invalid URLs never reach the launcher"); + + setExternalOpener(async () => { throw new Error("no handler"); }); + const failed = await post({ url: "https://example.com/" }); + assert.equal(failed.status, 502); + assert.match((await failed.json()).error ?? "", /Could not launch/); +}); diff --git a/extensions/pr-artifact-explorer/raw-wiring.test.mjs b/extensions/pr-artifact-explorer/raw-wiring.test.mjs new file mode 100644 index 0000000000..0d422f1384 --- /dev/null +++ b/extensions/pr-artifact-explorer/raw-wiring.test.mjs @@ -0,0 +1,37 @@ +import assert from "node:assert/strict"; +import { readFile } from "node:fs/promises"; +import test from "node:test"; +import { normalizeColorScheme } from "./capture.mjs"; + +const asset = (name) => readFile(new URL(`./assets/${name}`, import.meta.url), "utf8"); + +test("color scheme is validated", () => { + assert.equal(normalizeColorScheme("dark"), "dark"); + assert.equal(normalizeColorScheme("light"), "light"); + assert.throws(() => normalizeColorScheme("neon")); +}); + +test("preview toolbar wires a single Preview/Raw toggle before Download", async () => { + const app = await asset("app.js"); + assert.ok(app.indexOf('class="preview-mode"') < app.indexOf('id="preview-download"')); + assert.match(app, /view=raw/); + assert.match(app, /renderRawPreview/); + assert.equal((app.match(/class="preview-mode"/g) ?? []).length, 1); +}); + +test("browser view syncs theme on load/change and exposes native open", async () => { + const browser = await asset("browser.js"); + assert.match(browser, /data-theme-aware-preview/); + assert.match(browser, /\/api\/browser\/owned/); + assert.match(browser, /id="br-open-external"/); + assert.match(browser, /\/api\/browser\/open-external/); + assert.match(browser, /MutationObserver/); + assert.match(browser, /theme: resolvedCanvasTheme\(\)/); +}); + +test("raw styles exist", async () => { + const css = await asset("app.css"); + for (const selector of [".preview-mode", ".raw-view", ".raw-note", ".raw-content"]) { + assert.ok(css.includes(selector), selector); + } +}); diff --git a/extensions/pr-artifact-explorer/raw.mjs b/extensions/pr-artifact-explorer/raw.mjs new file mode 100644 index 0000000000..e492e001d3 --- /dev/null +++ b/extensions/pr-artifact-explorer/raw.mjs @@ -0,0 +1,113 @@ +import { Writable } from "node:stream"; +import { MAX_INLINE_PREVIEW_BYTES, MAX_TRX_PREVIEW_BYTES } from "./constants.mjs"; +import { getCachedEntry, readCachedEntry, streamCachedEntry, verifyCachedEntry } from "./cache.mjs"; +import { isInlineTextKind, kindForPath } from "./detector.mjs"; + +export const RAW_HEX_PREFIX_BYTES = 16 * 1024; +export const RAW_TEXT_PREFIX_BYTES = 256 * 1024; + +/** Classic offset / hex / ASCII dump. Non-printable bytes render as "."; no decoding, so no mojibake. */ +export function hexDump(bytes, baseOffset = 0) { + const lines = []; + for (let i = 0; i < bytes.length; i += 16) { + const chunk = bytes.subarray(i, i + 16); + const hex = [...chunk].map((b) => b.toString(16).padStart(2, "0")); + while (hex.length < 16) hex.push(" "); + const ascii = [...chunk].map((b) => (b >= 0x20 && b < 0x7f ? String.fromCharCode(b) : ".")).join(""); + lines.push( + `${(baseOffset + i).toString(16).padStart(8, "0")} ${hex.slice(0, 8).join(" ")} ${hex.slice(8).join(" ")} |${ascii}|`, + ); + } + return lines.join("\n"); +} + +function unsupportedReason(entry) { + if (entry.directory) return "This entry is a directory."; + if (entry.symlink) return "This entry is a symbolic link; its target is never followed or read."; + if (entry.encrypted) return "This entry is encrypted, so its original bytes cannot be decoded here."; + return `This entry uses ZIP compression method ${entry.method}, which cannot be safely decoded here.`; +} + +function decodeUtf8(bytes) { + try { + return new TextDecoder("utf-8", { fatal: true, ignoreBOM: true }).decode(bytes); + } catch { + return null; + } +} + +/** Drops an incomplete trailing UTF-8 sequence so a truncated prefix still decodes strictly. */ +function trimIncompleteUtf8(bytes) { + let end = bytes.length; + for (let back = 1; back <= 3 && end - back >= 0; back += 1) { + const b = bytes[end - back]; + if ((b & 0xc0) === 0x80) continue; + const need = b >= 0xf0 ? 4 : b >= 0xe0 ? 3 : b >= 0xc0 ? 2 : 1; + if (need > back) end -= back; + break; + } + return bytes.subarray(0, end); +} + +async function readPrefix(context, length) { + const chunks = []; + const sink = new Writable({ + write(chunk, _enc, cb) { + chunks.push(Buffer.from(chunk)); + cb(); + }, + }); + await verifyCachedEntry(context); + await streamCachedEntry(context, sink, null, { start: 0, end: length - 1 }); + sink.end(); + return Buffer.concat(chunks); +} + +/** + * Builds the Raw view payload for one cached entry. Whole-entry CRC/size verification always + * happens before any bytes are returned; large files return only a bounded, clearly partial prefix. + */ +export async function buildRawView(artifactId, entryPath) { + const context = await getCachedEntry(artifactId, entryPath); + const { entry } = context; + const size = entry.uncompressedSize; + const base = { path: entry.name, size }; + if (!entry.supported) { + return { ...base, mode: "unsupported", supported: false, reason: unsupportedReason(entry) }; + } + if (size === 0) return { ...base, mode: "empty", supported: true, truncated: false, shown: 0 }; + + const kind = kindForPath(entry.name); + if (isInlineTextKind(kind)) { + const limit = kind === "trx" ? MAX_TRX_PREVIEW_BYTES : MAX_INLINE_PREVIEW_BYTES; + if (size <= limit) { + const { content } = await readCachedEntry(artifactId, entryPath, limit); + const text = decodeUtf8(content); + if (text !== null) { + return { ...base, mode: "text", supported: true, truncated: false, shown: size, encoding: "utf-8", content: text }; + } + return hexResult(base, content.subarray(0, RAW_HEX_PREFIX_BYTES), size, "Not valid UTF-8; shown as bytes."); + } + const prefix = trimIncompleteUtf8(await readPrefix(context, RAW_TEXT_PREFIX_BYTES)); + const text = decodeUtf8(prefix); + if (text !== null) { + return { ...base, mode: "text", supported: true, truncated: true, shown: prefix.length, encoding: "utf-8", content: text }; + } + return hexResult(base, prefix.subarray(0, RAW_HEX_PREFIX_BYTES), size, "Not valid UTF-8; shown as bytes."); + } + const prefix = size <= RAW_HEX_PREFIX_BYTES ? await readPrefix(context, size) : await readPrefix(context, RAW_HEX_PREFIX_BYTES); + return hexResult(base, prefix, size, "Binary content; shown as bytes."); +} + +function hexResult(base, bytes, size, encodingNote) { + return { + ...base, + mode: "hex", + supported: true, + truncated: bytes.length < size, + shown: bytes.length, + encoding: "binary", + note: encodingNote, + content: hexDump(bytes), + }; +} diff --git a/extensions/pr-artifact-explorer/server.mjs b/extensions/pr-artifact-explorer/server.mjs index 47dd0eb26a..3b7e8dacb2 100644 --- a/extensions/pr-artifact-explorer/server.mjs +++ b/extensions/pr-artifact-explorer/server.mjs @@ -43,12 +43,15 @@ import { suggestRepositories, } from "./github.mjs"; import { + describeOwnedPreview, startStaticPreview, stopAllStaticPreviews, stopStaticPreviewsForArtifact, stopStaticPreviewsForOrigin, } from "./preview.mjs"; import { ExpiringPromiseCache } from "./memory-cache.mjs"; +import { buildRawView } from "./raw.mjs"; +import { ExternalOpenError, openInDefaultBrowser, validateExternalUrl } from "./external-open.mjs"; import { renderHtml } from "./render.mjs"; import { hasCapabilityToken, @@ -831,6 +834,7 @@ async function handleApi(req, res, entry, url) { height: body.height, deviceScaleFactor: body.deviceScaleFactor, orientation: body.orientation, + colorScheme: body.theme, fullPage: body.fullPage === true, }); return sendJson(res, 200, { capture: result }); @@ -842,14 +846,18 @@ async function handleApi(req, res, entry, url) { } } - const controlledMatch = path.match(/^\/api\/controlled\/(navigate|history|viewport|screenshot|frame|close)$/); + const controlledMatch = path.match(/^\/api\/controlled\/(navigate|history|viewport|screenshot|frame|close|theme)$/); if (req.method === "POST" && controlledMatch) { const body = await readJsonBody(req); const action = controlledMatch[1]; const viewport = { preset: body.preset, width: body.width, height: body.height, deviceScaleFactor: body.deviceScaleFactor, orientation: body.orientation }; try { entry.controlled ??= new ControlledBrowser(); - if (action === "navigate") return sendJson(res, 200, { controlled: await entry.controlled.navigate(body.url, viewport) }); + if (action === "theme") return sendJson(res, 200, { controlled: await entry.controlled.setColorScheme(body.theme) }); + if (action === "navigate") { + await entry.controlled.setColorScheme(body.theme); + return sendJson(res, 200, { controlled: await entry.controlled.navigate(body.url, viewport) }); + } if (action === "history") { if (!["back", "forward", "refresh"].includes(body.direction)) throw new HttpError(400, "direction must be back, forward or refresh."); return sendJson(res, 200, { controlled: await entry.controlled.history(body.direction) }); @@ -1038,6 +1046,60 @@ async function handleApi(req, res, entry, url) { }); } + const rawMatch = path.match(/^\/api\/artifacts\/(\d+)\/raw$/); + if (req.method === "GET" && rawMatch) { + const entryPath = url.searchParams.get("path"); + if (!entryPath) throw new HttpError(400, "File path is required."); + try { + return sendJson(res, 200, await buildRawView(rawMatch[1], entryPath)); + } catch (error) { + if (error instanceof HttpError || error instanceof LimitError) throw error; + const status = /not found|not cached/i.test(error?.message ?? "") ? 404 : 502; + throw new HttpError(status, error?.message || "Could not read the original bytes.", { + code: "raw_unavailable", + cause: error, + }); + } + } + + if (req.method === "POST" && path === "/api/browser/owned") { + const body = await readJsonBody(req); + let origin = null; + try { + origin = new URL(String(body.url ?? "")).origin; + } catch { + origin = null; + } + const owned = origin ? describeOwnedPreview(origin) : null; + return sendJson(res, 200, { owned: Boolean(owned), artifactId: owned?.artifactId ?? null }); + } + + if (req.method === "POST" && path === "/api/browser/open-external") { + const body = await readJsonBody(req); + try { + let target = validateExternalUrl(body.url); + const parsed = new URL(target); + const owned = describeOwnedPreview(parsed.origin); + if (owned && (body.theme === "light" || body.theme === "dark")) { + // Owned artifact sites bake their theme at start; rebuild for the current theme. + const fresh = new URL( + await startStaticPreview(owned.artifactId, owned.entryPath, { + theme: body.theme, + parentOrigin: owned.canvasOrigin, + }), + ); + target = `${fresh.origin}${parsed.pathname}${parsed.search}${parsed.hash}`; + } + await openInDefaultBrowser(target); + return sendJson(res, 200, { opened: true, url: target }); + } catch (error) { + if (error instanceof ExternalOpenError) { + throw new HttpError(error.code === "launch_failed" ? 502 : 400, error.message, { code: error.code }); + } + throw error; + } + } + const previewMatch = path.match(/^\/api\/artifacts\/(\d+)\/preview-url$/); if (req.method === "GET" && previewMatch) { const entryPath = url.searchParams.get("path"); diff --git a/skills/pr-artifact-explorer/SKILL.md b/skills/pr-artifact-explorer/SKILL.md index 92bbc05eec..8c5b5f99d8 100644 --- a/skills/pr-artifact-explorer/SKILL.md +++ b/skills/pr-artifact-explorer/SKILL.md @@ -43,6 +43,9 @@ Use `share { input, preset?, zoom?, width?, height? }` to produce a link, route, - A contextual **Browser view** action appears in the preview toolbar only for static-site HTML artifacts; it is not a global nav item. Open URLs directly with `open_target` / `navigate_browser` or a `#/browser?v=...` route. - `.webm`, `.mp4` and `.mov` use native `