Proof SDK — это редактор с открытым исходным кодом, сервер совместной работы, модель происхождения и HTTP-мост агента, которые обеспечивают совместные документы в Proof.

Если вам нужен размещённый продукт, используйте Proof. Hosted Proof создаётся компанией Every.

Что входит в состав

• Совместный редактор разметки с отслеживанием происхождения
• Комментарии, предложения и операции переписывания
• Сервер совместной работы в реальном времени
• Агентский HTTP-мост для состояния, меток, правок, присутствия и событий
• Небольшой пример приложения под apps/proof-example

Планировка рабочего пространства

• packages/doc-core
• packages/doc-editor
• packages/doc-server
• packages/doc-store-sqlite
• packages/agent-bridge
• apps/proof-example
• server
• src

Местное развитие

Требования:

• Node.js 18+

Установочные зависимости:

Запустите редактор:

Запустите локальный сервер:

Стандартная настройка обслуживает редактор на http://localhost:3000 и API/сервер на http://localhost:4000.

Основные маршруты

Маршруты каноничного доказательства SDK:

• POST /documents
• GET /documents/:slug/state
• GET /documents/:slug/snapshot
• POST /documents/:slug/edit
• POST /documents/:slug/edit/v2
• POST /documents/:slug/ops
• POST /documents/:slug/presence

Proof SDK

Proof SDK is the open-source editor, collaboration server, provenance model, and agent HTTP bridge that power collaborative documents in Proof.

If you want the hosted product, use Proof. Hosted Proof is made by Every.

What Is Included

• Collaborative markdown editor with provenance tracking
• Comments, suggestions, and rewrite operations
• Realtime collaboration server
• Agent HTTP bridge for state, marks, edits, presence, and events
• A small example app under apps/proof-example

Workspace Layout

• packages/doc-core
• packages/doc-editor
• packages/doc-server
• packages/doc-store-sqlite
• packages/agent-bridge
• apps/proof-example
• server
• src

Local Development

Requirements:

• Node.js 18+

Install dependencies:

npm install

Start the editor:

npm run dev

Start the local server:

npm run serve

The default setup serves the editor on http://localhost:3000 and the API/server on http://localhost:4000.

Core Routes

Canonical Proof SDK routes:

• POST /documents
• GET /documents/:slug/state
• GET /documents/:slug/snapshot
• POST /documents/:slug/edit
• POST /documents/:slug/edit/v2
• POST /documents/:slug/ops
• POST /documents/:slug/presence
• GET /documents/:slug/events/pending
• POST /documents/:slug/events/ack
• GET /documents/:slug/bridge/state
• GET /documents/:slug/bridge/marks
• POST /documents/:slug/bridge/comments
• POST /documents/:slug/bridge/suggestions
• POST /documents/:slug/bridge/rewrite
• POST /documents/:slug/bridge/presence

Compatibility aliases remain mounted for the hosted product, but the routes above are the public SDK surface.

Build

npm run build

The build outputs the web bundle to dist/ and writes dist/web-artifact-manifest.json.

Tests

npm test

Docs

• AGENT_CONTRACT.md
• docs/agent-docs.md
• docs/proof.SKILL.md
• docs/adr/2026-03-proof-sdk-public-core.md

License

• Code: MIT in LICENSE
• Trademark guidance: TRADEMARKS.md