@openeditor/embedded-runtime

The authoritative OpenEditor editing engine for web and embedded native hosts. It owns the canonical Tiptap/ProseMirror extension factory, document schema, selection, input, structural commands, and history. @openeditor/react adds React node views to these extensions; it does not define a second schema.

The runtime is deliberately UI-agnostic. @openeditor/embedded-surface is the only packaged WebView surface: it combines this engine with the exact React NodeViews used by @openeditor/react and emits a self-contained offline HTML module for @openeditor/native.

Server-side consumers can use getOpenEditorEngineSchema, validateOpenEditorEngineDocument, and createOpenEditorEngineSchemaManifest to inspect or validate against the exact extension set used by the editor. These helpers use the headless @openeditor/tiptap adapter, so server validation and workspace schema context do not require a parallel schema.

Host contract

• Pass a stable sessionId in the injected host configuration.
• Wait for ready, then send command envelopes with unique IDs.
• Treat ack or correlated error as the terminal response to every command.
• Observe stateChanged and documentChanged revisions. Use requestDocument only at persistence/synchronization boundaries; the runtime never sends a full document for each transaction.
• Resolve nativeEffectRequest messages exactly once with a correlated nativeEffectResponse.
• Do not forward keys, text replacements, IME operations, or platform selections. The WebView is the input client and Tiptap is authoritative.