deepseek-ai/deepseek-harness · error

client-hmr: unparseable event frame: ${event.data}

Error message

client-hmr: unparseable event frame: ${event.data}

What it means

Error "client-hmr: unparseable event frame: ${event.data}" thrown in deepseek-ai/deepseek-harness.

Source

Thrown at packages/client/hmr/src/client/index.ts:174

        // network anyway (host serves bundles no-cache); graph rev refresh
        // lands with the reconnect-handshake mechanism.
        break
      default:
        // Merge-extensible frame union: unknown frame types from newer hosts
        // are ignored by design.
        break
    }
  }

  ctx.effect(() => {
    const source = new EventSource(EVENTS_ENDPOINT)
    source.addEventListener('message', (event: MessageEvent<string>) => {
      let frame: PluginsEventFrame
      try {
        frame = JSON.parse(event.data) as PluginsEventFrame
      } catch {
        // Wire boundary: a malformed dev-channel frame is dropped loudly.
        ctx.logger.warn(`client-hmr: unparseable event frame: ${event.data}`)
        return
      }
      handle(frame)
    })
    return () => { source.close() }
  }, 'client-hmr: event source')
}

View on GitHub (pinned to b150a551b8)

Solutions

1. Ensure the client and dev server run matching versions; restart the dev server to resync the HMR protocol.

When it happens

Trigger: Thrown at packages/client/hmr/src/client/index.ts:174 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of deepseek-ai/deepseek-harness@b150a551b8 (2026-08-24). Data as JSON: /api/errors/45b1d4ff2cb1b084. Report an issue: GitHub.