SeenRelay

AI 에이전트를 위한 재사용 정보 획득.

작동 방식에 대한 비유: Waze는 모든 도로를 검사하기 위해 특별한 차량을 보내지 않습니다. 운전자들이 이미 이동 중이며, 그들의 관찰이 공유 교통 상태를 업데이트하고, 다음 운전자는 동일한 상태를 다시 발견하는 것을 피합니다. SeenRelay는 AI 에이전트가 사용하는 소스 기반 사실에 그 패턴을 적용합니다.

사실을 다시 확인하기 전에, 다른 에이전트가 최근에 그 사실을 관찰했는지 물어보십시오. 어쨌든 소스를 독립적으로 확인한다면, 다음 에이전트를 위해 관찰 결과를 남기십시오.

시작하기

• 인간 통합 가이드: docs/QUICKSTART.md

• 검증된 MCP 클라이언트 통합: docs/CLIENTS.md

• 의사결정자 파일럿 및 중단 기준: docs/PILOT.md

• 웹 퀵스타트: https://seenrelay.com/quickstart

• 웹 클라이언트 통합: https://seenrelay.com/clients

• MCP 원격 엔드포인트: https://seenrelay.com/mcp

• MCP 레지스트리 식별자: io.github.ovladon/seenrelay

• REST/OpenAPI 계약: https://seenrelay.com/openapi.json

• 머신 설명자: https://seenrelay.com/service.json

• 머신 지향 인덱스: https://seenrelay.com/llms.txt

권장되는 첫 배포는 섀도우 모드입니다: 기존 재검증 전에 CHECK를 수행하되, 처음에는 아무것도 건너뛰지 마십시오. 제한된 재사용을 허용하기 전에 SeenRelay가 무엇을 절약했을지 측정하십시오.

Related MCP server: Memory MCP

두 가지 작업만

• CHECK — 에이전트가 이미 알고 있는 값을 동일한 결정적 소스 기반 사실에 대한 최근 관찰과 비교합니다.

• OBSERVE — 호출자가 자신의 작업을 수행하면서 독립적으로 관찰한 값을 기여합니다.

상태: SAME_OBSERVED, CHANGED_OBSERVED, CONTESTED, STALE, UNKNOWN.

SeenRelay는 관찰을 보고하며, 보편적 진리를 보고하지 않습니다.

사실 식별 v3

SeenRelay는 버전이 지정된 seenrelay-fact-v3 식별 계약을 사용하며 두 사실이 동일하다고 판단하기 위해 LLM/퍼지 매처를 절대 사용하지 않습니다.

식별 우선순위는 다음과 같습니다:

1. 안정적인 소스 고유 로케이터(json_pointer, element_id, source_key);

2. 로케이터가 없을 때 표준 머신 술어.

사람이 읽을 수 있는 subject 텍스트는 사실 키에 절대 들어가지 않습니다. 변경 가능한 관찰 콘텐츠는 사실 키에 절대 들어가지 않습니다. 소스 URL은 브라우징 없이 표준화됩니다: 프래그먼트가 제거되고, 호스트/기본 포트가 정규화되며, 자격 증명/서명이 포함된 URL은 거부되고, 알려진 추적 매개변수가 제거되며, 나머지 쿼리 매개변수는 결정적으로 정렬됩니다.

정확한 계약은 docs/PROTOCOL.md를 참조하십시오.

관찰자 출처 증명

OBSERVE는 선택적 전송 독립적 ed25519-v1 소유 증명을 지원합니다.

유효한 증명은 키 소유권, 연속성 및 페이로드 무결성을 확립합니다. 하나의 키가 하나의 독립적인 사람/조직/장치/에이전트와 동일하다는 것을 증명하지 않으며 전역 Sybil 신원 문제를 해결하지 않습니다. 따라서 SeenRelay는 암호화 및 검증되지 않은 관찰자 키 수를 분리합니다.

Hive Lease: 계정 없음, 지연된 보상

모든 호출자는 계정 생성, 로그인, 이메일 또는 OAuth 없이 서명된 임시 Hive Lease를 받을 수 있습니다.

부트스트랩 동안:

• CHECK는 넉넉한 토큰 버킷으로 무료입니다;

• OBSERVE는 무료입니다;

• 원시 OBSERVE는 점수를 얻지 못합니다;

• 기여 점수는 이후 유용한 CHECK가 해당 관찰에 의해 지원되고 소비자가 다른 보수적 개인정보 보호 솔트 네트워크 독립 버킷에 속할 때만 상승합니다;

• 자체 선언된 클라이언트 라벨만 변경하는 것은 보상 독립성을 만들지 않습니다;

• 동일한 사실/값/기여자/소비자 튜플에 대한 반복 보상은 억제됩니다;

• 유용한 기여자는 더 많은 CHECK 용량/리필을 받습니다.

Hive 클래스(new, established, contributor)는 운영 기여만 설명하며 실제 세계의 신원이나 진리를 설명하지 않습니다.

공개 표면

표준 도메인은 seenrelay.com입니다.

• /에서 브라우저 Accept: text/html은 실시간 집계 지표가 포함된 의사결정자/에이전트 랜딩 페이지를 받습니다.

• /quickstart는 의사결정자와 구현자에게 가장 짧은 안전한 채택 경로를 제공합니다.

• /clients는 복사 준비된 MCP 클라이언트 구성을 제공합니다.

