SeenRelay

io.github.ovladon由 GitHub 帳號 ovladon 發布v0.3.10更新於 Nov 2, 2026

Avoid redundant expensive validation. CHECK recent evidence; OBSERVE fresh independent results.

已驗證Streamable HTTP可網頁執行資料與分析AI 與機器學習

概覽

AI 產生的概覽

SeenRelay 是託管的 MCP 服務,提供 check_fact 與 observe_fact 兩個工具,記錄並回報有來源事實的近期證據,協助代理避免重複昂貴的驗證。

可以做什麼
  • 依已知的事實識別查詢近期共享觀測,回傳 SAME_OBSERVED、CHANGED_OBSERVED、CONTESTED、STALE 或 UNKNOWN 等狀態
  • 提交一次剛完成且獨立驗證的觀測,可選擇附上 Ed25519 金鑰持有證明,供後續查詢使用
  • 把回傳的證據當作付費搜尋、計量擷取、限流 API 或多步驟驗證前的成本預檢
  • 只回報近期觀測,是否再次驗證仍由呼叫端決定
適用情境
適用於代理或一組代理反覆為同一項唯讀、有來源的驗證付費,並想先確認是否已有近期觀測的情況。它是決策輔助,不是查詢他人原始結果的工具,本身不瀏覽、不搜尋也不核驗來源。
執行需求
遠端 MCP 端點位於 seenrelay.com;SeenRelay 本身不需要帳號或 API 金鑰。呼叫端需提供已知值、確定性的有來源事實識別,以及自己的新鮮度視窗。選用用戶端程式庫以 npm 與 PyPI 套件形式提供。
安裝前請注意
共享證據屬於呼叫端政策,無法證明真實性或獨立的現實主體;SAME_OBSERVED 並非真實性結論。觀測值與事實座標會傳送到第三方託管服務,應避免使用帶憑證或簽章的來源網址。不得抑制變更或破壞性操作,重複使用必須限定在明確的新鮮度視窗內。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 SeenRelay,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.ovladon%2Fseenrelay/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "seenrelay": {
      "type": "http",
      "url": "https://seenrelay.com/mcp"
    }
  }
}

README

SeenRelay

Decide when you actually need to look again.

SeenRelay measures repeated expensive read-only execution around agents and distributed software. It prefers local/private and source/provider-native controls first, preserves authoritative execution while measuring, and keeps only paths that earn a USE verdict. Start locally with npx seenrelay scan; if no candidate exists or a stronger native control already wins, stop there. DO NOT USE and INSUFFICIENT EVIDENCE are valid outcomes.

Currently free · no account · no SeenRelay API key required.

Terminology: a Savings Report (machine label: Verified Savings Record) is measurement evidence for avoided work and cost provenance. It is not an invoice, bill, charge or payment receipt. Some SDK/API identifiers retain receipt wording for backward compatibility only.

SeenRelay itself requires no account or API key. A third-party client, directory, gateway, or assistant may require its own account to use that third-party service; that is not a SeenRelay access requirement. The canonical direct MCP endpoint is https://seenrelay.com/mcp.

See measured proof before you install

The Proof Atlas shows where SeenRelay has already reduced real provider work under frozen semantic contracts:

  • 8-agent first-party operating workload: eight department agents across two tenant identities kept their independent role analyses while sharing approved current evidence. Paid web-search actions fell 13 → 4 and measured provider cost fell $0.16499684 → $0.05560972 ($0.10938712 gross avoided; 66.30% reduction for this run). One tenant was real SeenRelay operating work; the second was an explicitly synthetic external-client rehearsal with real provider execution.
  • real live-event monitoring: four paid downstream briefings became one on unchanged event state across 3/3 paired runs (79.61% mean gross reduction), while a changed event fingerprint forced fresh work;
  • 64 GB hosted compute: $1.9241253 → $0.4820025 for four compatible intents ($1.4421228 avoided; 74.95% gross reduction) — mechanism-only for the exact SHA-256 task because local computation wins Tool Necessity;
  • real retail monitoring: 4 → 1 Firecrawl credits across 3/3 unchanged-state trials (75% reduction) under its bounded contract.

The 8-agent result is first-party operating evidence, not external customer adoption, customer ROI or net customer savings; local coordination/integration overhead was not monetized. Other Proof Atlas rows include controlled mechanism results, and a high reduction does not automatically mean the expensive tool was the best baseline. Proof Atlas exposes baseline quality separately. For example, the 64 GB SHA-256, fixed-rule weather, fixed-string LiteLLM, and PyPI-version web-search tests are mechanism-only because cheaper local/source-native solutions exist for those exact benchmark tasks. Negative evidence is published too.

