Skip to content

Apex demo: inline access-link preview as the payoff#575

Merged
isuttell merged 1 commit into
mainfrom
worktree-toasty-twirling-cerf
Jun 18, 2026
Merged

Apex demo: inline access-link preview as the payoff#575
isuttell merged 1 commit into
mainfrom
worktree-toasty-twirling-cerf

Conversation

@isuttell

@isuttell isuttell commented Jun 18, 2026

Copy link
Copy Markdown
Contributor

Summary

The apex home demo's payoff was a result line linking out to a hand-authored static page (/a/art_8KQ2WSDIEGO7XR, "Project handoff") that had drifted from both the live home-page content and the real /al access-link viewer chrome — a dead-end the visitor wasn't meant to dwell on. This inlines the payoff so it can't drift again and keeps the visitor in the funnel: the demo now ends in a mini access-link viewer that looks like a real opened browser page.

Changes

  • Replace the transcript link-out with an inline preview (mini access-link viewer): centered, theme-inverted vs the page, fixed-width, browser-framed (fake address bar + traffic-light dots + wordmark brand bar); report rows fade out at the bottom to imply a longer page.
  • Add a link transcript line that hands back the URL right before the preview opens; tune the shell max-h so the whole "Done → here's your link → preview" handoff lands as the final frame with no internal scroll.
  • Report rows (EXAMPLE_REPORT_ROWS) read as the user's own agent surfacing personalized, one-shot share use cases (incident writeup, research, migration plan, roadmap); retune EXAMPLE_PROMPT to lead with the memory angle.
  • Both copy-prompt affordances (inline prompt + footer "Copy prompt") now copy identical text including the --claim-code line, and both fire the funnel attribution.
  • Delete the static /a/art_8KQ2WSDIEGO7XR page (no longer linked; it 404s now).
  • Update render tests to the new contract (inline preview present, no /a/ link-out, access-link URL still surfaced); drop the dead gesture test.

Risk: LOW

  • Areas touched: apps/apex only (prerendered marketing site) — copy.ts, TranscriptDemo.tsx, apex.css, render.test.tsx, plus deletion of the static example page.
  • Security: none — no auth, data, secrets, or schema surface.
  • Performance: neutral; removes a static page, adds inline DOM.
  • Breaking: none — no public contract; /a/<id> was demo-only and never in redirects/asset whitelists.

Test plan

  • pnpm --filter @agent-paste/apex test (88 passed), typecheck, lint clean
  • pnpm verify (261 tests + smoke) and pnpm test:coverage green
  • Verified on preview (pnpm deploy:preview --app=apex): animated run ends on the inline preview; reduced-motion / no-JS static fallback shows it; old /a/art_8KQ2WSDIEGO7XR returns 404; both copy affordances copy the same prompt + claim-code text

Issue: AP-389

🤖 Generated with Claude Code

Summary by CodeRabbit

Release Notes

  • New Features

    • Demo transcript now displays inline previews of artifacts with titles and content directly within the conversation flow, eliminating the need for separate pages.
  • Style

    • Updated styling for inline preview panels with theme-aware rendering and refined spacing.
  • Chores

    • Removed legacy static artifact pages and associated resources.

Replace the home demo's link-out to a static example page with an inline
"mini access-link viewer" that reveals as the final beat of the transcript:
a centered, theme-inverted, fixed-width browser-framed panel (fake address
bar, traffic-light dots, wordmark brand bar) previewing the published
artifact, with the report rows fading out to imply a longer page.

- Delete the static /a/art_8KQ2WSDIEGO7XR page (no longer linked; it had
  drifted from the real /al viewer chrome).
- Add a "link" transcript line that hands back the URL right before the
  preview opens, and tune the shell height so the whole "Done -> here's
  your link -> preview" handoff lands as the final frame with no scroll.
- Report rows read as the user's own agent surfacing personalized,
  one-shot share use cases (incident writeup, research, migration plan,
  roadmap), sourced from EXAMPLE_REPORT_ROWS; retune EXAMPLE_PROMPT to
  lead with the memory angle.
- Update render tests to the new contract (inline preview present, no
  /a/ link-out, access-link URL still surfaced); drop the dead gesture test.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@coderabbitai

coderabbitai Bot commented Jun 18, 2026

Copy link
Copy Markdown

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: 5e5ef281-d170-4b0b-9199-d31d91923733

📥 Commits

Reviewing files that changed from the base of the PR and between 3d16aba and 9e1fd99.

📒 Files selected for processing (6)
  • apps/apex/public/a/art_8KQ2WSDIEGO7XR/index.html
  • apps/apex/public/a/art_8KQ2WSDIEGO7XR/style.css
  • apps/apex/src/components/TranscriptDemo.tsx
  • apps/apex/src/copy.ts
  • apps/apex/src/render.test.tsx
  • apps/apex/src/styles/apex.css
💤 Files with no reviewable changes (2)
  • apps/apex/public/a/art_8KQ2WSDIEGO7XR/index.html
  • apps/apex/public/a/art_8KQ2WSDIEGO7XR/style.css

📝 Walkthrough

Walkthrough

Removes the static artifact HTML/CSS page and the result transcript line kind, replacing the flow with two new TranscriptLine variants: link (non-clickable URL line) and preview (inline miniature viewer panel). Updates the component renderer, demo copy constants, CSS rules, and test assertions to match.

Changes

Inline Preview Transcript Flow

