The Open Standard for Generative UI
import {
lookupArtifactRendererByType,
useArtifactRendererRegistry,
useArtifactStorage,
useThreadList,
type Artifact,
type ArtifactRendererControls,
} from "@openuidev/react-headless";
import { ArrowLeft, MessageSquare } from "lucide-react";
import { useEffect, useMemo, useRef, useState } from "react";
import { Button } from "../Button";
import { IconButton } from "../IconButton";
import { artifactListPath } from "./_shared/artifactPaths";
import { useNav } from "./_shared/navContext";
import { MascotLoader } from "./components/MascotLoader";
/**
* Full-page artifact view (reserved path `artifacts/{category}/{id}`),
* rendered independent of any thread.
*
* Fetches the artifact via `ArtifactStorage.get`, resolves the renderer by
* `artifact.type`, runs the renderer's `parser` with
* `{ args: undefined, response: artifact.content }` (stored content must have
* the same shape as the tool-call response), and renders `actual` filling the
* page. No DetailedView involvement.
*
* `controls.close` navigates back to the category list; `open`/`toggle` are
* no-ops (the page IS the open state). `isStreaming` is always `false`.
*
* Internal — rendered by AgentInterface for the reserved `artifacts/` prefix.
*
* @internal
*/
export const ArtifactViewPage = ({
artifactId,
categoryName,
}: {
artifactId: string;
categoryName?: string;
}) => {
const storage = useArtifactStorage();
const registry = useArtifactRendererRegistry();
const { navigate } = useNav();
const selectThread = useThreadList((s) => s.selectThread);
const [artifact, setArtifact] = useState<Artifact | null>(null);
const [error, setError] = useState<Error | null>(null);
const requestIdRef = useRef(0);
useEffect(() => {
if (!storage) return;
const requestId = ++requestIdRef.current;
setArtifact(null);
setError(null);
storage
.get(artifactId)
.then((a) => {
if (requestId !== requestIdRef.current) return;
setArtifact(a);
})
.catch((e) => {
if (requestId !== requestIdRef.current) return;
setError(e instanceof Error ? e : new Error(String(e)));
});
}, [storage, artifactId]);
const backToList = () => navigate(artifactListPath(categoryName));
const goToThread = () => {
if (!artifact) return;
selectThread(artifact.threadId);
navigate(undefined);
};
const renderer = useMemo(() => {
if (!artifact || !registry) return null;
return lookupArtifactRendererByType(registry, artifact.type);
}, [artifact, registry]);
const parsed = useMemo(() => {
if (!artifact || !renderer) return null;
return renderer.parser({ args: undefined, response: artifact.content }, { isStreaming: false });
}, [artifact, renderer]);
const controls: ArtifactRendererControls = {
isActive: true,
isStreaming: false,
open: () => {},
close: backToList,
toggle: backToList,
};
let body: React.ReactNode;
if (!storage) {
body = null;
} else if (error) {
body = (
<div className="openui-agent-artifact-view__error">
Failed to load artifact: {error.message}
</div>
);
} else if (!artifact) {
body = (
<div className="openui-agent-artifact-view__loading">
<MascotLoader size={40} />
</div>
);
} else if (!renderer) {
body = (
<div className="openui-agent-artifact-view__error">
No renderer registered for artifact type "{artifact.type}".
</div>
);
} else if (!parsed) {
body = (
<div className="openui-agent-artifact-view__error">
The renderer could not parse this artifact's content.
</div>
);
} else {
body = renderer.actual(parsed.props, controls);
}
return (
<div className="openui-agent-artifact-view">
<div className="openui-agent-artifact-view__header">
<IconButton
variant="tertiary"
size="small"
icon={<ArrowLeft size="1em" />}
aria-label="Back"
onClick={backToList}
/>
<span className="openui-agent-artifact-view__title">{artifact?.title ?? ""}</span>
{artifact && (
<Button
variant="tertiary"
size="small"
iconLeft={<MessageSquare size={14} />}
onClick={goToThread}
>
Go to thread
</Button>
)}
</div>
<div className="openui-agent-artifact-view__content">{body}</div>
</div>
);
};