Human-readable proof: https://seenrelay.com/proof
Machine-readable proof: https://seenrelay.com/proof.json

What SeenRelay is deciding

SeenRelay is designed around one question: “I already know X — do I need to pay to validate X again now?”

CHECK is not a lookup for somebody else's raw result. The caller supplies the known value, deterministic source-backed fact identity and its own freshness window. SeenRelay reports compatible recent evidence; the caller keeps authority over whether to validate again.

For a small public set of source-backed facts, use the canonical starter descriptors at https://seenrelay.com/starter-facts.json. They publish identity metadata only — no observed values, no recommended TTL and no reuse authorization. Full decision-layer rationale: docs/DECISION_LAYER.md.

Not sure whether SeenRelay fits? Ask for a workload audit

If you have a public workload that appears to repeat expensive read-only work, you can ask for a native-first prescreen before installing anything:

https://github.com/ovladon/seenrelay/issues/new?template=audit-my-workload.yml

The first answer may be REJECT BEFORE COLLECTION, MEASURE IN SHADOW, or INSUFFICIENT EVIDENCE. A local, source-native, or provider-native control winning is a successful result.

Fastest start: give SeenRelay to your coding agent

Claude Code can install SeenRelay persistently from this repository's validated self-hosted marketplace:

bash
claude plugin marketplace add ovladon/seenrelayclaude plugin install --scope user seenrelay@seenrelay

This direct-install path is repository-hosted and does not imply Anthropic marketplace approval. It does not automatically attach the hosted MCP endpoint or enable reuse.

GitHub Copilot CLI can discover the existing portable Agent Plugins package from this repository's self-hosted marketplace:

bash
copilot plugin marketplace add ovladon/seenrelaycopilot plugin install seenrelay@seenrelay

The Copilot route is optional and uses the repository's existing skill and MCP metadata. It does not enable reuse automatically. Marketplace publication does not imply listing in a curated or default catalog, and end-to-end Copilot installation is not yet independently verified.

Other Agent Skills clients can use the canonical domain:

bash
npx skills add https://seenrelay.com --skill seenrelay --yes

Then ask it:

text
Run a SeenRelay shadow audit on this project. Find repeated expensive read-only validations, preserve every authoritative call, measure stronger local/source/provider-native controls first, do not enable reuse, and return USE / DO NOT USE / INSUFFICIENT EVIDENCE for each measured workload.

Or use the developer paths below. Full audit method: docs/SHADOW_AUDIT.md.

Install: npm install seenrelay · pip install seenrelay · client v0.2.30 · currently free · no account/API key.

Zero-code local prescreen

Before changing application code, ask whether the repository even contains a plausible recurring expensive read-only validation path:

bash
npx seenrelay scan

The scan is local-only: it does not contact SeenRelay, upload source code or modify the project. It reports only pre-evidentiary states such as CANDIDATE_FOR_SHADOW_MEASUREMENT, NATIVE_CONTROL_FIRST, NEEDS_RUNTIME_EVIDENCE and NO_ELIGIBLE_CANDIDATE_FOUND. Static analysis cannot return USE or authorize reuse.

Optional GitHub Actions cost prescreen

Teams can expose the same local-only static prescreen in CI without a SeenRelay account or API key:

yaml
- id: seenrelay  uses: ovladon/seenrelay-cost-prescreen@v1

The action runs on the GitHub runner, does not contact the SeenRelay service, does not upload source code to SeenRelay, and cannot enable reuse or return a USE verdict. It produces a team-visible job summary plus machine outputs for the static status and next non-mutating decision.

Free shadow audit: measure without changing application behavior

Ambient wraps an existing MCP-style client in local shadow mode. The authoritative call still runs; SeenRelay measures exact repetition and produces a local report.

JavaScript / TypeScript:

bash
npm install seenrelay
js
import { ambientMcpClient } from 'seenrelay/ambient';
const client = ambientMcpClient(rawMcpClient);// use client.callTool(...) normallyconsole.log(client.seenRelayAmbient.getReport());

Python:

bash
pip install seenrelay
python
from seenrelay_ambient import ambient_mcp_client
client = ambient_mcp_client(raw_mcp_client)# await client.call_tool(...) normallyprint(client.get_report())

Run the existing workload and inspect the report before enabling any bounded reuse. Shared CHECK remains optional and off by default in Zero-State.

SeenRelay is a provider-independent reuse layer for repeated read-only validation. It has exactly two hosted domain operations: CHECK and OBSERVE, and reports recent observations rather than universal truth.

