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 './portal-agent-experience.css'
import ReactMarkdown from 'react-markdown'
import remarkGfm from 'remark-gfm'
import rehypeHighlight from 'rehype-highlight'
import PortalInlineCitation from './PortalInlineCitation'
import {useMemo,useLayoutEffect} from 'react'
import {useResponseReveal} from '../lib/useResponseReveal'
import {EMBED_NOTES} from '../lib/embedDisplay'
import {DELIVERY_NOTES} from '../lib/portalDeliveryNotes'
import {parseDeliveredArtifacts} from '../lib/pixelDeliveredArtifacts'
import {suppressDeliveredMediaLines} from '../lib/deliveredMediaDisplay'
// Portal's own notes, each in a paragraph of its own (a reply of embeds it
// can't display, or its line about a preview after the reply), read as muted
// asides rather than as the model's words. Never an alert.
const NOTE_CLASSES=new Map([...EMBED_NOTES.map(note=>[note,'portal-embed-note']),
...DELIVERY_NOTES.map(note=>[note,'portal-delivery-note'])])
function mutePortalNotes() {
return tree=>{
function visit(node) {
for(const child of node.children || []) {
const text=child.tagName==='p' && child.children.length===1 && child.children[0]
const className=text?.type==='text' && NOTE_CLASSES.get(text.value)
if(className) child.properties={...child.properties,className:[className]}
else visit(child)
}
}
visit(tree)
}
}
// Fade newly revealed text nodes without replaying completed paragraphs.
function revealNewText() {
return tree=>{
function visit(node,insideCode=false) {
if(!node.children)return
const code=insideCode || ['pre','code'].includes(node.tagName)
node.children=node.children.flatMap(child=>{
if(child.type!=='text' || code){visit(child,code);return [child]}
const start=child.position?.start?.offset
if(!Number.isInteger(start))return [child]
return [{type:'element',tagName:'span',properties:{className:['portal-stream-reveal'],'data-stream-offset':start},children:[child]}]
})
}
visit(tree)
}
}
function StreamSpan({node,...props}) {return <span {...props}/>}
// ReactMarkdown passes renderers the URL after its normal security filtering.
// An invented attachment:// screenshot therefore has no usable source. Keep
// that absence visible without loading an empty URL or changing Markdown/code.
function PortalImage({renderer:Renderer='img',node,src,alt,...props}) {
if(!src) return <span className="portal-delivery-note">Image unavailable{alt ? `: ${alt}` : ''}</span>
return <Renderer {...props} {...(typeof Renderer==='string' ? {} : {node})} src={src} alt={alt}/>
}
const EMPTY_COMPONENTS={}
// Inspect Markdown structure before reveal wrappers are added. Download labels
// inside code or quoted examples are not delivery instructions. This marks only
// intent; the citation renderer still requires a unique completed file receipt.
function markDocumentDownloads() {
const text=node=>['pre','code','blockquote'].includes(node.tagName) ? '\0'
: node.type==='text' ? node.value
: node.tagName==='img' ? String(node.properties?.alt || '')
: (node.children || []).map(text).join('')
return tree=>{
function visit(node,downloadPrefix=false) {
if(['pre','code','blockquote'].includes(node.tagName))return
let before='',previous=null
for(const child of node.children || []) {
if(child.tagName==='a') {
const label=text(child).trim(), href=String(child.properties?.href || '')
const named=/^download(?:\s+(?:verified\s+)?([A-Za-z0-9][A-Za-z0-9._-]*\.[A-Za-z0-9]+))?\s*:?$/i.exec(label)
const explicitLabel=Boolean(named)
const prefixed=/(?:^|\n)\s*download(?:\s+link)?\s*:\s*$/i.test(before)
const filename=named?.[1] || (prefixed && /^([A-Za-z0-9][A-Za-z0-9._-]*\.[A-Za-z0-9]+)$/.exec(label)?.[1])
const rawLink=label===href || label===href.split('/').at(-1)
if(explicitLabel || filename || (rawLink && prefixed)) {
child.properties={...child.properties,'data-ods-download-intent':true}
if(filename)child.properties['data-ods-download-filename']=filename
// A document download label is text, even when the model wraps it
// in image syntax. Never load that label's invented remote image,
// including while the completed artifact receipt is still pending.
if(child.children?.length===1 && child.children[0].tagName==='img') {
child.children=[{type:'text',value:label}]
}
}
} else if(child.tagName==='img') {
const label=text(child).trim()
const named=/^download\s+(?:verified\s+)?(.+?)\s*:?$/i.exec(label)
const prefixed=/(?:^|\n)\s*download(?:\s+link)?\s*:\s*$/i.test(before) || (downloadPrefix && !before.trim())
const filename=named?.[1] || (prefixed ? label : '')
if(/^[A-Za-z0-9][A-Za-z0-9._-]*\.(?:md|markdown|txt|csv|tsv|json|pdf|zip|rar|docx|xlsx|pptx)$/i.test(filename)) {
// An image-shaped document label must not load the model's URL.
// The citation renderer binds only a unique completed receipt;
// without one, this remains plain text with no invented link.
child.tagName='a'
child.properties={'data-ods-download-intent':true,'data-ods-download-filename':filename}
child.children=[{type:'text',value:label}]
}
}
const nextPrefix=child.tagName==='p' && previous?.tagName==='p' && /^download(?:\s+link)?\s*:$/i.test(text(previous).trim())
visit(child,nextPrefix)
before+=text(child)
if(child.type!=='text' || child.value.trim())previous=child
}
}
visit(tree)
}
}
const PLUGINS=[rehypeHighlight,mutePortalNotes,markDocumentDownloads,revealNewText]
export default function PortalStreamingText({children, active=false, animate=active, instant=false, onReveal, components=EMPTY_COMPONENTS, artifacts=null}) {
const fullSource=String(children ?? '')
// Once a completed answer has verified files, show its complete Markdown.
// Revealing half of an image-wrapped link can otherwise turn the unfinished
// outer destination into a separate clickable GFM autolink beside the real
// download button. Ordinary prose and in-flight responses still animate.
const delivered=!active && Boolean(parseDeliveredArtifacts(artifacts)?.length)
const source=useResponseReveal(fullSource,{animate,instant:instant || delivered})
const revealing=source!==fullSource
const plugins=useMemo(()=>delivered && !revealing
? [rehypeHighlight,mutePortalNotes,markDocumentDownloads,[suppressDeliveredMediaLines,{source,artifacts}],revealNewText]
: PLUGINS,[delivered,revealing,source,artifacts])
useLayoutEffect(()=>{onReveal?.()},[source,onReveal])
const renderers=useMemo(()=>({...components,a:props=><PortalInlineCitation {...props} artifacts={artifacts}/>,
img:props=><PortalImage {...props} renderer={components.img}/>,span:StreamSpan}),[components,artifacts])
return <div className={`portal-streaming-text ${active || revealing?'is-streaming':''}`} aria-busy={active || revealing}>
<ReactMarkdown remarkPlugins={[remarkGfm]} rehypePlugins={plugins} components={renderers}>{source}</ReactMarkdown>
{(active || revealing) && <span className="portal-stream-cursor" aria-hidden="true"/>}
</div>
}