Inspiration

Buying museum-grade fine art online suffers from a 72% cart abandonment rate. Collectors hesitate because of three compounding uncertainties:

  1. Scale & Lighting Anxiety: "Will a 24×36\" acrylic print overwhelm my walnut credenza or clash with my wall paint?"
  2. Opaque Custom Framing Math: Archival substrates, local custom studio framing addons, and studio pickup rebates rarely reconcile transparently at checkout.
  3. The Agentic Commerce Gap: AI assistants can suggest artwork in chat, yet hit a wall when trying to stage a physical room to scale, honor a hard collector budget, and prepare a verified PayPal checkout without taking unauthorized payment actions.

We built Phil Gear Photography's Agentic Atelier to turn fine art discovery, architectural staging, and itemized PayPal Orders v2 settlement into a seamless human-and-agent collaborative experience.

What It Does

  • 3-Tier AI Interior Art Concierge: Collectors describe their room, mood, lighting, and budget in plain English (e.g., "Dramatic misty Pacific Northwest forest for a dark walnut executive office under $750"). Our multi-tier engine cascades across Google Gemini (gemini-3.8-flash), Chrome Built-in AI (window.ai.languageModel / Gemma 4), and a deterministic 256-dimensional n-gram semantic vector & budget solver—guaranteeing 100% zero-key, zero-latency curation for every visitor and judge.
  • 1:10 Architectural Room, Paint & Framing Visualizer: Automatically mounts any of 36 curated Pacific Northwest masterworks to exact 1:10 scale across 5 architectural scenes (Mid-Century Living Room, Basalt Hearth, Executive Sit-Stand Office, Pearl District Gallery, Nocturnal Pavilion), calibrated against real Rodda, Miller, and Sherwin-Williams paint swatches.
  • W3C WebMCP (document.modelContext) Agentic Commerce: Registers 4 client-side tools (search_fine_art_prints, stage_artwork_in_room, curate_room_with_ai, and initiate_paypal_checkout) so in-browser AI agents can search the catalog, stage rooms within budget, and hand off an itemized PayPal checkout—plus an on-page Judge Agentic Inspector to invoke every tool in 1 click.
  • Itemized PayPal Orders v2 SDK + Kinpaku™ Eco-Ink Certificate: Integrates @paypal/paypal-js Smart Payment Buttons (createOrder + onApprove) right above the fold after a calm 3-size choice (16×24", 24×36", 40×60"), keeping advanced framing and studio rebates tucked cleanly inside progressive disclosure so collectors never abandon their cart. Upon capture, Web Crypto (SHA-256) mints a print-ready Certificate of Authenticity set in PocketGull Kinpaku™ (金箔) 24k Gold COLR/CPAL on screen and PocketGull Kintsugi™ (−45.8% Eco-Ink) when printed.

How We Built It

  • PayPal Developer Platform: @paypal/paypal-js v8 Smart Payment Buttons (PayPal + Venmo funding) with itemized purchase_units in Sandbox (client-id=sb) + Live Merchant SDK toggle, paired with a 1-click Judge Sandbox Capture simulator for friction-free evaluation.
  • AI & Agentic Layer: Multi-tier TypeScript AI Concierge (gemini-3.8-flash structured JSON schema + Chrome Built-in AI + 256-dim L2-normalized vector cosine ranker & combinatorial budget solver) and W3C WebMCP (document.modelContext.registerTool) with schema.json, evals.json, and llms.txt.
  • Frontend & Verification: Astro 5, Tailwind CSS v4, Web Crypto SHA-256 provenance hashing, and automated Vitest + JSDOM unit/integration specs verifying PayPal Orders v2 breakdown invariants and WebMCP tool contracts.

Challenges We Ran Into

  • Exact PayPal Orders v2 Itemized Math: Combining substrate multipliers (1.0x Giclée, 1.25x Brushed Aluminum, 1.4x TruLife Acrylic) with framing studio addons (+$45 to +$260) and local Will-Call credits (-$35 to -$50) required strict penny-exact reconciliation between purchase_units[0].items, breakdown.item_total, breakdown.discount, and amount.value so PayPal's Orders v2 validator never rejects a mixed cart.
  • Human-in-the-Loop Agentic Checkout Safety: Designing initiate_paypal_checkout so autonomous browser agents can configure and verify the entire itemized ledger while strictly preserving explicit collector authorization on the PayPal Smart Payment Button.

What's Next

Expanding multi-wall diptych/triptych Orders v2 split settlements between fine art photographers and local independent framing studios via PayPal Multiparty / Commerce Platform APIs.

Built With

Share this project:

Updates