ovladon/seenrelay
Find repeated expensive read-only checks, duplicate tool calls, and cold concurrent misses in AI agent workloads before native-first, policy-gated reuse.
Changelog
Current install/version/verified benchmark facts are generated from public/product-facts.json. See docs/VERIFIED_RESULTS.md and https://seenrelay.com/product-facts.json.
Unreleased — Deterministic client wrappers
-
Add Python distributed fleet shadow-overlap measurement parity for reviewed read-only calls. The Python meter remains shadow-only: every authoritative call executes, no result is shared, coordinate/store failures fail open, and caller-supplied observed cost is not relabeled as avoided savings.
-
Add a generic
wrapFleetShadowCall()helper and make fleet coordinate canonicalization fail-open: non-JSON/cyclic coordinates never suppress the authoritative call and are counted as unclassified measurement rather than forced into a hash. -
Add a distributed JavaScript/TypeScript fleet shadow-overlap meter that uses caller-owned coordination metadata to classify exact eligible in-flight collisions across workers while every authoritative operation still runs. It reports observed overlap and caller-supplied cost provenance without labeling shadow cost as avoided savings, uploading results, or invoking hosted CHECK/OBSERVE.
-
Make the local static prescreen conservatively classify Firecrawl workloads as
NATIVE_CONTROL_FIRSTuntil providermaxAge/storeInCachebehavior is measured, even when those defaults are not explicit in application code. -
Add a local-only
seenrelay scanstatic prescreen for metered/read-only validation candidates, recurring execution signals, and stronger native/local controls. The scanner uploads nothing, modifies nothing, and cannot returnUSEor enable reuse. -
Add a Claude Code plugin manifest that reuses the existing measurement-first SeenRelay Agent Skill without automatically attaching the hosted MCP endpoint.
-
Retire the recurring Reference Observer schedule now that the private Delta bridge is the sole scheduled first-party bootstrap observer; retain Reference Observer as a manual fallback only.
-
Add vendorable zero-third-party-runtime-dependency JavaScript/TypeScript and Python reference wrappers that put CHECK deterministically in front of an application's existing validation path.
-
Keep shadow mode as the default; bounded reuse requires an explicit caller-supplied policy.
-
Fail open on relay-side timeout, 429, malformed response, or outage without hiding failures from the application's own validation.
-
Forward only safe observer-supplied ETag / Last-Modified conditional hints and retain no completed CHECK result cache.
-
Coalesce only overlapping request-equivalent CHECKs in process and expose local-only measurement counters plus caller-supplied reuse economics.
-
Preserve the public protocol boundary: no database migration, no third domain operation, and no change to MCP CHECK / OBSERVE semantics.
0.3.10 / client 0.2.8 — Multi-signal evidence and coordinate helpers
- Add an aggregate reuse-independence bucket count to fresh CHECK evidence without returning the underlying privacy-salted bucket identifiers; the count remains an anti-farming signal, not identity or truth evidence.
- Add JavaScript/TypeScript and Python assurance helpers that assess shared CHECK evidence and provide an explicit opt-in multi-signal retained-reuse policy with minimum 2/2/2 observer, cryptographic-key and reuse-independence-bucket thresholds.
- Add JavaScript/TypeScript and Python Fact Coordinate Kit helpers for deterministic local MCP/OpenAPI coordinates and shared fact descriptors only when a stable source-native locator is available.
- Add a sanitized three-workload natural-workload evaluator that requires the best measured non-shared baseline and never enables automatic reuse.
- Add a repository licensing map while leaving the hosted source license and MIT client licenses unchanged.
- Keep CHECK and OBSERVE as the only hosted domain operations and keep caller policy authoritative for reuse.
0.3.8 — Early value and validator-assisted CHECK
- Return the newest observer-supplied source validator with fresh CHECK evidence without claiming that SeenRelay verified it.
- Provide safe conditional-request hints for
etagandlast_modifiedvalidators, while rejecting CR/LF-bearing validator values. - Make the cold-start loop machine-readable:
UNKNOWN/STALEdirects the caller to validate normally and OBSERVE, and accepted observations are explicitly eligible for later CHECKs. - Release-gate same-integration reuse so a caller can benefit from its own earlier OBSERVE without receiving qualified cross-client reuse credit.
- Keep CHECK and OBSERVE as the only domain operations and preserve the external-verification=false boundary.
0.3.7 — Discovery funnel telemetry
- Add privacy-minimized aggregate MCP
initializeandtools/listrequest counters. - Surface protocol interest separately from external CHECK, OBSERVE, and qualified reuse in the Control Room.
- Keep discovery telemetry explicitly non-adoption and fail-open so telemetry cannot break MCP service.
- Document that discovery counters persist no request payload, clientInfo, IP, user-agent, or MCP session identifier.
0.3.6 - 2026-08-25
- Made the Control Room operational snapshot independent from optional external-adoption classification so an adoption query failure cannot blank the admin surface.
- Added an explicit external / first-party / total split, adoption milestones, Reference Observer health context, and an external-only Hive Radar with a truthful empty state.
- Preserved first-party bootstrap data while keeping it excluded from external adoption metrics.
- Bound the Preview Release Gate to the current pull request's Vercel Preview URL instead of a stale hard-coded branch alias, while retaining exact deployment-SHA verification.
- Synchronized the service, static MCP server card, and Official MCP Registry metadata at 0.3.6.
0.3.5 - 2026-08-25
- Changed Control Room adoption telemetry to external-only views by excluding the first-party Reference Observer from active Hive radar leases, retained OBSERVE/fact counts, and contributor rankings.
- Count qualified reuse as external adoption only when the consuming lease is external; a first-party seed may still support genuine third-party reuse.
- Kept CHECK telemetry external by invariant because the Reference Observer performs OBSERVE only and never calls CHECK.
- Added structural regression coverage for the external-adoption boundary.
0.3.4 - 2026-08-25
- Added the bounded first-party Reference Observer and scheduled allowlisted public-source workflow.
- Kept the Reference Observer outside the SeenRelay server runtime and on the same public OBSERVE path as ordinary clients.
- Added explicit documentation that first-party observer activity is bootstrap data and must not be treated as third-party adoption.
- Added a static MCP server card for directory discovery and synchronized tool metadata for
check_factandobserve_fact.
0.3.3 - 2026-08-25
- Reworked public documentation around a cooperative freshness-cache model and removed brand-specific analogy language.
- Added explicit cold-start behavior: UNKNOWN passthrough, first-observation seeding, same-fleet reuse, and additive external coverage.
- Simplified public access wording to state that the service is currently free without exposing payment configuration details in product documentation.
- Reduced the public documentation set to implementation, integration, operations, security, and protocol material.
- Clarified Control Room runtime labels and added confirmation before restrictive custom runtime-control changes.
- Updated public-surface and release-gate assertions for the revised machine descriptor and landing page.
0.3.0 - 2026-08-24
- Replaced the hand-built MCP transport with the official
@modelcontextprotocol/serverv2 SDK andcreateMcpHandler. - Targeted MCP protocol revision
2026-07-28. - Removed A2A discovery from v1 because no real A2A task endpoint exists.
- Salt-hashed client and observer identifiers and made Vercel environments fail closed without a high-entropy
PRIVACY_SALT. - Scoped idempotency keys to the privacy-preserving observer key to avoid cross-agent collisions.
- Hardened fact identity to
seenrelay-fact-v3: mutable observed content is excluded from identity; stable source-native locators are preferred, otherwise a shared predicate plus minimal qualifiers is used. - Added deterministic URL hygiene: fragments and known tracking parameters are removed, remaining query parameters are sorted deterministically, and credential/signature-bearing source URLs are rejected before Hive admission.
- Added transport-independent Ed25519 observer proof-of-possession with bounded proof timestamps and exact-proof replay resistance.
- Separated cryptographic observer-key counts from unverified observer-key counts without claiming Sybil resistance or real-world identity independence.
- Added frictionless Hive Leases, free token-bucket CHECK admission, delayed contribution rewards based on qualified reuse across distinct conservative network-derived independence buckets, duplicate reward suppression and daily award caps.
- Added
FREEZEadmission ordering so disabled runtime state is checked before stateful Hive lease/quota mutation. - Added the human-only SeenRelay Control Room with live Hive Radar, runtime controls, audit trail, retention housekeeping, standards posture, operational readiness and prepared
NORMAL,SHIELD,READ_ONLY, andFREEZEincident modes. - Added runtime safety controls without creating any third agent-facing domain operation; CHECK and OBSERVE remain the only domain operations.
- Added Preview/Production database isolation, exact-deployment-SHA release gating and a Production E2E namespace fuse.
- Added privacy-safe public network metrics with qualified-reuse CHECK accounting separated from contributor award count.
- Added runtime tests for fact-key convergence, URL hygiene, exact source locators, Unicode safety, Ed25519 verification, tamper rejection, expired-proof rejection, Hive classification, anti-farming, credential rotation and control-plane guardrails.
- Added a production dependency vulnerability audit gate, committed lockfile and
npm ci; removed unused local Vercel CLI tooling from the dependency tree. - Added Dependabot and a read-only Standards Watch that can discover and prepare maintenance work but cannot mutate Production automatically.
- Preserved the hard billing-disabled boundary.
0.2.0 - 2026-08-21
- Renamed working product from FactTick to SeenRelay.
- Migrated target architecture from Cloudflare/D1 to Vercel + Neon Postgres.
- Kept the two-operation product boundary: CHECK and OBSERVE.
- Updated MCP target protocol to 2026-07-28 stateless semantics.
- Preserved the billing-disabled invariant.