• /robots.txt, /sitemap.xml 및 /llms.txt는 제한된 공개 검색 메타데이터를 노출합니다.

• /에 대한 일반/API 요청은 머신 판독 가능 서비스 설명자를 유지합니다.

• /service.json은 안정적인 머신 설명자를 명시적으로 노출합니다.

• /public-stats.json은 개인정보 보호에 안전한 집계 네트워크 지표를 노출합니다.

• /openapi.json은 REST 계약을 노출합니다.

• /mcp는 MCP 2026-07-28을 노출합니다.

이 사이트는 합성 성장 주장이 아닌 측정된 네트워크 유용성을 보여주도록 설계되었습니다.

의도적으로 하지 않는 것

• 웹을 브라우징하거나 검색하지 않습니다;

• 요청 시 사실을 검증하지 않습니다;

• 진리를 결정하기 위해 LLM을 실행하지 않습니다;

• 일반 지식 그래프가 되지 않습니다;

• 공유 에이전트 메모리로 작동하지 않습니다;

• 외부 연구 서비스를 호출하지 않습니다;

• 관찰이 인증된 진리라고 주장하지 않습니다.

SeenRelay가 UNKNOWN을 반환하면 호출자는 SeenRelay가 없었을 때와 정확히 동일하게 계속합니다. 호출자가 이후 소스를 독립적으로 관찰하면 OBSERVE를 호출할 수 있습니다.

아키텍처

• Vercel + Fluid Compute — 관리형 배포, TLS, 확장, 로그, 방화벽/지출 제어 및 롤백.

• Neon Postgres — 사실, 최근 관찰, Hive Lease 상태, 유용한 재사용 이벤트 및 집계 원격 측정.

• Hono + TypeScript / Node 22 — 간결한 웹 표준 API.

• REST/OpenAPI — 핵심 프로토콜 표면.

• MCP 2026-07-28 — 동일한 CHECK/OBSERVE 의미론을 가진 무상태 도구 액세스.

• Control Room — 인증된 인간 관리, 실시간 Hive Radar, 인시던트 플레이북, 표준 자세, 운영 준비 상태 및 관할권 이전 지원.

A2A 1.0.0은 모니터링되지만 의도적으로 노출되지 않습니다. SeenRelay는 현재 도구/인프라 서비스이며 작업 지향 자율 에이전트가 아닙니다. 진정한 A2A 작업 의미론 없이 Agent Card를 게시하는 것은 오해를 불러일으킬 수 있습니다.

검색 및 배포

registry/server.json은 io.github.ovladon/seenrelay에 대한 표준 MCP 레지스트리 매니페스트이며 원격 클라이언트를 https://seenrelay.com/mcp로 안내합니다.

저장소에는 공식 MCP 레지스트리를 위한 GitHub OIDC 게시 워크플로가 포함되어 있습니다. 게시자 바이너리를 고정하고 실행 전에 SHA-256을 검증합니다. 저장소에는 영구 레지스트리 자격 증명이 저장되지 않습니다.

검증 게이트

npm run check는 다음을 수행합니다:

• Node ESM 규칙에 따른 핵심 및 전체 TypeScript 타입 검사;

• 제품 가드레일(외부 사실 조사 fetch 없음, 청구 비활성화 시 fail-closed 동작 포함);

• 높음/치명적 심각도의 프로덕션 종속성 감사;

• 구조 테스트;

• 런타임 신원/보안/경제성 테스트.

GitHub Preview E2E는 추가로 다음을 실행합니다:

• REST CHECK/OBSERVE 수명 주기;

• 적격한 유용한 재사용 경제성 및 보수적 안티 파밍 동작;

• 멱등성 격리;

• CONTESTED 및 STALE 의미론;

• fact-v3 로케이터 수렴;

• Hive 입장 전 자격 증명이 포함된 소스 거부;

• 관리자/청구 경계;

• 개정 2026-07-28의 MCP server/discover, tools/list, check_fact 및 observe_fact;

• KPI 의미론: 하나의 CHECK에서 여러 기여자 보상은 하나의 적격 재사용 CHECK로 계산됩니다.

빌드는 커밋된 package-lock.json 및 npm ci로 재현 가능합니다.

유지보수 자동 조종

SeenRelay는 무인 프로덕션 변경을 허용하지 않으면서 생태계 변화를 감지하도록 설계되었습니다.

• Dependabot은 격리된 종속성/GitHub Actions 업그레이드 PR을 준비합니다.

• Standards Watch는 공식 MCP, A2A 및 OpenTelemetry 소스에 대해 매일 실행됩니다.

• 표준 드리프트는 GitHub 이슈를 생성/업데이트합니다.

• 프로토콜 의미 변경은 격리된 호환성 후보와 전체 검증 게이트가 필요합니다.

• main은 명시적 승인 없이 자동 병합되지 않습니다.

docs/MAINTENANCE_AUTOPILOT.md를 참조하십시오.

청구 상태

이 배포에서는 청구를 사용할 수 없습니다:

PAYMENTS_ENABLED=false
PAYMENT_PROVIDER=none

정상 요청 처리가 시작되기 전에 청구를 활성화하려는 모든 시도는 fail-closed로 종료됩니다.

프로젝트 컨텍스트

제품 범위를 수정하기 전에 다음을 읽으십시오:

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

부트스트랩

관리형 데이터베이스가 연결되면:

npm ci
npm run check
npm run db:migrate

배포 세부 사항은 docs/DEPLOYMENT.md에 있습니다.