SeenRelay

Wiederverwendbarer Informationsgewinn für KI-Agenten.

Funktionierende Analogie: Waze schickt kein spezielles Auto, um jede Straße zu inspizieren. Fahrer sind bereits unterwegs, ihre Beobachtungen aktualisieren den gemeinsamen Verkehrszustand, und der nächste Fahrer vermeidet es, dieselben Bedingungen erneut zu entdecken. SeenRelay wendet dieses Muster auf quellengestützte Fakten an, die von KI-Agenten verwendet werden.

Bevor Sie einen Fakt erneut prüfen, fragen Sie, ob ein anderer Agent ihn kürzlich beobachtet hat. Wenn Sie die Quelle trotzdem unabhängig prüfen, hinterlassen Sie die Beobachtung für den nächsten Agenten.

Los geht's

• Leitfaden für die menschliche Integration: docs/QUICKSTART.md

• Verifizierte MCP-Client-Integrationen: docs/CLIENTS.md

• Pilotprojekt für Entscheidungsträger und Abbruchkriterien: docs/PILOT.md

• Web-Schnellstart: https://seenrelay.com/quickstart

• Web-Client-Integrationen: https://seenrelay.com/clients

• MCP-Remote-Endpunkt: https://seenrelay.com/mcp

• MCP-Registry-Kennung: io.github.ovladon/seenrelay

• REST/OpenAPI-Vertrag: https://seenrelay.com/openapi.json

• Maschinenlesbare Beschreibung: https://seenrelay.com/service.json

• Maschinenorientierter Index: https://seenrelay.com/llms.txt

Die empfohlene erste Bereitstellung ist der Schattenmodus: CHECK vor der bestehenden Revalidierung, aber zunächst nichts überspringen. Messen Sie, was SeenRelay gespart hätte, bevor Sie begrenzte Wiederverwendung zulassen.

Related MCP server: Memory MCP

Nur zwei Operationen

• CHECK — vergleicht einen Wert, den ein Agent bereits kennt, mit aktuellen Beobachtungen für denselben deterministischen, quellengestützten Fakt.

• OBSERVE — trägt einen Wert bei, den der Aufrufer bei seiner eigenen Arbeit unabhängig beobachtet hat.

Status: SAME_OBSERVED, CHANGED_OBSERVED, CONTESTED, STALE, UNKNOWN.

SeenRelay meldet Beobachtungen, keine universelle Wahrheit.

Fakt-Identität v3

SeenRelay verwendet den versionierten seenrelay-fact-v3-Identitätsvertrag und verwendet niemals einen LLM-/Fuzzy-Matcher, um zu entscheiden, dass zwei Fakten identisch sind.

Die Identitätspriorität ist:

1. stabiler quelleninterner Locator (json_pointer, element_id, source_key);

2. kanonisches maschinelles Prädikat, wenn kein Locator existiert.

Menschlich lesbarer subject-Text geht niemals in den Faktschlüssel ein. Veränderlicher beobachteter Inhalt geht niemals in den Faktschlüssel ein. Quell-URLs werden ohne Browsen kanonisiert: Fragmente werden entfernt, Host-/Standardports normalisiert, URLs mit Anmeldeinformationen oder Signaturen werden abgelehnt, bekannte Tracking-Parameter werden entfernt und verbleibende Abfrageparameter werden deterministisch sortiert.

Siehe docs/PROTOCOL.md für den genauen Vertrag.

Beobachter-Herkunft

OBSERVE unterstützt optionalen transportunabhängigen ed25519-v1-Besitznachweis.

Ein gültiger Nachweis etabliert Schlüsselbesitz, Kontinuität und Nutzlastintegrität. Er beweist nicht, dass ein Schlüssel einer unabhängigen Person/Organisation/Gerät/Agenten entspricht, und löst keine globale Sybil-Identität. SeenRelay trennt daher kryptografische und unverifizierte Beobachter-Schlüsselzahlen.

Hive Lease: kein Konto, verzögerte Belohnung

Jeder Aufrufer kann eine signierte, kurzlebige Hive Lease ohne Kontoerstellung, Anmeldung, E-Mail oder OAuth erhalten.

Während des Bootstrap:

• CHECK ist mit einem großzügigen Token-Bucket kostenlos;

• OBSERVE ist kostenlos;

• rohes OBSERVE bringt keine Punktzahl;

• der Beitragswert steigt nur, wenn ein späterer nützlicher CHECK durch diese Beobachtung unterstützt wird und der Verbraucher zu einem anderen konservativen, datenschutzgesalzenen Netzwerk-Unabhängigkeits-Bucket gehört;

• das Ändern nur eines selbst deklarierten Client-Labels erzeugt keine Belohnungsunabhängigkeit;

• wiederholte Belohnung für dasselbe Fakt/Wert/Beitragender/Verbraucher-Tupel wird unterdrückt;

• nützliche Beitragende erhalten mehr CHECK-Kapazität/Nachfüllung.

Hive-Klassen (new, established, contributor) beschreiben nur den operativen Beitrag, nicht die reale Identität oder Wahrheit.

Öffentliche Oberfläche

Die kanonische Domain ist seenrelay.com.

• Browser Accept: text/html bei / erhält eine Landingpage für Entscheidungsträger/Agenten mit Live-Aggregatmetriken.

• /quickstart gibt Entscheidungsträgern und Implementierern den kürzesten sicheren Einführungspfad.

• /clients bietet kopierfertige MCP-Client-Konfiguration.

• /robots.txt, /sitemap.xml und /llms.txt legen begrenzte öffentliche Entdeckungsmetadaten offen.

• Generische/API-Anfragen an / behalten die maschinenlesbare Dienstbeschreibung.

• /service.json legt die stabile Maschinenbeschreibung explizit offen.

