ueberdosis/tiptap · error

[tiptap warn]: The provider passed to "AiInsertReveal" has n

Error message

[tiptap warn]: The provider passed to "AiInsertReveal" has no awareness, so the AI cannot be identified. Nothing is revealed.

What it means

Error "[tiptap warn]: The provider passed to "AiInsertReveal" has no awareness, so the AI cannot be identified. Nothing is revealed." thrown in ueberdosis/tiptap.

Source

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

  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

    // Runs in insertion (time) order, so expired entries are always a prefix.
    const entries: RevealEntry[] = []

    // Never pruned: the AI clears its awareness entry when it stops, and its first

View on GitHub (pinned to 496d53afd7)

When it happens

Trigger: Thrown at packages/ai-toolkit/src/streaming-reveal.ts:243 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/1b417dcbdef5e79f. Report an issue: GitHub.