wasp-mcp: Instructions file for Claude Code

AgentManifest — WASP (Web Agent Semantic Protocol)

Firefox browser extension that makes any webpage instantly queryable by an AI agent. Instead of scraping the full DOM or sending raw HTML to an LLM, WASP generates a lightweight structural index (the manifest) and fetches live content for only the sections relevant to a query. The result is fast, token-efficient, structure-aware retrieval over arbitrary webpages.

Hackathon: LAHACKS 2026 / Cognition AI Challenge — "Smarter context retrieval" track.

---

Project Vision

The core insight is that webpages have two layers of useful information:

1. Structure — headings, sections, and anchors that form a table of contents. This is cheap to index and small enough to pass to an LLM as context.
2. Content — the actual text under each heading. This is expensive to send in full, and most of it is irrelevant to any given query.

WASP exploits this by making the structure the primary artifact (the manifest) and treating content as a lazy resource fetched only when needed. An agent can read the manifest, decide which sections are relevant, and request only those. This is an index, not a copy.

A secondary goal is a standard protocol: if a site publishes its own /.well-known/wasp.json, agents can skip DOM parsing entirely and trust the site's own semantic description of itself. Client-generated fallback handles every other site.

---

Loading the Extension

about:debugging → This Firefox → Load Temporary Add-on → select manifest.json

After loading, click the W toolbar icon to open the sidebar. The extension auto-injects into already-open tabs via browser.scripting.executeScript — no manual page reload needed. Content scripts declared in manifest.json auto-inject into new tabs.

---

File Map

manifest.json            Firefox MV3 declaration
content.js               DOM interface — runs in every page context
background.js            Service worker — coordinator, LLM proxy, state store
providers.js             ES module — claude / openai / ollama / devin adapters
sidebar/
  sidebar.html           Extension sidebar UI (dark theme, inline CSS)
  sidebar.js             Sidebar logic — port messaging, streaming render, citations
styles/
  highlight.css          .agent-manifest-highlight — injected into every page
icons/
  icon-48.png
  icon-96.png