feat: add event receipt retrieval skill

README.md

@@ -25,6 +25,7 @@ This plugin includes the following skills (see `skills/` for details):
 | [company-research](skills/company-research/SKILL.md) | Discover target companies matching your ICP using the Browserbase Search API, deep-research each one, and score fit into a research report and CSV |
 | [event-prospecting](skills/event-prospecting/SKILL.md) | Extract speakers from a conference page, filter their companies against your ICP, and deep-research the best-fit people into a person-first prospecting report |
 | [competitor-analysis](skills/competitor-analysis/SKILL.md) | Auto-discover a company's competitors via the Browserbase Search API, deep-research each across marketing, signal, benchmark, and strategic-diff lanes, and compile a browsable HTML report with an overview, per-competitor deep dives, a feature/pricing matrix, and a mentions feed |
+| [fetch-event-receipts](skills/fetch-event-receipts/SKILL.md) | Retrieve a final DoorDash receipt through a persistent Browserbase Context, match it exactly to a Ramp transaction, and attach it through a standalone Ramp Agent Identity |
 
 ## Installation
 

skills/fetch-event-receipts/LICENSE.txt

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

skills/fetch-event-receipts/SKILL.md

@@ -0,0 +1,62 @@
+---
+name: fetch-event-receipts
+description: "Fetch a DoorDash event receipt in an authenticated Browserbase session and optionally attach it to its Ramp card transaction. Use for the Ramp Agent Identity + Browserbase receipt demo, DoorDash receipt retrieval, or a missing DoorDash receipt. Do not use for ordering food, reimbursements, other merchants, or invoices."
+license: MIT
+compatibility: "Requires browse CLI 0.9.5+, Ramp CLI 0.2.24+, Bash, Node.js 20+, jq, Poppler, Tesseract, and authenticated Browserbase and Ramp accounts."
+allowed-tools: Bash Read
+---
+
+# Fetch event receipts
+
+Use the bundled deterministic runner. Do not reconstruct the workflow as
+individual commands, invent state files, inspect CLI schemas, or add receipt
+content validators. The runner owns one Browserbase session, the DoorDash PDF
+print, the optional Ramp upload, and cleanup in one foreground process.
+
+## Interpret the request
+
+- Normalize a yearless month/day such as `8/18` to the current calendar year.
+- Normalize `~$50`, `about $50`, or `$50-ish` to a 5000-cent hint with a
+  500-cent tolerance.
+- Retrieval is the default. Add `--attach` only when the user explicitly asks
+  to attach or upload the receipt to Ramp.
+- The private demo registry resolves the approximate request to one configured
+  Ramp transaction and DoorDash order. The runner stops if it is not unique.
+
+## Run
+
+Resolve the absolute directory containing this `SKILL.md` as `skill_root`, then
+run exactly one foreground command:
+
+```bash
+"$skill_root/scripts/run-demo.sh" \
+  --date YYYY-MM-DD \
+  --amount-hint-minor INTEGER_CENTS \
+  --amount-tolerance-minor INTEGER_CENTS \
+  [--attach]
+```
+
+For `8/18, the ~$50 order` in 2026, use:
+
+```text
+--date 2026-08-18 --amount-hint-minor 5000 --amount-tolerance-minor 500
+```
+
+Run it once. Do not background it, split it into commands, retry it, or perform
+extra preflight, schema, or help calls. Relay only its five short milestone
+updates as they appear. The runner deliberately does not inspect PDF text;
+successful DoorDash printing plus Ramp's upload response is the demo contract.
+
+If the runner says Ramp already has a receipt, ask the operator to remove it
+before recording. Do not bypass that duplicate guard. If another stage stops,
+report the single sanitized error and do not improvise a workaround.
+
+## Return
+
+After a successful run, the runner opens the matched Ramp transaction in the
+operator's default browser. It does not open Ramp after a stopped or failed run.
+
+Return the final status plus the clickable `ramp_transaction_url` and
+`browserbase_session_url`. For retrieval-only, also return `receipt_pdf`. Never
+return the Browserbase CDP URL, cookies, credentials, receipt base64, private
+registry contents, or raw CLI responses.