Current JavaScript/TypeScript and Python clients include multi-signal shared-evidence assurance helpers, deterministic Fact Coordinate Kit v1 and provider-independent Zero-State. Python Zero-State supports explicit read-only in-flight/local reuse, caller-owned private L1 and source-native conditional validation before authoritative fallback. The classic Python API and Python Ambient adapters remain shadow-first by default. Shared evidence is explicit caller policy, does not prove truth or independent real-world actors, and MCP/OpenAPI coordinates are local repetition keys unless a stable source-native locator supports a shared fact descriptor. Provider-specific adapters are optional.

What it can avoid

Even with no shared observation:

  • simultaneous identical eligible calls can be coalesced in-process;
  • completed read-only results can be reused only inside an explicit caller-defined freshness window;
  • optional encrypted caller-owned L1 storage can reuse values across workers or restarts;
  • ETag / Last-Modified can support source-native conditional confirmation without a shared CHECK;
  • shared CHECK is optional in Zero-State and is not placed on the hot path merely because SeenRelay is installed;
  • after a genuinely fresh independent validation, OBSERVE can add evidence that may help later callers.

Access is currently free and requires no account or API key.

Start here

  • Decision layer: docs/DECISION_LAYER.md
  • Canonical starter facts: https://seenrelay.com/starter-facts.json
  • Free shadow audit: docs/SHADOW_AUDIT.md
  • Claude Code persistent install: claude plugin marketplace add ovladon/seenrelay then claude plugin install --scope user seenrelay@seenrelay
  • Other coding-agent install: npx skills add https://seenrelay.com --skill seenrelay --yes
  • Public install: npm install seenrelay or pip install seenrelay
  • JavaScript / TypeScript Zero-State: clients/typescript/README.md
  • Fleet economics: https://seenrelay.com/economics
  • Client overview: clients/README.md
  • Integration choices and MCP setup: docs/CLIENTS.md
  • Quickstart: docs/QUICKSTART.md
  • Protocol contract: docs/PROTOCOL.md
  • Web quickstart: https://seenrelay.com/quickstart
  • Web client integrations: https://seenrelay.com/clients
  • MCP endpoint: https://seenrelay.com/mcp
  • Official MCP Registry: io.github.ovladon/seenrelay
  • OpenAPI: https://seenrelay.com/openapi.json
  • Machine descriptor: https://seenrelay.com/service.json
  • Machine-oriented index: https://seenrelay.com/llms.txt

How it works

For eligible JavaScript/TypeScript Zero-State calls, the preferred order is:

  1. exact in-process reuse / coalescing when safe;
  2. optional caller-owned private reuse;
  3. source-native conditional confirmation when available;
  4. optional shared SeenRelay CHECK when configured and useful;
  5. the application's original validation as fallback;
  6. OBSERVE only after a fresh independent validation that is eligible for contribution.

For direct REST/MCP or the classic wrapper, CHECK and OBSERVE remain available exactly as before.

Possible CHECK statuses are SAME_OBSERVED, CHANGED_OBSERVED, CONTESTED, STALE, and UNKNOWN.

SAME_OBSERVED means the same value was recently observed for the same deterministic fact identity. It is not a truth verdict. The consuming agent decides whether the evidence is sufficient for its own policy.

JavaScript / TypeScript Zero-State

js
import { SeenRelayZeroState } from 'seenrelay/zero-state';
const edge = new SeenRelayZeroState({  localMaxAgeMs: 30_000});
const result = await edge.guard({  coordinate: {    tool: 'catalog.read',    arguments: { id: 42 }  },  validate: async () => expensiveRead()});
console.log(result.value);

The default completed-result freshness window is 0. SeenRelay does not invent a TTL for arbitrary calls. Mutation/destructive operations must not be suppressed; generic core does not infer read-only safety from tool names, descriptions or untrusted annotations.

For MCP clients, seenrelay/mcp-auto can bind once around explicitly allowlisted callTool() operations. Unlisted tools pass through unchanged.

Classic shadow-first path

The original JavaScript/TypeScript and Python APIs remain available. Without an explicit reuse policy they CHECK, keep the original validation, and OBSERVE the independently obtained result best-effort.

js
const relay = new SeenRelayClient();
const validatePrice = relay.protectValidation({  fact,  validate: ({ conditionalHeaders }) => existingValidation(conditionalHeaders)});
const value = await validatePrice(knownValue);

Python exposes the equivalent protect_validation(...) path. Use Shadow Proof when you specifically want to measure public CHECK evidence before enabling classic bounded reuse.

Source-native revalidation

Source-native validators are preferable to guessing freshness. When a retained response carries a safe ETag or Last-Modified validator, a later eligible validation can try If-None-Match or If-Modified-Since. A 304 Not Modified response is confirmation from the source, not from SeenRelay.

