ODS V3 Pre-Release: Public testing and refinement ahead of the official V3 launch. Turn your PC, Mac, or Linux box into a private AI server.
Python ai-agentsamdcomfyuidockerllama-cppllmlocal-ain8nnvidiaopen-webuiragself-hostedspeech-to-textstrix-halotext-to-speechworkflow-automation
import {act,render,screen} from '@testing-library/react'
import PortalStreamingText from './PortalStreamingText'
import {EMBED_ONLY_NOTE} from '../lib/embedDisplay'
import {DELIVERY_NOTES} from '../lib/portalDeliveryNotes'
it.each([false,true])('shows the captured unavailable screenshot without losing the answer (active: %s)',active=>{
const source='Here is your packing checklist.\n\n\n\nUse the preview card above.'
const {container}=render(<PortalStreamingText active={active} instant>{source}</PortalStreamingText>)
expect(container).toHaveTextContent('Here is your packing checklist.')
expect(container).toHaveTextContent('Image unavailable: Packing Checklist')
expect(container).toHaveTextContent('Use the preview card above.')
expect(container.querySelector('img')).toBeNull()
})
it.each(['','![]()','![missing][shot]\n\n[shot]: attachment://missing.png'])('does not create an empty-source image: %s',source=>{
const {container}=render(<PortalStreamingText instant>{source}</PortalStreamingText>)
expect(container).toHaveTextContent('Image unavailable')
expect(container.querySelector('img')).toBeNull()
})
it('keeps supported image URLs, titles and custom rendering after URL filtering',()=>{
const Image=vi.fn(({node,...props})=><img {...props} data-custom-image="yes"/>)
const {container}=render(<PortalStreamingText instant components={{img:Image}}>{'\n\n\n\n'}</PortalStreamingText>)
const images=container.querySelectorAll('img')
expect(images).toHaveLength(2)
expect(images[0]).toHaveAttribute('src','https://example.com/chart.png')
expect(images[0]).toHaveAttribute('alt','Remote')
expect(images[0]).toHaveAttribute('title','Chart')
expect(images[1]).toHaveAttribute('src','./chart.png')
expect(images[1]).toHaveAttribute('data-custom-image','yes')
expect(container).toHaveTextContent('Image unavailable: Missing')
expect(Image.mock.calls.every(([props])=>Boolean(props.src))).toBe(true)
})
it('leaves image syntax in code examples literal',()=>{
const syntax=''
const {container}=render(<PortalStreamingText instant>{'`'+syntax+'`\n\n```text\n'+syntax+'\n```'}</PortalStreamingText>)
expect(container.querySelector('p code')).toHaveTextContent(syntax)
expect(container.querySelector('pre code')).toHaveTextContent(syntax)
expect(container.textContent).not.toContain('Image unavailable')
expect(container.querySelector('img')).toBeNull()
})
const mediaReceipt=(digit='a')=>({schemaVersion:1,kind:'ods-pixel-workspace-artifact',relativePath:'report.csv',
siteId:`site-${digit.repeat(24)}`,sha256:digit.repeat(64),file:{path:'report.csv',bytes:37,sha256:'c'.repeat(64)}})
it.each([
'MEDIA:report.csv',
'Created report.csv.\n\nMEDIA:report.csv\n\nSum: 225.',
'Created report.csv.\nMEDIA:report.csv\nSum: 225.',
'Created report.csv.\r\nMEDIA:report.csv\r\nSum: 225.',
'Created **report.csv**.\nMEDIA:report.csv\nSum: 225.',
'Created & verified.\nMEDIA:report.csv\nSum: 225.',
'**MEDIA:report.csv**', '__MEDIA:report.csv__',
'*MEDIA:report.csv*', '_MEDIA:report.csv_',
'***MEDIA:report.csv***', '___MEDIA:report.csv___',
'Created report.csv.\n**MEDIA:report.csv**\nSum: 225.',
])('hides a delivered MEDIA line while preserving the rest of the answer: %s',source=>{
const receipts=Object.freeze([Object.freeze(mediaReceipt())])
const before=JSON.stringify(receipts)
const {container}=render(<PortalStreamingText artifacts={receipts}>{source}</PortalStreamingText>)
expect(container.textContent).not.toContain('MEDIA:report.csv')
if(source.includes('Created')) expect(container).toHaveTextContent('Created')
if(source.includes('Sum:')) expect(container).toHaveTextContent('Sum: 225.')
expect(container.querySelector('a,img,button')).toBeNull()
expect(JSON.stringify(receipts)).toBe(before)
})
it.each([
'See MEDIA:report.csv for details.',
' MEDIA:report.csv', ' MEDIA:report.csv', ' MEDIA:report.csv', ' MEDIA:report.csv',
'> MEDIA:report.csv', '> Example:\nMEDIA:report.csv',
'- MEDIA:report.csv', '- Example:\nMEDIA:report.csv',
'`MEDIA:report.csv`', '`example\nMEDIA:report.csv\nend`',
'```text\nMEDIA:report.csv\n```', '~~~\nMEDIA:report.csv\n~~~',
'[MEDIA:report.csv](https://example.com/reference)',
'<div>\nMEDIA:report.csv\n</div>', '<span>\nMEDIA:report.csv\n</span>',
'MEDIA\\:report.csv', 'MEDIA:report.csv',
'MEDIA:report.csv extra', 'MEDIA:report.csv ', 'MEDIA:report.csv \nNext line',
'**MEDIA:report.csv** extra', 'See **MEDIA:report.csv** for details.',
'> **MEDIA:report.csv**', '- **MEDIA:report.csv**',
'`**MEDIA:report.csv**`', '**MEDIA\\:report.csv**', '**MEDIA:report.csv**',
'[**MEDIA:report.csv**](https://example.com/reference)',
])('preserves examples and non-directive Markdown: %s',source=>{
const {container}=render(<PortalStreamingText artifacts={[mediaReceipt()]}>{source}</PortalStreamingText>)
expect(container.textContent).toContain('MEDIA:report.csv')
})
it.each(['MEDIA:unknown.csv','MEDIA:../report.csv','MEDIA:https://example.com/report.csv','MEDIA: report.csv','media:report.csv'])('preserves an unmatched or malformed marker: %s',source=>{
const {container}=render(<PortalStreamingText artifacts={[mediaReceipt()]}>{source}</PortalStreamingText>)
expect(container).toHaveTextContent(source)
})
it.each([null,[],[{file:{path:'report.csv'}}],[{...mediaReceipt(),sha256:'invalid'}],[mediaReceipt(),mediaReceipt('b')]])('preserves a marker without a unique validated receipt: %j',artifacts=>{
const {container}=render(<PortalStreamingText artifacts={artifacts}>MEDIA:report.csv</PortalStreamingText>)
expect(container).toHaveTextContent('MEDIA:report.csv')
})
it('changes presentation only for a completed response with a valid receipt',()=>{
const source='Created.\n\nMEDIA:report.csv'
const artifacts=[mediaReceipt()]
const {container,rerender}=render(<PortalStreamingText active instant artifacts={artifacts}>{source}</PortalStreamingText>)
expect(container).toHaveTextContent('MEDIA:report.csv')
rerender(<PortalStreamingText artifacts={artifacts}>{source}</PortalStreamingText>)
expect(container.textContent).not.toContain('MEDIA:report.csv')
rerender(<PortalStreamingText active instant artifacts={artifacts}>{source}</PortalStreamingText>)
expect(container).toHaveTextContent('MEDIA:report.csv')
rerender(<PortalStreamingText artifacts={artifacts}>{source}</PortalStreamingText>)
expect(container.textContent).not.toContain('MEDIA:report.csv')
rerender(<PortalStreamingText artifacts={[{...mediaReceipt(),schemaVersion:2}]}>{source}</PortalStreamingText>)
expect(container).toHaveTextContent('MEDIA:report.csv')
})
it('renders the captured installed CSV reply without its emphasized transport line',()=>{
const name='fleet-main-f5e-cubes.csv'
const source='Perfect. The file has been verified and is ready for download.\n\n**Summary:**\n- Created `fleet-main-f5e-cubes.csv` with columns `n` and `cube` for integers 1 through 5\n- **Sum of the cube column:** 225 (1 + 8 + 27 + 64 + 125)\n- File is 37 bytes and ready for download\n\n**MEDIA:fleet-main-f5e-cubes.csv**'
const receipt=mediaReceipt()
const artifacts=[{...receipt,relativePath:name,file:{...receipt.file,path:name}}]
const {container,rerender}=render(<PortalStreamingText artifacts={artifacts}>{source}</PortalStreamingText>)
expect(container).toHaveTextContent('Sum of the cube column: 225')
expect(container).toHaveTextContent('File is 37 bytes and ready for download')
expect(container.textContent).not.toContain(`MEDIA:${name}`)
rerender(<PortalStreamingText artifacts={[]}>{source}</PortalStreamingText>)
expect(container).toHaveTextContent(`MEDIA:${name}`)
})
beforeEach(()=>{
vi.useFakeTimers()
vi.stubGlobal('matchMedia',()=>({matches:false,addEventListener:vi.fn(),removeEventListener:vi.fn()}))
})
afterEach(()=>{vi.useRealTimers();vi.unstubAllGlobals()})
const advance=ms=>act(()=>vi.advanceTimersByTime(ms))
it('keeps a verified download free of authored navigation throughout reveal',()=>{
const href='https://untrusted.example/api/download?siteId=invented'
const source=`[](${href})`
const artifact={schemaVersion:1,kind:'ods-pixel-workspace-artifact',relativePath:'report.md',
siteId:`site-${'a'.repeat(24)}`,sha256:'a'.repeat(64),file:{path:'report.md',bytes:20,sha256:'b'.repeat(64)}}
const {container}=render(<PortalStreamingText animate artifacts={[artifact]}>{source}</PortalStreamingText>)
for(let elapsed=0;elapsed<2000;elapsed+=16){
advance(16)
expect([...container.querySelectorAll('a')].filter(a=>new URL(a.href).hostname==='untrusted.example'),
`${elapsed}: ${container.innerHTML}`).toHaveLength(0)
}
expect(screen.getByRole('button',{name:'Download verified report.md'})).toBeInTheDocument()
})
it('finishes partially revealed Markdown atomically when its completed receipt arrives',()=>{
const href='https://untrusted.example/download'
const source=`[](${href})\n\n[Python docs](https://docs.python.org/3/)`
const artifact={schemaVersion:1,kind:'ods-pixel-workspace-artifact',relativePath:'report.md',
siteId:`site-${'a'.repeat(24)}`,sha256:'a'.repeat(64),file:{path:'report.md',bytes:20,sha256:'b'.repeat(64)}}
const {container,rerender}=render(<PortalStreamingText active>{source}</PortalStreamingText>)
advance(400)
expect(container.firstChild).toHaveAttribute('aria-busy','true')
expect(screen.queryByRole('button',{name:'Download verified report.md'})).toBeNull()
rerender(<PortalStreamingText animate artifacts={[artifact]}>{source}</PortalStreamingText>)
expect(container.firstChild).toHaveAttribute('aria-busy','false')
expect(screen.getByRole('button',{name:'Download verified report.md'})).toBeInTheDocument()
expect(screen.getAllByRole('link')).toHaveLength(1)
expect(screen.getByRole('link',{name:/Python docs/})).toHaveAttribute('href','https://docs.python.org/3/')
advance(2000)
expect(screen.getAllByRole('link')).toHaveLength(1)
})
it('reveals a final response received in one batch rather than displaying it instantly',()=>{
const text='Uma resposta completa recebida de uma vez, com conteúdo real e sem perder nenhuma palavra.'
const {container}=render(<PortalStreamingText animate>{text}</PortalStreamingText>)
expect(container.textContent).not.toBe(text)
advance(160)
expect(container.textContent.length).toBeGreaterThan(0)
expect(container.textContent.length).toBeLessThan(text.length)
advance(2000)
expect(container.textContent).toBe(text)
expect(container.firstChild).toHaveAttribute('aria-busy','false')
})
it('finishes revealing after transport completion and retains earlier DOM nodes',()=>{
const {container,rerender}=render(<PortalStreamingText active>Hello</PortalStreamingText>)
advance(160)
const first=container.querySelector('.portal-stream-reveal')
rerender(<PortalStreamingText active>{'Hello world 🙂'}</PortalStreamingText>)
advance(32)
rerender(<PortalStreamingText>{'Hello world 🙂'}</PortalStreamingText>)
advance(300)
expect(container.textContent).toBe('Hello world 🙂')
expect(container.querySelector('.portal-stream-reveal')).toBe(first)
expect(container.firstChild).toHaveAttribute('aria-busy','false')
})
it('does not replay stored answers and preserves complete Markdown code and links',()=>{
const {container}=render(<PortalStreamingText>{'Answer [source](https://example.com).\n\n```js\nconst n = 1;\n```'}</PortalStreamingText>)
expect(screen.getByRole('link')).toHaveAttribute('href','https://example.com')
expect(container.querySelector('code')).toHaveTextContent('const n = 1;')
expect(container.firstChild).toHaveAttribute('aria-busy','false')
})
it('shows the entire answer immediately with reduced motion and on stop',()=>{
vi.stubGlobal('matchMedia',()=>({matches:true,addEventListener:vi.fn(),removeEventListener:vi.fn()}))
const {container,rerender}=render(<PortalStreamingText active>Accessible complete text</PortalStreamingText>)
expect(container).toHaveTextContent('Accessible complete text')
rerender(<PortalStreamingText instant>Preserved partial response after stop</PortalStreamingText>)
expect(container).toHaveTextContent('Preserved partial response after stop')
})
it('catches up a long burst within a bounded interval and cancels frames on unmount',()=>{
const text='Long answer. '.repeat(1500).trimEnd()
const {container,unmount}=render(<PortalStreamingText animate>{text}</PortalStreamingText>)
advance(1600)
expect(container.textContent).toBe(text)
unmount()
expect(vi.getTimerCount()).toBe(0)
})
it('does not replay delivered prose when a publication receipt is stripped',()=>{
const {container,rerender}=render(<PortalStreamingText animate>{'The page is ready.\n\nPublished from your workspace.'}</PortalStreamingText>)
advance(1500)
const first=container.querySelector('.portal-stream-reveal')
rerender(<PortalStreamingText animate>The page is ready.</PortalStreamingText>)
expect(container.textContent).toBe('The page is ready.')
expect(container.querySelector('.portal-stream-reveal')).toBe(first)
expect(container.firstChild).toHaveAttribute('aria-busy','false')
})
it('mutes only paragraphs that are exactly a Portal note about an embed it cannot display',()=>{
const source=`Before\n\n${EMBED_ONLY_NOTE}\n\n- Item\n\n ${EMBED_ONLY_NOTE}\n\nThe model wrote ${EMBED_ONLY_NOTE} inline.\n\n\`\`\`\n${EMBED_ONLY_NOTE}\n\`\`\``
const {container}=render(<PortalStreamingText>{source}</PortalStreamingText>)
const muted=[...container.querySelectorAll('.portal-embed-note')].map(element=>[element.tagName,element.textContent])
expect(muted).toEqual([['P',EMBED_ONLY_NOTE],['P',EMBED_ONLY_NOTE]])
expect(screen.getByText('Before').closest('p')).not.toHaveClass('portal-embed-note')
expect(container.querySelector('pre code')).toHaveTextContent(EMBED_ONLY_NOTE)
})
// RTX Spark, 2026-10-25: a working preview was followed only by alarming
// check text. Portal's line after a reply is a muted paragraph of its own.
it.each(DELIVERY_NOTES)('mutes Portal\'s own line about a preview: %s',note=>{
const {container}=render(<PortalStreamingText>{`The arena draws again.\n\n${note}\n\nThe model wrote ${note} inline.`}</PortalStreamingText>)
const muted=[...container.querySelectorAll('.portal-delivery-note')]
expect(muted.map(element=>[element.tagName,element.textContent])).toEqual([['P',note]])
expect(screen.getByText('The arena draws again.').closest('p')).not.toHaveClass('portal-delivery-note')
expect(container.querySelector('[role="alert"]')).toBeNull()
expect(container.querySelector('svg')).toBeNull()
})
it('renders a document download image label as text before a receipt arrives',()=>{
const href='https://untrusted.example/api/download?siteId=invented'
const {container}=render(<PortalStreamingText active instant>{`[](${href})`}</PortalStreamingText>)
expect(screen.getByRole('link',{name:/Download report.csv/})).toHaveAttribute('href',href)
expect(container.querySelector('img')).toBeNull()
expect(screen.queryByRole('button',{name:/Download verified/})).toBeNull()
})
const documentName='fleet-pr7893-mac-squares.csv'
const deliveredDocument=(digit='a')=>({schemaVersion:1,kind:'ods-pixel-workspace-artifact',
relativePath:documentName,siteId:`site-${digit.repeat(24)}`,sha256:digit.repeat(64),
file:{path:documentName,bytes:149,sha256:digit.repeat(64)}})
const standaloneDocument=`**Download:**\n\n`
it('binds the captured Mac ZIP download-link reply while keeping its source citation',()=>{
const name='unicode-notes.zip'
const source=`Contents verified: café.txt and checklist.txt.\n\n**Download link:** [${name}](https://portal.openclaw.ai/s/site-ee6eff0984d1d85e58f1c6d9)\n\n[ZIP documentation](https://docs.python.org/3/library/zipfile.html)`
const artifact={...deliveredDocument(),relativePath:name,file:{...deliveredDocument().file,path:name}}
const {container}=render(<PortalStreamingText artifacts={[artifact]}>{source}</PortalStreamingText>)
expect(screen.getByRole('button',{name:`Download verified ${name}`})).toBeInTheDocument()
expect(container).toHaveTextContent('café.txt and checklist.txt')
expect(screen.getAllByRole('link')).toHaveLength(1)
expect(screen.getByRole('link',{name:/ZIP documentation/})).toHaveAttribute('href','https://docs.python.org/3/library/zipfile.html')
})
it.each([
`**Download link:** `,
`**Download link:**\n\n`,
])('binds a download-link image label only after its verified receipt: %s',source=>{
const {container,rerender}=render(<PortalStreamingText instant>{source}</PortalStreamingText>)
expect(container.querySelector('img,a[href]')).toBeNull()
expect(screen.queryByRole('button')).toBeNull()
rerender(<PortalStreamingText artifacts={[deliveredDocument()]}>{source}</PortalStreamingText>)
expect(screen.getByRole('button',{name:`Download verified ${documentName}`})).toBeInTheDocument()
rerender(<PortalStreamingText artifacts={[deliveredDocument(),deliveredDocument('b')]}>{source}</PortalStreamingText>)
expect(screen.queryByRole('button')).toBeNull()
expect(container.querySelector('img,a[href]')).toBeNull()
})
it('binds the actual standalone CSV image after its separate Download paragraph to a verified receipt',()=>{
const {container}=render(<PortalStreamingText artifacts={[deliveredDocument()]}>{standaloneDocument}</PortalStreamingText>)
expect(screen.getByRole('button',{name:`Download verified ${documentName}`})).toBeInTheDocument()
expect(container.querySelector('img')).toBeNull()
expect(container.querySelector('a[href]')).toBeNull()
})
it('keeps a standalone document label inert until its receipt arrives',()=>{
const {container,rerender}=render(<PortalStreamingText active instant>{standaloneDocument}</PortalStreamingText>)
expect(container.querySelector('img')).toBeNull()
expect(container.querySelector('a[href]')).toBeNull()
expect(screen.queryByRole('button')).toBeNull()
expect(container).toHaveTextContent(documentName)
rerender(<PortalStreamingText instant artifacts={[deliveredDocument()]}>{standaloneDocument}</PortalStreamingText>)
expect(screen.getByRole('button',{name:`Download verified ${documentName}`})).toBeInTheDocument()
})
it('does not guess between duplicate standalone document names',()=>{
const {container}=render(<PortalStreamingText artifacts={[deliveredDocument(),deliveredDocument('b')]}>{standaloneDocument}</PortalStreamingText>)
expect(screen.queryByRole('button')).toBeNull()
expect(container.querySelector('img,a[href]')).toBeNull()
})
it('uses only the receipt for an explicit standalone download image with a hostile source URL',()=>{
const {container}=render(<PortalStreamingText artifacts={[deliveredDocument()]}>{``}</PortalStreamingText>)
expect(screen.getByRole('button',{name:`Download verified ${documentName}`})).toBeInTheDocument()
expect(container.querySelector('img,a[href]')).toBeNull()
})
it('preserves ordinary images and does not carry a Download prefix across other prose',()=>{
const {container}=render(<PortalStreamingText artifacts={[deliveredDocument()]}>{`Download:\n\n\n\nDownload:\n\nAn example follows.\n\n`}</PortalStreamingText>)
expect(container.querySelectorAll('img')).toHaveLength(2)
expect(screen.queryByRole('button')).toBeNull()
})
it('preserves quoted and code examples of standalone document downloads',()=>{
const quoted=`> Download:\n>\n> `
const code='```md\n'+standaloneDocument+'\n```'
const {container}=render(<PortalStreamingText artifacts={[deliveredDocument()]}>{quoted+'\n\n'+code}</PortalStreamingText>)
expect(container.querySelector('blockquote img')).not.toBeNull()
expect(container.querySelector('pre code')).toHaveTextContent(documentName)
expect(screen.queryByRole('button')).toBeNull()
})