• /public-stats.json legt datenschutzsichere aggregierte Netzwerkmetriken offen.

• /openapi.json legt den REST-Vertrag offen.

• /mcp legt MCP 2026-07-28 offen.

Die Website ist darauf ausgelegt, gemessenen Netzwerknutzen zu zeigen, nicht synthetische Wachstumsbehauptungen.

Es tut bewusst nicht

• das Web durchsuchen oder suchen;

• Fakten auf Anfrage verifizieren;

• einen LLM ausführen, um Wahrheit zu entscheiden;

• ein allgemeines Wissensdiagramm werden;

• als gemeinsames Agentengedächtnis fungieren;

• externe Forschungsdienste aufrufen;

• behaupten, dass eine Beobachtung zertifizierte Wahrheit ist.

Wenn SeenRelay UNKNOWN zurückgibt, fährt der Aufrufer genau so fort, wie er es ohne SeenRelay getan hätte. Wenn der Aufrufer dann die Quelle unabhängig beobachtet, kann er OBSERVE aufrufen.

Architektur

• Vercel + Fluid Compute — verwaltete Bereitstellung, TLS, Skalierung, Protokolle, Firewall-/Ausgabenkontrollen und Rollback.

• Neon Postgres — Fakten, aktuelle Beobachtungen, Hive-Lease-Zustand, nützliche Wiederverwendungsereignisse und aggregierte Telemetrie.

• Hono + TypeScript / Node 22 — kompakte Web-Standard-API.

• REST/OpenAPI — Kernprotokolloberfläche.

• MCP 2026-07-28 — zustandsloser Tool-Zugriff mit derselben CHECK/OBSERVE-Semantik.

• Control Room — authentifizierte menschliche Verwaltung, Live-Hive-Radar, Incident-Playbooks, Standardhaltung, operative Bereitschaft und Unterstützung bei der Übertragung der Verwahrung.

A2A 1.0.0 wird überwacht, aber bewusst nicht exponiert. SeenRelay ist derzeit ein Tool-/Infrastrukturdienst, kein aufgabenorientierter autonomer Agent; das Veröffentlichen einer Agent Card ohne echte A2A-Aufgabensemantik wäre irreführend.

Entdeckung und Verteilung

registry/server.json ist das kanonische MCP-Registry-Manifest für io.github.ovladon/seenrelay und verweist Remote-Clients auf https://seenrelay.com/mcp.

Das Repository enthält einen GitHub-OIDC-Publishing-Workflow für die offizielle MCP-Registry. Er pinnt die Publisher-Binärdatei und verifiziert deren SHA-256 vor der Ausführung; keine dauerhafte Registry-Anmeldeinformation wird im Repository gespeichert.

Verifikations-Gates

npm run check führt aus:

• Kern- und vollständige TypeScript-Typüberprüfung unter Node-ESM-Regeln;

• Produkt-Schutzmaßnahmen, einschließlich kein ausgehender Faktenrecherche-Fetch und Fail-Closed-Verhalten bei deaktivierter Abrechnung;

• Produktionsabhängigkeits-Audit auf hoher/kritischer Schwere;

• strukturelle Tests;

• Laufzeit-Identitäts-/Sicherheits-/Wirtschaftlichkeitstests.

GitHub Preview E2E übt zusätzlich:

• REST-CHECK/OBSERVE-Lebenszyklus;

• qualifizierte nützliche Wiederverwendungswirtschaft und konservatives Anti-Farming-Verhalten;

• Idempotenz-Isolation;

• CONTESTED- und STALE-Semantik;

• fact-v3-Locator-Konvergenz;

• Ablehnung von Quellen mit Anmeldeinformationen vor der Hive-Aufnahme;

• Admin-/Abrechnungsgrenzen;

• MCP server/discover, tools/list, check_fact und observe_fact auf Revision 2026-07-28;

• KPI-Semantik: mehrere Beitragsauszeichnungen aus einem CHECK zählen als ein qualifizierter Wiederverwendungs-CHECK.

Builds sind mit festgeschriebener package-lock.json und npm ci reproduzierbar.

Wartungs-Autopilot

SeenRelay ist darauf ausgelegt, Ökosystemänderungen zu bemerken, ohne unbeaufsichtigte Produktionsmutationen zu ermöglichen.

• Dependabot bereitet isolierte Abhängigkeits-/GitHub-Actions-Upgrade-PRs vor.

• Standards Watch läuft täglich gegen offizielle MCP-, A2A- und OpenTelemetry-Quellen.

• Standardabweichungen erstellen/aktualisieren ein GitHub-Issue.

• Protokollsemantische Änderungen erfordern einen isolierten Kompatibilitätskandidaten und die vollständigen Verifikations-Gates.

• main wird niemals ohne ausdrückliche Genehmigung automatisch zusammengeführt.

Siehe docs/MAINTENANCE_AUTOPILOT.md.

Abrechnungsstatus

Die Abrechnung ist in dieser Bereitstellung nicht verfügbar:

PAYMENTS_ENABLED=false
PAYMENT_PROVIDER=none

Jeder Versuch, die Abrechnung zu aktivieren, schlägt fehl, bevor die normale Anfrageverarbeitung beginnt.

Projektkontext

Bevor Sie den Produktumfang ändern, lesen Sie:

1. docs/PROJECT_CONTEXT.md

2. docs/DECISIONS.md

3. docs/WHY_NOT.md

4. docs/PROTOCOL.md

5. docs/MAINTENANCE_AUTOPILOT.md

6. docs/HANDOFF.md

Bootstrap

Sobald die verwaltete Datenbank verknüpft ist:

npm ci
npm run check
npm run db:migrate

Bereitstellungsdetails finden Sie in docs/DEPLOYMENT.md.