The classic CHECK/OBSERVE path can also carry observer-supplied ETag / Last-Modified metadata as an explicitly unverified conditional-request hint. The caller still decides whether source confirmation is required.

Optional private L1

JavaScript/TypeScript Zero-State can use a caller-supplied private store plus codec for reuse across workers or restarts. SeenRelay provides an AES-256-GCM codec helper; the caller owns the key, storage and namespace.

Private values are not sent to the public SeenRelay service merely because private L1 is enabled. Store or codec failure fails open into the application's normal validation path.

Fact identity

SeenRelay uses the versioned seenrelay-fact-v3 identity contract. Identity precedence is:

  1. stable source-native locator (json_pointer, element_id, source_key);
  2. canonical machine predicate when no stable locator exists.

Human-readable subject text and mutable observed content do not enter the fact key. Source URLs are canonicalized deterministically without browsing. Credential- or signature-bearing source URLs are rejected before stateful admission.

See docs/PROTOCOL.md for the complete contract.

Observer provenance

OBSERVE supports optional transport-independent ed25519-v1 proof-of-possession. A valid proof establishes key possession, continuity, and payload integrity. It does not establish legal identity, independent real-world actor identity, or truth.

An intermediary provider-cache hit is not re-labeled as a new independent OBSERVE merely because a different caller received it.

Access and contribution

SeenRelay issues signed ephemeral operational leases without account creation. CHECK and OBSERVE are currently free to use. Contribution credit is based on later qualifying reuse rather than raw submission volume.

Hive classes describe operational contribution only; they are not identity or truth scores.

Public interfaces

The canonical domain is seenrelay.com.

  • Browser Accept: text/html at / receives the public landing page.
  • Generic/API requests to / receive the machine descriptor.
  • /service.json exposes the explicit machine descriptor.
  • /public-stats.json exposes privacy-safe aggregate activity.
  • /openapi.json exposes the REST contract.
  • /mcp exposes MCP 2026-07-28.
  • /quickstart and /clients provide integration instructions.

Product boundary

SeenRelay itself does not browse or search fact sources, perform on-demand external verification, call an LLM to decide truth, or expose a shared general-agent memory. UNKNOWN simply means no sufficiently recent reusable shared observation is available.

Client-side adapters can use source-native validation or integrate with existing providers, but provider adapters are optional and cannot become dependencies of the provider-independent core.

Architecture

  • Vercel managed deployment
  • Neon Postgres state store
  • Hono + TypeScript / Node 22
  • REST/OpenAPI
  • MCP 2026-07-28 through the official v2 server SDK
  • provider-independent JavaScript/TypeScript Zero-State client plus classic JavaScript/TypeScript and Python wrappers
  • authenticated human-only Control Room for runtime operations and incident controls

A2A is monitored but is not advertised as an implemented product interface.

Verification

npm run check performs TypeScript checks, product guardrails, production dependency auditing, structural tests, and runtime tests. Package Validation clean-installs built npm/PyPI artifacts. The Preview Release Gate additionally exercises REST, MCP, fact identity, security boundaries, runtime controls, and reuse accounting against the required Preview runtime commit, accepting a later serving SHA only when every intervening commit is outside the Vercel runtime boundary.

Builds use the committed lockfile and npm ci.

Maintenance

Dependabot and Standards Watch prepare isolated maintenance work. Production changes remain subject to compatibility, security, CI, and Preview verification gates.

Bootstrap

bash
npm cinpm run check# DATABASE_ADMIN_URL must be set only for this migration commandnpm run db:migrate

Deployment details are in docs/DEPLOYMENT.md.

來源:README.md,提交 c284eac

工具

2

check_fact

Check Fact Freshness

Cost preflight before repeated paid or slow source-backed validation, especially across an agent fleet. Use before paid web search, metered scraping, browser/extraction, rate-limited APIs or multi-step validation when the caller already has a known value. Returns SAME_OBSERVED, CHANGED_OBSERVED, CONTESTED, STALE or UNKNOWN. Only SAME_OBSERVED can be considered for caller-policy-gated reuse; every other status requires normal authoritative validation before OBSERVE. SeenRelay never browses or verifies externally.

輸入參數fact必填known_value必填max_age_seconds

observe_fact

Contribute Fact Observation

After independently performing a source-backed validation, deposit the observed result for later CHECKs. Returns accepted=true when a new observation is stored or deduplicated=true for a recognized retry/recent duplicate. Never OBSERVE hearsay. Optional Ed25519 proof establishes key possession and continuity, not truth or real-world independence.

輸入參數fact必填value必填observed_atobserver_idobserver_proofidempotency_keysource_validatorevidence_fingerprint

版本歷史

1
  1. v0.3.10最新Sep 16, 2026

評分

已滿足適用檢查項的 90%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。