NousResearch/hermes-agent · error · Error

Background restart did not return a task id

Error message

Background restart did not return a task id

What it means

Error "Background restart did not return a task id" thrown in NousResearch/hermes-agent.

Source

Thrown at apps/desktop/src/app/session/hooks/use-preview-routing.ts:50

      const sessionId = $focusedRuntimeId.get()

      if (!sessionId) {
        throw new Error('No active session for background restart')
      }

      const cwd = $currentCwd.get() || currentCwd || ''

      const result = await requestGateway<{ task_id?: string }>('preview.restart', {
        context: context || undefined,
        cwd: cwd || undefined,
        session_id: sessionId,
        url
      })

      const taskId = result.task_id || ''

      if (!taskId) {
        throw new Error('Background restart did not return a task id')
      }

      beginPreviewServerRestart(taskId, url)

      return taskId
    },
    [currentCwd, requestGateway]
  )

  const handleDesktopGatewayEvent = useCallback<EventHandler>(
    event => {
      baseHandleGatewayEvent(event)

      if (event.type === 'preview.open') {
        // Agent-driven open in response to an explicit user request ("show
        // cnn.com in the preview pane"). Honor it for any session that's ON
        // SCREEN — the primary chat or an open tile — not only the focused
        // one: the turn's window routing already scoped the event to this

View on GitHub (pinned to c896c09c42)

Solutions

1. Retry the restart; the gateway response was incomplete.
2. Check gateway connectivity and confirm the background task toolset is enabled.
3. Restart the preview manually from the preview pane.

When it happens

Trigger: Thrown at apps/desktop/src/app/session/hooks/use-preview-routing.ts:50 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of NousResearch/hermes-agent@c896c09c42 (2026-08-14). Data as JSON: /api/errors/34424f98998c04f8. Report an issue: GitHub.