skills/fetch-event-receipts/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Fetch Event Receipts"
+  short_description: "Match DoorDash receipts to Ramp transactions"
+  default_prompt: "Use $fetch-event-receipts to run the deterministic DoorDash-to-Ramp receipt workflow. Relay its five milestone updates, and attach only when I explicitly ask."

skills/fetch-event-receipts/assets/live-view.html

@@ -0,0 +1,244 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <meta name="color-scheme" content="light" />
+    <title>Browserbase receipt agent</title>
+    <style>
+      :root {
+        color-scheme: light;
+        --red: #ff4500;
+        --black: #000000;
+        --white: #ffffff;
+        --grey-100: #f8fafc;
+        --grey-200: #f0f4f8;
+        --grey-300: #e1e9f2;
+        --grey-500: #c5d3e8;
+        --grey-800: #5a78af;
+        --grey-900: #46639f;
+      }
+
+      * {
+        box-sizing: border-box;
+      }
+
+      body {
+        min-width: 320px;
+        min-height: 100vh;
+        margin: 0;
+        background: var(--grey-100);
+        color: var(--black);
+        font-family: "Plain", "IBM Plex Sans", sans-serif;
+      }
+
+      .topbar {
+        min-height: 92px;
+        padding: 20px clamp(24px, 4vw, 64px);
+        border-bottom: 1px solid var(--grey-500);
+        background: var(--white);
+        display: flex;
+        align-items: center;
+        justify-content: space-between;
+        gap: 32px;
+      }
+
+      .eyebrow,
+      .status,
+      .footer-label {
+        font-family: "GT Standard Mono", "IBM Plex Mono", monospace;
+        letter-spacing: -0.01em;
+      }
+
+      .eyebrow {
+        margin: 0 0 6px;
+        color: var(--grey-800);
+        font-size: 11px;
+        line-height: 15px;
+        text-transform: uppercase;
+      }
+
+      h1 {
+        margin: 0;
+        font-family: "GT Planar Medium", "Work Sans", sans-serif;
+        font-size: clamp(28px, 3.2vw, 46px);
+        font-weight: 600;
+        letter-spacing: -0.025em;
+        line-height: 1;
+      }
+
+      .status {
+        max-width: 520px;
+        display: flex;
+        align-items: center;
+        gap: 10px;
+        color: var(--grey-800);
+        font-size: 11px;
+        line-height: 16px;
+        text-align: right;
+      }
+
+      .status::before {
+        width: 9px;
+        height: 9px;
+        flex: 0 0 auto;
+        background: var(--red);
+        content: "";
+      }
+
+      .status.stopped {
+        color: var(--grey-900);
+      }
+
+      .status.stopped::before {
+        background: var(--grey-900);
+      }
+
+      .page {
+        width: min(1540px, 100%);
+        margin: 0 auto;
+        padding: clamp(20px, 3vw, 48px);
+      }
+
+      .viewer-card {
+        overflow: hidden;
+        border: 1px solid var(--grey-500);
+        background: var(--white);
+      }
+
+      .viewer-label {
+        display: flex;
+        align-items: center;
+        justify-content: space-between;
+        gap: 20px;
+        height: 36px;
+        padding: 0 12px;
+        border-bottom: 1px solid var(--grey-500);
+        background: var(--white);
+        color: var(--grey-800);
+        font-family: "GT Standard Mono", "IBM Plex Mono", monospace;
+        font-size: 10px;
+        letter-spacing: -0.01em;
+        line-height: 14px;
+        text-transform: uppercase;
+      }
+
+      .browser-shell {
+        position: relative;
+        width: 100%;
+        aspect-ratio: 16 / 9;
+        overflow: hidden;
+        background: var(--grey-200);
+      }
+
+      .live-viewport {
+        position: absolute;
+        z-index: 1;
+        inset: 0;
+        overflow: hidden;
+        background: var(--grey-200);
+      }
+
+      .live-browser {
+        position: absolute;
+        top: -32px;
+        left: 0;
+        display: block;
+        width: 100%;
+        height: calc(100% + 32px);
+        border: 0;
+        background: var(--grey-200);
+        pointer-events: none;
+      }
+
+      .browser-placeholder {
+        position: absolute;
+        z-index: 2;
+        inset: 0;
+        display: grid;
+        place-items: center;
+        padding: 32px;
+        background: var(--grey-200);
+        color: var(--grey-800);
+        font-family: "GT Standard Mono", "IBM Plex Mono", monospace;
+        font-size: 11px;
+        letter-spacing: -0.01em;
+        text-align: center;
+      }
+
+      .browser-placeholder[hidden] {
+        display: none;
+      }
+
+      .footer {
+        display: flex;
+        justify-content: space-between;
+        gap: 24px;
+        margin-top: clamp(28px, 4vw, 52px);
+        padding-top: 14px;
+        border-top: 1px solid var(--grey-500);
+      }
+
+      .footer-label {
+        color: var(--grey-800);
+        font-size: 9px;
+        line-height: 14px;
+        text-transform: uppercase;
+      }
+
+      @media (max-width: 820px) {
+        .topbar {
+          align-items: flex-start;
+          flex-direction: column;
+          gap: 16px;
+        }
+
+        .status {
+          text-align: left;
+        }
+
+      }
+    </style>
+    <script src="/live-view.js" defer></script>
+  </head>
+  <body>
+    <header class="topbar">
+      <div>
+        <p class="eyebrow">Ramp agent identity · Browserbase</p>
+        <h1>Receipt fetching agent</h1>
+      </div>
+      <div class="status" id="overallStatus" role="status" aria-live="polite">
+        Waiting for the Browserbase session.
+      </div>
+    </header>
+
+    <main class="page">
+      <section aria-label="Live receipt workflow">
+        <div class="viewer-card">
+          <div class="viewer-label">
+            <span>Live browser</span>
+            <span>DoorDash → Ramp</span>
+          </div>
+          <div class="browser-shell">
+            <div class="browser-placeholder" id="browserPlaceholder">Starting live browser.</div>
+            <div class="live-viewport">
+              <iframe
+                class="live-browser"
+                id="liveBrowser"
+                title="Live Browserbase receipt session"
+                sandbox="allow-same-origin allow-scripts allow-forms"
+                referrerpolicy="no-referrer"
+                tabindex="-1"
+              ></iframe>
+            </div>
+          </div>
+        </div>
+      </section>
+
+      <footer class="footer">
+        <span class="footer-label">Browserbase</span>
+        <span class="footer-label">Recorded demo view</span>
+      </footer>
+    </main>
+  </body>
+</html>

