[tiptap warn]: The "provider" option is required for "AiInse

Error message

[tiptap warn]: The "provider" option is required for "AiInsertReveal" to tell the AI apart from other collaborators. Nothing is revealed without it.

What it means

Error "[tiptap warn]: The "provider" option is required for "AiInsertReveal" to tell the AI apart from other collaborators. Nothing is revealed without it." thrown in ueberdosis/tiptap.

Source

Thrown at packages/ai-toolkit/src/streaming-reveal.ts:239

 * It never mutates the document, so it is inert to accept/reject and persistence.
 * Requires Collaboration, a provider, and CSS for `className` (default `ai-insert-reveal`).
 */
export const AiInsertReveal = Extension.create<AiInsertRevealOptions>({
  name: 'aiInsertReveal',

  addOptions() {
    return {
      className: 'ai-insert-reveal',
      durationMs: 550,
      provider: null,
    }
  },

  onCreate() {
    const { provider, durationMs } = this.options

    if (!provider) {
      console.warn(
        '[tiptap warn]: The "provider" option is required for "AiInsertReveal" to tell the AI apart from other collaborators. Nothing is revealed without it.',
      )
    } else if (!provider.awareness) {
      console.warn(
        '[tiptap warn]: The provider passed to "AiInsertReveal" has no awareness, so the AI cannot be identified. Nothing is revealed.',
      )
    }

    if (durationMs <= 0) {
      console.warn(
        `[tiptap warn]: "AiInsertReveal" needs a positive "durationMs" to hold a reveal, got ${durationMs}. Nothing is revealed.`,
      )
    }
  },

  addProseMirrorPlugins() {
    const { className, durationMs, provider } = this.options

View on GitHub (pinned to 496d53afd7)

When it happens

Trigger: Thrown at packages/ai-toolkit/src/streaming-reveal.ts:239 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of ueberdosis/tiptap@496d53afd7 (2026-08-26). Data as JSON: /api/errors/547885155ea79a24. Report an issue: GitHub.