[tiptap warn]: "AiInsertReveal" needs the Collaboration exte

Error message

[tiptap warn]: "AiInsertReveal" needs the Collaboration extension to see incoming text. Nothing is revealed.

What it means

Error "[tiptap warn]: "AiInsertReveal" needs the Collaboration extension to see incoming text. Nothing is revealed." thrown in ueberdosis/tiptap.

Source

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

            // animation; offset by the run's age to resume the fade instead.
            const decorations = mergeRuns(ranges).map(range =>
              Decoration.inline(range.from, range.to, {
                class: className,
                style: `animation-delay: -${range.delay}ms`,
              }),
            )

            return DecorationSet.create(state.doc, decorations)
          },
        },

        view: view => {
          const initialState = ySyncPluginKey.getState(view.state) as YSyncState | undefined
          const fragment = initialState?.type ?? null
          const awareness = provider?.awareness ?? null

          if (fragment === null) {
            console.warn(
              '[tiptap warn]: "AiInsertReveal" needs the Collaboration extension to see incoming text. Nothing is revealed.',
            )
          }

          const trackAiClients = () => {
            const known = aiClients.size
            awareness
              ?.getStates()
              .forEach((state: Record<string, any> | undefined, clientId: number) => {
                if (isAiUser(state?.user)) aiClients.add(clientId)
              })
            // Runs that arrived before the AI was identified can now be revealed.
            if (aiClients.size > known) scheduleRerender()
          }

          let raf: number | null = null
          let pruneTimer: ReturnType<typeof setTimeout> | null = null

View on GitHub (pinned to 496d53afd7)

When it happens

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