skills/fetch-event-receipts/assets/live-view.js

@@ -0,0 +1,40 @@
+"use strict";
+
+const overallStatus = document.querySelector("#overallStatus");
+const browserPlaceholder = document.querySelector("#browserPlaceholder");
+const liveBrowser = document.querySelector("#liveBrowser");
+let visibleRevision = 0;
+
+function setLiveStatus(status, ready, revision) {
+  const messages = {
+    waiting: "Waiting for the Browserbase session.",
+    connecting: "Connecting to Browserbase.",
+    ready: "Browserbase session live.",
+    unavailable: "Live session unavailable.",
+  };
+  overallStatus.textContent = messages[status] || messages.waiting;
+  browserPlaceholder.textContent = messages[status] || messages.waiting;
+  browserPlaceholder.hidden = ready;
+
+  if (ready && Number.isInteger(revision) && revision > 0 && revision !== visibleRevision) {
+    visibleRevision = revision;
+    liveBrowser.src = `/live?revision=${revision}`;
+  } else if (!ready && visibleRevision !== 0) {
+    visibleRevision = 0;
+    liveBrowser.src = "about:blank";
+  }
+}
+
+async function refresh() {
+  try {
+    const response = await fetch("/state", { cache: "no-store", credentials: "same-origin" });
+    if (!response.ok) throw new Error("state unavailable");
+    const state = await response.json();
+    setLiveStatus(state.live_status, state.live_ready === true, state.live_revision);
+  } catch {
+    overallStatus.textContent = "Local viewer unavailable.";
+  }
+}
+
+void refresh();
+setInterval(() => void refresh(), 1000);