[tiptap warn]: "AiInsertReveal" needs a positive "durationMs

Error message

[tiptap warn]: "AiInsertReveal" needs a positive "durationMs" to hold a reveal, got ${durationMs}. Nothing is revealed.

What it means

Error "[tiptap warn]: "AiInsertReveal" needs a positive "durationMs" to hold a reveal, got ${durationMs}. Nothing is revealed." thrown in ueberdosis/tiptap.

Source

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

      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
    // tokens can arrive before that entry lands.
    const aiClients = new Set<number>()

    const dropExpired = (now: number) => {
      let firstActive = 0
      while (firstActive < entries.length && now - entries[firstActive].at >= durationMs) {

View on GitHub (pinned to 496d53afd7)

When it happens

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