Layer / File(s) Summary
TranscriptLine type and demo copy constants
apps/apex/src/copy.ts
Removes the result union variant; adds link and preview variants plus PREVIEW_URL, EXAMPLE_ARTIFACT_TITLE, and EXAMPLE_REPORT_ROWS constants; removes EXAMPLE_STATIC_PAGE_PATH; updates EXAMPLE_PROMPT; revises the TRANSCRIPT array's ending to use link + preview; deduplicates UseCase/USE_CASES.
TranscriptDemo link and preview rendering
apps/apex/src/components/TranscriptDemo.tsx
Replaces the "result" render case with "link" (URL-styled line) and "preview" (chrome bar, truncated rows, brandbar); adds PREVIEW_ROWS cap; updates lineKey; adds data-claim-prompt-variant to the copy button; reduces transcript container max-h.
Remove gesture CSS, add preview panel styles
apps/apex/src/styles/apex.css
Removes .t-gesture, .t-gesture-node, and .t-result display overrides; adds .t-step.t-preview layout, .t-preview-fade gradient mask, --color-* token overrides for dark/light preview frame inversion, and .t-preview-bar/.t-preview-dot/.t-preview-url chrome styles.
Delete static artifact files and update tests
apps/apex/public/a/art_8KQ2WSDIEGO7XR/index.html, apps/apex/public/a/art_8KQ2WSDIEGO7XR/style.css, apps/apex/src/render.test.tsx
Deletes the 108-line static HTML page and 305-line stylesheet; replaces the old static-page link test with assertions for data-kind="preview" and the /al/ Access Link URL; removes the result-gesture wire test.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Possibly related PRs

  • zaks-io/agent-paste#458: Directly overlaps — this PR builds on the earlier result line kind wiring in TranscriptDemo.tsx and copy.ts, now replacing it with the link/preview inline flow.
  • zaks-io/agent-paste#572: Modifies the same apex hero transcript demo internals (TranscriptDemo.tsx, copy.ts, and related styling) around the transcript line-kind rendering.
  • zaks-io/agent-paste#63: Directly conflicts — extends TranscriptLine with a "success" kind and updates TRANSCRIPT in copy.ts, touching the same type union and array this PR rewrites.

Poem

🐇 Hop hop, no static page to load,
The preview now lives inline on the road!
The gesture wires are clipped and gone,
A miniature viewer carries on.
With dots and bars and rows so neat,
The demo transcript is now complete! ✨

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Docstring Coverage ⚠️ Warning Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%. Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (4 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The pull request title 'Apex demo: inline access-link preview as the payoff' accurately and specifically summarizes the main change: replacing a static example page endpoint with an embedded inline preview of the access link as the final demo frame.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch worktree-toasty-twirling-cerf

Warning

There were issues while running some tools. Please review the errors and either fix the tool's configuration or disable the tool if it's a critical failure.

🔧 Biome (2.5.0)
apps/apex/src/styles/apex.css

File contains syntax errors that prevent linting: Line 23: Tailwind-specific syntax is disabled.; Line 25: Tailwind-specific syntax is disabled.; Line 26: Tailwind-specific syntax is disabled.; Line 27: Tailwind-specific syntax is disabled.; Line 28: Tailwind-specific syntax is disabled.


Comment @coderabbitai help to get the list of available commands and usage tips.

@cursor cursor Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

First-pass review (AP-389)

Risk: simple
Decision: approve

Ticket triage

  • Intended change: Replace the apex home demo's link-out to a static /a/art_… page with an inline mini access-link viewer as the final transcript beat; delete the static page; align copy-prompt copy behavior.
  • Scope match: Yes — diff is confined to apps/apex and matches AP-389 acceptance criteria (inline preview, no /a/ link-out, updated tests, claim-code copy parity on both affordances).

Review findings

Blocking: none

Non-blocking:

  • docs/ops/apex-landing-todo.md still describes the deleted static page under apps/apex/public/a/art_8KQ2WSDIEGO7XR/ — worth a quick doc touch in a follow-up so the next agent isn't misled.
  • Footer button comment in TranscriptDemo.tsx still says it copies the "bare EXAMPLE_PROMPT"; behavior now appends claim code via data-claim-prompt-variant (same as inline prompt). Comment-only drift.

Merge checklist

  • Ticket linked and understood: AP-389
  • PR scope matches ticket: yes
  • Checks green: Validate, Postgres smoke, secret scan, CodeQL all pass
  • Tests/docs appropriate: render tests updated for new preview contract; author verified preview deploy
  • No blocking findings: yes
  • No high-risk areas: marketing-only surface, no auth/billing/infra
  • Merge-safe: yes

Why approve

The implementation is coherent: new link + preview transcript kinds, theme-inverted preview chrome with sensible CSS token overrides, static example deletion to prevent drift, and the inline prompt now shares claim-code copy behavior with the footer button. CI is green and the change stays within a low-risk marketing boundary suitable for first-pass automation approval.

Open in Web View Automation 

Sent by Cursor Automation: First Pass PR Reviewer

@isuttell isuttell merged commit 0b43cb1 into main Jun 18, 2026
11 checks passed
@isuttell isuttell deleted the worktree-toasty-twirling-cerf branch June 18, 2026 23:14
@github-actions

Copy link
Copy Markdown

agent-paste PR preview resources were cleaned up. The shared Preview GitHub Environment is retained for future preview deploys.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant