feat(api): add history_v2 for cloud outputs (#6288)

## Summary

Backport outputs from new cloud history endpoint

Does:
1. Show history in the Queue
2. Show outputs from prompt execution

Does not:
1. Handle appending latest images generated to queue history
2. Making sure that workflow data from images is available from load
(requires additional API call to fetch)

Most of this PR is:
1. Test fixtures (truncated workflow to test).
2. The service worker so I could verify my changes locally.

## Changes

- Add `history_v2` to `history` adapter
- Add tests for mapping
- Do branded validation for promptIds (suggestion from @DrJKL)
- Create a dev environment service worker so we can view cloud hosted
images in development.

## Review Focus

1. Is the dev-only service work the right way to do it? It was the
easiest I could think of.
4. Are the validation changes too heavy? I can rip them out if needed.

## Screenshots 🎃 


https://github.com/user-attachments/assets/1787485a-8d27-4abe-abc8-cf133c1a52aa

┆Issue is synchronized with this [Notion
page](https://www.notion.so/PR-6288-Feat-history-v2-outputs-2976d73d365081a99864c40343449dcd)
by [Unito](https://www.unito.io)

---------

Co-authored-by: bymyself <cbyrne@comfy.org>

tests-ui/tests/platform/remote/comfyui/history/adapters/v2ToV1Adapter.test.ts

@@ -0,0 +1,120 @@
+/**
+ * @fileoverview Unit tests for V2 to V1 history adapter.
+ */
+import { describe, expect, it } from 'vitest'
+
+import { mapHistoryV2toHistory } from '@/platform/remote/comfyui/history/adapters/v2ToV1Adapter'
+import { zRawHistoryItemV2 } from '@/platform/remote/comfyui/history/types/historyV2Types'
+import type { HistoryResponseV2 } from '@/platform/remote/comfyui/history/types/historyV2Types'
+
+import {
+  expectedV1Fixture,
+  historyV2Fixture
+} from '@tests-ui/fixtures/historyFixtures'
+
+describe('mapHistoryV2toHistory', () => {
+  describe('fixture validation', () => {
+    it('should have valid fixture data', () => {
+      // Validate all items in the fixture to ensure test data is correct
+      historyV2Fixture.history.forEach((item: unknown) => {
+        expect(() => zRawHistoryItemV2.parse(item)).not.toThrow()
+      })
+    })
+  })
+
+  describe('given a complete V2 history response with edge cases', () => {
+    const history = mapHistoryV2toHistory(historyV2Fixture)
+
+    it('should transform all items to V1 format with correct structure', () => {
+      expect(history).toEqual(expectedV1Fixture)
+    })
+
+    it('should add taskType "History" to all items', () => {
+      history.forEach((item) => {
+        expect(item.taskType).toBe('History')
+      })
+    })
+
+    it('should transform prompt to V1 tuple [priority, id, {}, extra_data, outputNodeIds]', () => {
+      const firstItem = history[0]
+
+      expect(firstItem.prompt[0]).toBe(24)
+      expect(firstItem.prompt[1]).toBe('complete-item-id')
+      expect(firstItem.prompt[2]).toEqual({}) // history v2 does not return this data
+      expect(firstItem.prompt[3]).toMatchObject({ client_id: 'test-client' })
+      expect(firstItem.prompt[4]).toEqual(['9'])
+    })
+
+    it('should handle missing optional status field', () => {
+      expect(history[1].prompt[1]).toBe('no-status-id')
+      expect(history[1].status).toBeUndefined()
+    })
+
+    it('should handle missing optional meta field', () => {
+      expect(history[2].prompt[1]).toBe('no-meta-id')
+      expect(history[2].meta).toBeUndefined()
+    })
+
+    it('should derive output node IDs from outputs object keys', () => {
+      const multiOutputItem = history[3]
+
+      expect(multiOutputItem.prompt[4]).toEqual(
+        expect.arrayContaining(['3', '9', '12'])
+      )
+      expect(multiOutputItem.prompt[4]).toHaveLength(3)
+    })
+  })
+
+  describe('given empty history array', () => {
+    it('should return empty array', () => {
+      const emptyResponse: HistoryResponseV2 = { history: [] }
+      const history = mapHistoryV2toHistory(emptyResponse)
+
+      expect(history).toEqual([])
+    })
+  })
+
+  describe('given empty outputs object', () => {
+    it('should return empty array for output node IDs', () => {
+      const v2Response: HistoryResponseV2 = {
+        history: [
+          {
+            prompt_id: 'test-id',
+            prompt: {
+              priority: 0,
+              prompt_id: 'test-id',
+              extra_data: { client_id: 'test' }
+            },
+            outputs: {}
+          }
+        ]
+      }
+
+      const history = mapHistoryV2toHistory(v2Response)
+
+      expect(history[0].prompt[4]).toEqual([])
+    })
+  })
+
+  describe('given missing client_id', () => {
+    it('should accept history items without client_id', () => {
+      const v2Response: HistoryResponseV2 = {
+        history: [
+          {
+            prompt_id: 'test-id',
+            prompt: {
+              priority: 0,
+              prompt_id: 'test-id',
+              extra_data: {}
+            },
+            outputs: {}
+          }
+        ]
+      }
+
+      const history = mapHistoryV2toHistory(v2Response)
+
+      expect(history[0].prompt[3].client_id).toBeUndefined()
+    })
+  })
+})

tests-ui/tests/platform/remote/comfyui/history/fetchers/fetchHistoryV1.test.ts

@@ -0,0 +1,52 @@
+/**
+ * @fileoverview Unit tests for V1 history fetcher.
+ */
+import { describe, expect, it, vi } from 'vitest'
+
+import { fetchHistoryV1 } from '@/platform/remote/comfyui/history/fetchers/fetchHistoryV1'
+
+import { historyV1RawResponse } from '@tests-ui/fixtures/historyFixtures'
+
+describe('fetchHistoryV1', () => {
+  const mockFetchApi = vi.fn().mockResolvedValue({
+    json: async () => historyV1RawResponse
+  })
+
+  it('should fetch from /history endpoint with default max_items', async () => {
+    await fetchHistoryV1(mockFetchApi)
+
+    expect(mockFetchApi).toHaveBeenCalledWith('/history?max_items=200')
+  })
+
+  it('should fetch with custom max_items parameter', async () => {
+    await fetchHistoryV1(mockFetchApi, 50)
+
+    expect(mockFetchApi).toHaveBeenCalledWith('/history?max_items=50')
+  })
+
+  it('should transform object response to array with taskType and preserve fields', async () => {
+    const result = await fetchHistoryV1(mockFetchApi)
+
+    expect(result.History).toHaveLength(2)
+    result.History.forEach((item) => {
+      expect(item.taskType).toBe('History')
+    })
+    expect(result.History[0]).toMatchObject({
+      taskType: 'History',
+      prompt: [24, 'complete-item-id', {}, expect.any(Object), ['9']],
+      outputs: expect.any(Object),
+      status: expect.any(Object),
+      meta: expect.any(Object)
+    })
+  })
+
+  it('should handle empty response object', async () => {
+    const emptyMock = vi.fn().mockResolvedValue({
+      json: async () => ({})
+    })
+
+    const result = await fetchHistoryV1(emptyMock)
+
+    expect(result.History).toEqual([])
+  })
+})

tests-ui/tests/platform/remote/comfyui/history/fetchers/fetchHistoryV2.test.ts

@@ -0,0 +1,41 @@
+/**
+ * @fileoverview Unit tests for V2 history fetcher.
+ */
+import { describe, expect, it, vi } from 'vitest'
+
+import { fetchHistoryV2 } from '@/platform/remote/comfyui/history/fetchers/fetchHistoryV2'
+
+import {
+  expectedV1Fixture,
+  historyV2Fixture
+} from '@tests-ui/fixtures/historyFixtures'
+
+describe('fetchHistoryV2', () => {
+  const mockFetchApi = vi.fn().mockResolvedValue({
+    json: async () => historyV2Fixture
+  })
+
+  it('should fetch from /history_v2 endpoint with default max_items', async () => {
+    await fetchHistoryV2(mockFetchApi)
+
+    expect(mockFetchApi).toHaveBeenCalledWith('/history_v2?max_items=200')
+  })
+
+  it('should fetch with custom max_items parameter', async () => {
+    await fetchHistoryV2(mockFetchApi, 50)
+
+    expect(mockFetchApi).toHaveBeenCalledWith('/history_v2?max_items=50')
+  })
+
+  it('should adapt V2 response to V1-compatible format', async () => {
+    const result = await fetchHistoryV2(mockFetchApi)
+
+    expect(result.History).toEqual(expectedV1Fixture)
+    expect(result).toHaveProperty('History')
+    expect(Array.isArray(result.History)).toBe(true)
+    result.History.forEach((item) => {
+      expect(item.taskType).toBe('History')
+      expect(item.prompt).toHaveLength(5)
+    })
+  })
+})