@opengeni/react 5.2.0-canary.0 → 6.0.0-canary.0

package/src/hooks/use-computer-frame-stream.ts

@@ -159,9 +159,19 @@ export function useComputerFrameStream(
       pendingFrame = null;
     };
 
+    const clearRecoveryTimers = () => {
+      if (reconnectTimer) clearTimeout(reconnectTimer);
+      if (expiryTimer) clearTimeout(expiryTimer);
+      reconnectTimer = null;
+      expiryTimer = null;
+    };
+
     const scheduleReconnect = () => {
       if (disposed || reconnectTimer) return;
-      if (failures >= MAX_AUTOMATIC_RECONNECTS_WITHOUT_A_FRAME) return;
+      if (failures >= MAX_AUTOMATIC_RECONNECTS_WITHOUT_A_FRAME) {
+        clearRecoveryTimers();
+        return;
+      }
       const delay = Math.min(5_000, 250 * 2 ** Math.min(failures, 5));
       failures += 1;
       setResult((current) => ({ ...current, state: "reconnecting" }));
@@ -177,6 +187,7 @@ export function useComputerFrameStream(
       setResult((current) => ({ ...current, state: "error", error }));
       clearSocket();
       if (reconnectAutomatically) scheduleReconnect();
+      else clearRecoveryTimers();
     };
 
     const onOpen = (source: ComputerFrameWebSocket) => {
@@ -295,8 +306,7 @@ export function useComputerFrameStream(
 
     const onClose = (source: ComputerFrameWebSocket) => {
       if (disposed || source !== socket) return;
-      clearSocket();
-      scheduleReconnect();
+      fail(new Error("Desktop view lost connection."));
     };
 
     const connectSocket = () => {
@@ -366,6 +376,9 @@ export function useComputerFrameStream(
           throw new Error("desktop attachment does not match the requested resource");
         }
         controllerGeneration = attachment.controllerGeneration;
+        // A fresh attachment owns a new producer whose sequence can restart.
+        // Transport reconnects reuse the attachment and retain their sequence fence.
+        latestRef.current = { key: "", sequence: -1 };
         activeAttachment = attachment;
         activeStream = attachment.stream;
         attachmentExpiresAt = Date.parse(attachment.expiresAt);
@@ -406,8 +419,7 @@ export function useComputerFrameStream(
       disposed = true;
       pendingFrame = null;
       attachmentAbort.abort();
-      if (reconnectTimer) clearTimeout(reconnectTimer);
-      if (expiryTimer) clearTimeout(expiryTimer);
+      clearRecoveryTimers();
       clearSocket(true);
     };
   }, [client, enabled, nonce, options.computerSessionId, options.targetId, workspaceId]);

package/src/hooks/use-file-attachments.ts

@@ -13,6 +13,8 @@ export type UseFileAttachmentsOptions = EmbeddedFileAttachmentClientOverride & {
    * UseFileAttachmentsResult.addFiles} (the explicit picker / drop path)
    * bypasses it.
    */
+  /** Retain original uploads in the chat owner’s personal scope when private. */
+  scope?: "workspace" | "personal";
   pasteFilter?: ((file: File) => boolean) | undefined;
 };
 
@@ -212,6 +214,7 @@ export function useFileAttachments(
           filename: file.name || "file",
           contentType: file.type || "application/octet-stream",
           data: file,
+          ...(options.scope ? { scope: options.scope } : {}),
         })
         .then((asset) => {
           if (scopeGeneration.current !== generation) return;
@@ -252,7 +255,7 @@ export function useFileAttachments(
           );
         });
     },
-    [client, workspaceId],
+    [client, workspaceId, options.scope],
   );
 
   const addFiles = useCallback(

package/src/hooks/use-goal.ts

@@ -138,7 +138,9 @@ export function useGoal(
       return;
     }
     if (sharedFeed) {
-      setLoading(false);
+      // A shared log supplies invalidations, not the authoritative goal snapshot.
+      setLoading(true);
+      void load();
       return () => {
         retireLoads();
       };

package/src/index.ts

@@ -617,3 +617,9 @@ export {
   tryParseJson,
 } from "./lib/format";
 export { SessionCommandsPanel } from "./components/session-commands-panel";
+
+export { KnowledgeActivityProvider } from "./timeline/knowledge-receipt";
+export type { KnowledgeActivityActions } from "./timeline/knowledge-receipt";
+
+export { StartupTimings } from "./timeline/startup-timings";
+export { setStartupDetails, useStartupDetails } from "./timeline/startup-preference";

package/src/session-ui.ts

@@ -46,6 +46,9 @@ export type {
   SessionChromeSignalTone,
 } from "./components/session-chrome";
 export { SessionCommandsPanel } from "./components/session-commands-panel";
+
+export { KnowledgeActivityProvider } from "./timeline/knowledge-receipt";
+export type { KnowledgeActivityActions } from "./timeline/knowledge-receipt";
 export { StartupTimings } from "./timeline/startup-timings";
 export { useStartupDetails, setStartupDetails } from "./timeline/startup-preference";
 export type { GenieLoadingOptions } from "./timeline/genie-loading";

package/src/timeline/activity-rail.tsx

@@ -1,3 +1,4 @@
+import { KnowledgeReceiptRow } from "./knowledge-receipt";
 import { AnimatePresence, motion, useReducedMotion } from "motion/react";
 import { GenieLoading } from "./genie-loading";
 import { useStartupDetails } from "./startup-preference";
@@ -241,7 +242,6 @@ export function renderActivity(
             t={toolDisplayName}
             b={BotIcon}
             m={Markdown}
-            r={truncate}
             j={rowJsx}
             s={rowJsxs}
           />
@@ -261,6 +261,16 @@ export function renderActivity(
     }
     case "worker":
       return <WorkerRow item={item} onOpenSession={onOpenSession} />;
+    case "knowledge":
+      return (
+        <KnowledgeReceiptRow
+          outcome={item.outcome}
+          entryId={item.entryId}
+          fileId={item.fileId}
+          title={item.filename}
+          source={Boolean(item.fileId)}
+        />
+      );
     case "memory":
       return <MemoryRow item={item} onMemoryClick={onMemoryClick} />;
     case "fleet-decision":

package/src/timeline/genie-loading.tsx

@@ -12,7 +12,15 @@ export type GenieLoadingOptions = {
   /** Replace the visual while preserving SDK loading visibility and transitions. */
   render?: (props: GenieLoadingRenderProps) => ReactNode;
   phrases?: readonly string[];
-  /** Public options stay independent of the renderer's declaration layout. */
+  /** Native copy overrides. Omitted messages retain the default English copy. */
+  messages?: {
+    status?: string;
+    slowStatus?: string;
+    slowText?: string;
+    showDetails?: string;
+    hideDetails?: string;
+  };
+  /** Public adapter options; the renderer dependency's declarations stay private. */
   orb?: {
     state?:
       | "working"
@@ -90,10 +98,14 @@ export function GenieLoading({
       </div>
       <div className="og-genie-copy">
         <span className="sr-only" role="status">
-          {slow ? "Preparing your task. Taking longer than usual." : "Preparing your task."}
+          {slow
+            ? (options?.messages?.slowStatus ?? "Preparing your task. Taking longer than usual.")
+            : (options?.messages?.status ?? "Preparing your task.")}
         </span>
         <span key={slow ? "slow" : phrase} className="og-genie-phrase" aria-hidden="true">
-          {slow ? "A little longer than usual…" : phrases[phrase % phrases.length]}
+          {slow
+            ? (options?.messages?.slowText ?? "A little longer than usual…")
+            : phrases[phrase % phrases.length]}
         </span>
         {showDetails || detailsOpen ? (
           <button
@@ -102,7 +114,9 @@ export function GenieLoading({
             aria-expanded={detailsOpen}
             onClick={onShowDetails}
           >
-            {detailsOpen ? "Hide details" : "Behind the magic"}
+            {detailsOpen
+              ? (options?.messages?.hideDetails ?? "Hide details")
+              : (options?.messages?.showDetails ?? "Behind the magic")}
             <span aria-hidden="true"> ↗</span>
           </button>
         ) : null}

package/src/timeline/index.ts

@@ -41,6 +41,7 @@ export type {
   MachineInputBatchItem,
   MachineInputMember,
   MemoryItem,
+  KnowledgeItem,
   NoticeItem,
   ReasoningItem,
   SandboxItem,
@@ -139,3 +140,6 @@ export {
   v4aToGitFileDiff,
 } from "./parsers";
 export type { ApplyPatchOperation } from "./parsers";
+
+export { KnowledgeActivityProvider } from "./knowledge-receipt";
+export type { KnowledgeActivityActions } from "./knowledge-receipt";

package/src/timeline/knowledge-receipt.tsx

@@ -0,0 +1,100 @@
+import { createContext, useContext, useState, type ReactNode } from "react";
+import { BrainCircuitIcon } from "lucide-react";
+import { ActivityDisclosure, BodyNote } from "./shared";
+
+export type KnowledgeActivityActions = {
+  onInspect?: ((entryId: string) => void) | undefined;
+  onRetryFile?: ((fileId: string) => Promise<boolean | void>) | undefined;
+  retryDisabled?: boolean | undefined;
+};
+const KnowledgeActions = createContext<KnowledgeActivityActions>({});
+export function KnowledgeActivityProvider({
+  children,
+  ...actions
+}: KnowledgeActivityActions & { children: ReactNode }) {
+  return <KnowledgeActions.Provider value={actions}>{children}</KnowledgeActions.Provider>;
+}
+
+/** A saved/pending result never opens or blocks the human-input surface. */
+export function KnowledgeReceiptRow(props: {
+  outcome: "published" | "pending" | "rejected" | "archived" | "failed";
+  entryId?: string | undefined;
+  fileId?: string | undefined;
+  title?: string | undefined;
+  source?: boolean | undefined;
+}) {
+  const actions = useContext(KnowledgeActions);
+  const [retrying, setRetrying] = useState(false);
+  const [retrySent, setRetrySent] = useState(false);
+  const [error, setError] = useState<string | null>(null);
+  const label =
+    props.outcome === "pending"
+      ? "Knowledge saved for review"
+      : props.outcome === "failed"
+        ? "Source preparation failed"
+        : props.outcome === "rejected"
+          ? "Source remains rejected"
+          : props.outcome === "archived"
+            ? "Knowledge archived"
+            : props.source
+              ? "Source saved to Knowledge"
+              : "Saved to Knowledge";
+  const actionClass =
+    "rounded-og-sm px-1 py-0.5 text-og-sm text-og-fg-muted hover:text-og-fg focus-visible:outline-2 focus-visible:outline-og-accent disabled:opacity-50";
+  return (
+    <ActivityDisclosure
+      icon={<BrainCircuitIcon className="size-3.5" />}
+      iconTone="muted"
+      title={label}
+      preview={props.title}
+    >
+      {props.outcome === "pending" ? (
+        <BodyNote>
+          Saved in Needs review. This task continues; future tasks can use it after approval.
+        </BodyNote>
+      ) : null}
+      {props.outcome === "failed" ? (
+        <BodyNote>
+          The original file remains attached. Searchable text has not been retained.
+        </BodyNote>
+      ) : null}
+      {props.outcome === "rejected" ? (
+        <BodyNote>Processing the file again leaves the review decision unchanged.</BodyNote>
+      ) : null}
+      {props.entryId && actions.onInspect ? (
+        <button
+          className={actionClass}
+          type="button"
+          onClick={() => actions.onInspect?.(props.entryId!)}
+        >
+          {props.outcome === "pending" ? "Review in Knowledge" : "View in Knowledge"}
+        </button>
+      ) : null}
+      {props.outcome === "failed" && props.fileId && actions.onRetryFile ? (
+        <button
+          className={actionClass}
+          type="button"
+          disabled={retrying || retrySent || actions.retryDisabled}
+          onClick={() => {
+            setRetrying(true);
+            setError(null);
+            void actions.onRetryFile!(props.fileId!)
+              .then((sent) => {
+                if (sent !== false) setRetrySent(true);
+                else setError("Could not start the retry. Try again when the chat is ready.");
+              })
+              .catch(() => setError("Could not start the retry. Please try again."))
+              .finally(() => setRetrying(false));
+          }}
+        >
+          {retrying ? "Starting retry…" : retrySent ? "Retry requested" : "Retry preparation"}
+        </button>
+      ) : null}
+      {error ? (
+        <p role="alert" className="text-og-sm">
+          {error}
+        </p>
+      ) : null}
+    </ActivityDisclosure>
+  );
+}

package/src/timeline/platform-activity-row.tsx

@@ -19,7 +19,6 @@ export default function PlatformActivityRow({
   t: (name: string) => string;
   b: typeof import("lucide-react").BotIcon;
   m: typeof import("../components/markdown").Markdown;
-  r: typeof import("../lib/format").truncate;
   j: RowJsx;
   s: RowJsxs;
 }) {

package/src/timeline/projection.ts

@@ -1175,6 +1175,45 @@ export function buildTimeline(events: SessionEvent[]): TimelineItem[] {
         break;
       }
 
+      case "instruction.confirmation.recovered": {
+        const receipt = asRecord(payload.receipt);
+        if (receipt.outcome !== "published") break;
+        closeStreamingTail();
+        items.push({
+          kind: "notice",
+          id: event.id,
+          tone: "input",
+          text: "Your previously approved workspace instruction was saved.",
+          occurredAt: event.occurredAt,
+        });
+        break;
+      }
+      case "knowledge.confirmation.recovered":
+      case "knowledge.source.prepared":
+      case "knowledge.source.failed": {
+        const receipt = asRecord(payload.receipt);
+        const outcome = event.type === "knowledge.source.failed" ? "failed" : receipt.outcome;
+        if (
+          (event.type !== "knowledge.confirmation.recovered" &&
+            typeof payload.fileId !== "string") ||
+          !["published", "pending", "rejected", "archived", "failed"].includes(String(outcome))
+        )
+          break;
+        closeStreamingTail();
+        items.push({
+          kind: "knowledge",
+          id: event.id,
+          turnId,
+          fileId: typeof payload.fileId === "string" ? payload.fileId : undefined,
+          filename: typeof payload.filename === "string" ? payload.filename : undefined,
+          entryId: typeof receipt.entryId === "string" ? receipt.entryId : undefined,
+          status: outcome === "failed" ? "failed" : "complete",
+          outcome: outcome as "published" | "pending" | "rejected" | "archived" | "failed",
+          occurredAt: event.occurredAt,
+        });
+        break;
+      }
+
       case "memory.saved":
       case "memory.corrected": {
         // A first-party memory write is a discrete step, not streamed text, so it
@@ -1517,6 +1556,7 @@ function isActivityItem(item: TimelineItem): item is ActivityItem {
     case "sandbox":
     case "startup-phase":
     case "memory":
+    case "knowledge":
     case "fleet-decision":
       return true;
     default:

package/src/timeline/retained-image.ts

@@ -7,6 +7,18 @@ type RetainedImageState =
   | { kind: "unavailable"; label: string }
   | { kind: "error"; message: string };
 
+/** Shared browser preview allowlist; other published files remain downloads. */
+export function isRetainedImageContentType(contentType: string): boolean {
+  return [
+    "image/png",
+    "image/jpeg",
+    "image/gif",
+    "image/webp",
+    "image/avif",
+    "image/svg+xml",
+  ].includes(contentType);
+}
+
 export function useRetainedImageObjectUrl(
   artifact: RetainedArtifactReference,
   load: ToolRendererProps["loadRetainedArtifact"],

package/src/timeline/tool-renderers.tsx

@@ -1,4 +1,5 @@
-import { useRetainedImageObjectUrl } from "./retained-image";
+import { KnowledgeReceiptRow } from "./knowledge-receipt";
+import { isRetainedImageContentType, useRetainedImageObjectUrl } from "./retained-image";
 import {
   parseSandboxFileArtifactReceipt,
   type GitFileDiff,
@@ -782,9 +783,12 @@ function RetainedSessionImageDisclosure({
   batched,
   failed,
   cancelled,
+  filename,
+  defaultOpen,
+  children,
 }: {
   artifact: RetainedArtifactReference;
-  load: ToolRendererProps["loadRetainedScreenshot"];
+  load: ToolRendererProps["loadRetainedArtifact"];
   title: string;
   caption: string;
   noun: "image" | "screenshot";
@@ -793,15 +797,19 @@ function RetainedSessionImageDisclosure({
   batched: string | null;
   failed: boolean;
   cancelled: boolean;
+  filename?: string;
+  defaultOpen?: boolean;
+  children?: ReactNode;
 }) {
   const state = useRetainedImageObjectUrl(artifact, load);
-  const downloadFilename = retainedImageFilename(artifact);
+  const downloadFilename = filename ?? retainedImageFilename(artifact);
 
   return (
     <ActivityDisclosure
       icon={icon}
       iconTone={failed ? "failed" : state.kind === "ready" ? "accent" : "muted"}
       title={title}
+      defaultOpen={defaultOpen}
       failed={failed}
       cancelled={cancelled}
       preview={
@@ -851,6 +859,7 @@ function RetainedSessionImageDisclosure({
         </BodyNote>
       )}
       {batched ? <BodyNote>batched: {batched}</BodyNote> : null}
+      {children}
     </ActivityDisclosure>
   );
 }
@@ -944,6 +953,22 @@ function SandboxFilePublishRenderer({ item, loadRetainedArtifact }: ToolRenderer
     return <GenericRenderer item={item} />;
   }
 
+  // The closed SDK receipt has already checked the workspace-qualified route.
+  const workspaceId = /^\/v1\/workspaces\/([0-9a-f-]+)\/artifacts\//.exec(
+    receipt.artifact.retrieval.path,
+  )?.[1];
+  const openLink = workspaceId ? (
+    <a
+      href={`/workspaces/${workspaceId}/artifacts/files/${receipt.artifact.artifactId}`}
+      aria-label={`Open ${receipt.filename} in Artifacts`}
+      className="inline-flex min-h-7 items-center rounded-og-sm px-2 text-og-sm font-medium text-og-accent-strong hover:bg-og-surface-2 hover:underline focus-visible:outline-hidden focus-visible:ring-2 focus-visible:ring-og-accent pointer-coarse:min-h-10"
+      onClick={(event) => event.stopPropagation()}
+      onKeyDown={(event) => event.stopPropagation()}
+    >
+      Open in Artifacts
+    </a>
+  ) : null;
+
   const download = async () => {
     if (!loadRetainedArtifact) {
       setDownloadState("error");
@@ -976,6 +1001,44 @@ function SandboxFilePublishRenderer({ item, loadRetainedArtifact }: ToolRenderer
     }
   };
 
+  const downloadButton = (
+    <button
+      type="button"
+      onClick={() => void download()}
+      disabled={downloadState === "loading"}
+      className="inline-flex items-center gap-1.5 rounded-og-sm border border-og-border px-2.5 py-1.5 text-og-sm font-medium text-og-fg transition-colors hover:border-og-border-strong hover:bg-og-surface-2 disabled:cursor-wait disabled:opacity-60"
+    >
+      <DownloadIcon className="size-3.5" />
+      {downloadState === "loading"
+        ? "Preparing…"
+        : downloadState === "error"
+          ? "Retry download"
+          : "Download"}
+    </button>
+  );
+
+  if (isRetainedImageContentType(receipt.artifact.contentType)) {
+    return (
+      <RetainedSessionImageDisclosure
+        artifact={receipt.artifact}
+        load={loadRetainedArtifact}
+        title={`Published ${receipt.filename}`}
+        caption={receipt.filename}
+        noun="image"
+        icon={<ImageIcon className={ICON_SIZE} />}
+        lightboxLabel="Image"
+        batched={null}
+        failed={false}
+        cancelled={false}
+        filename={receipt.filename}
+        defaultOpen
+      >
+        {downloadButton}
+        {openLink}
+      </RetainedSessionImageDisclosure>
+    );
+  }
+
   return (
     <ActivityDisclosure
       icon={<DownloadIcon className={ICON_SIZE} />}
@@ -984,19 +1047,8 @@ function SandboxFilePublishRenderer({ item, loadRetainedArtifact }: ToolRenderer
       defaultOpen
       preview={formatBytes(receipt.artifact.originalBytes)}
     >
-      <button
-        type="button"
-        onClick={() => void download()}
-        disabled={downloadState === "loading"}
-        className="inline-flex items-center gap-1.5 rounded-og-sm border border-og-border px-2.5 py-1.5 text-og-sm font-medium text-og-fg transition-colors hover:border-og-border-strong hover:bg-og-surface-2 disabled:cursor-wait disabled:opacity-60"
-      >
-        <DownloadIcon className="size-3.5" />
-        {downloadState === "loading"
-          ? "Preparing…"
-          : downloadState === "error"
-            ? "Retry download"
-            : "Download"}
-      </button>
+      {downloadButton}
+      {openLink}
     </ActivityDisclosure>
   );
 }
@@ -2286,7 +2338,54 @@ function GenericToolIcon({ name }: { name: string }) {
 
 /* ---- the default registry -------------------------------------------------- */
 
+function KnowledgeSaveRenderer({ item }: ToolRendererProps) {
+  const output = unwrapMcpOutput(item.output);
+  const parsed = tryParseJson(output.text);
+  if (item.status === "running" || output.isError || !parsed || typeof parsed !== "object")
+    return <GenericRenderer item={item} />;
+  const value = parsed as Record<string, unknown>;
+  const receipt = (value.status === "retained" ? value.receipt : value) as
+    | Record<string, unknown>
+    | undefined;
+  if (
+    !receipt ||
+    typeof receipt.entryId !== "string" ||
+    !["published", "pending", "rejected", "archived"].includes(String(receipt.outcome))
+  )
+    return <GenericRenderer item={item} />;
+  const args = parseToolArgs(item.arguments);
+  const entry = args.entry as Record<string, unknown> | undefined;
+  return (
+    <KnowledgeReceiptRow
+      outcome={receipt.outcome as "published" | "pending" | "rejected" | "archived"}
+      entryId={receipt.entryId}
+      title={
+        typeof entry?.title === "string"
+          ? entry.title
+          : typeof value.filename === "string"
+            ? value.filename
+            : undefined
+      }
+      source={value.status === "retained" || value.retained === true}
+    />
+  );
+}
+
 const BASE_ENTRIES: ToolRegistryEntry[] = [
+  ...[
+    "knowledge_save",
+    "knowledge_archive",
+    "knowledge_retain_file",
+    "knowledge_retain_message",
+    "task_note_promote_knowledge",
+  ].flatMap((name) =>
+    [name, `opengeni__${name}`, `mcp__opengeni__${name}`].map((trustedName) => ({
+      match: "name" as const,
+      name: trustedName,
+      matchPrefixedLeaf: false,
+      render: KnowledgeSaveRenderer,
+    })),
+  ),
   // Provider-native items carry `raw.type` on the wire — this is their source of
   // truth and is consulted first by the registry.
   { match: "rawType", type: "apply_patch_call", render: ApplyPatchRenderer },

package/src/timeline/types.ts

@@ -228,6 +228,18 @@ export type StartupPhaseItem = {
  * `onMemoryClick` handler the row also deep-links to the record in its memory
  * pane; without one it is non-interactive rich content.
  */
+export type KnowledgeItem = {
+  kind: "knowledge";
+  id: string;
+  turnId: string | null;
+  status: "complete" | "failed";
+  outcome: "published" | "pending" | "rejected" | "archived" | "failed";
+  fileId?: string | undefined;
+  filename?: string | undefined;
+  entryId?: string | undefined;
+  occurredAt: string;
+};
+
 export type MemoryItem = {
   kind: "memory";
   id: string;
@@ -478,6 +490,7 @@ export type TimelineItem =
   | MachineInputBatchItem
   | AuthNeededItem
   | MemoryItem
+  | KnowledgeItem
   | FleetDecisionItem
   | TurnEndItem;
 
@@ -489,6 +502,7 @@ export type ActivityItem =
   | SandboxItem
   | StartupPhaseItem
   | MemoryItem
+  | KnowledgeItem
   | FleetDecisionItem;
 
 export type TimelineGroup =

package/dist/chunk-2TKI3WEG.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/timeline/retained-image.ts"],"sourcesContent":["import { useEffect, useRef, useState } from \"react\";\nimport type { RetainedArtifactReference } from \"@opengeni/sdk\";\nimport type { ToolRendererProps } from \"./registry\";\ntype RetainedImageState =\n  | { kind: \"loading\" }\n  | { kind: \"ready\"; url: string }\n  | { kind: \"unavailable\"; label: string }\n  | { kind: \"error\"; message: string };\n\nexport function useRetainedImageObjectUrl(\n  artifact: RetainedArtifactReference,\n  load: ToolRendererProps[\"loadRetainedArtifact\"],\n): RetainedImageState {\n  const [state, setState] = useState<RetainedImageState>({ kind: \"loading\" });\n  // Function outputs are commonly serialized JSON. Parsing them creates a new\n  // object on every render, so depend on the immutable wire value rather than\n  // object identity; otherwise the loader can refetch after its own setState.\n  const artifactValue = retainedArtifactValue(artifact);\n  const stableArtifactRef = useRef({ value: artifactValue, artifact });\n  if (stableArtifactRef.current.value !== artifactValue) {\n    stableArtifactRef.current = { value: artifactValue, artifact };\n  }\n  const stableArtifact = stableArtifactRef.current.artifact;\n  useEffect(() => {\n    if (!load) {\n      setState({ kind: \"unavailable\", label: \"retrieval is not configured\" });\n      return;\n    }\n    const controller = new AbortController();\n    let objectUrl: string | null = null;\n    setState({ kind: \"loading\" });\n    void load(stableArtifact, controller.signal)\n      .then((source) => {\n        if (controller.signal.aborted) return;\n        if (!source) {\n          setState({ kind: \"unavailable\", label: \"bytes are unavailable\" });\n          return;\n        }\n        if (!(source instanceof Uint8Array)) {\n          if (!source.url.trim()) {\n            setState({ kind: \"unavailable\", label: \"URL is unavailable\" });\n            return;\n          }\n          setState({ kind: \"ready\", url: source.url });\n          return;\n        }\n        objectUrl = URL.createObjectURL(\n          new Blob([source as unknown as BlobPart], { type: stableArtifact.contentType }),\n        );\n        setState({ kind: \"ready\", url: objectUrl });\n      })\n      .catch((error: unknown) => {\n        if (controller.signal.aborted) return;\n        const status =\n          error && typeof error === \"object\" && \"status\" in error\n            ? Number((error as { status?: unknown }).status)\n            : null;\n        setState(\n          status === 404\n            ? { kind: \"unavailable\", label: \"deleted\" }\n            : status === 410\n              ? { kind: \"unavailable\", label: \"expired or unavailable\" }\n              : { kind: \"error\", message: \"retrieval failed\" },\n        );\n      });\n    return () => {\n      controller.abort();\n      if (objectUrl) URL.revokeObjectURL(objectUrl);\n    };\n  }, [stableArtifact, load]);\n  return state;\n}\n\nfunction retainedArtifactValue(artifact: RetainedArtifactReference): string {\n  return [\n    artifact.artifactId,\n    artifact.kind,\n    artifact.contentType,\n    artifact.originalBytes,\n    artifact.sha256,\n    artifact.retainedAt,\n    artifact.dimensions?.width ?? \"\",\n    artifact.dimensions?.height ?? \"\",\n    artifact.retention.policy,\n    artifact.retention.expiresAt ?? \"\",\n    artifact.retrieval.method,\n    artifact.retrieval.path,\n    artifact.retrieval.acceptRanges,\n    artifact.retrieval.maxRangeBytes,\n  ].join(\"\\0\");\n}\n"],"mappings":";AAAA,SAAS,WAAW,QAAQ,gBAAgB;AASrC,SAAS,0BACd,UACA,MACoB;AACpB,QAAM,CAAC,OAAO,QAAQ,IAAI,SAA6B,EAAE,MAAM,UAAU,CAAC;AAI1E,QAAM,gBAAgB,sBAAsB,QAAQ;AACpD,QAAM,oBAAoB,OAAO,EAAE,OAAO,eAAe,SAAS,CAAC;AACnE,MAAI,kBAAkB,QAAQ,UAAU,eAAe;AACrD,sBAAkB,UAAU,EAAE,OAAO,eAAe,SAAS;AAAA,EAC/D;AACA,QAAM,iBAAiB,kBAAkB,QAAQ;AACjD,YAAU,MAAM;AACd,QAAI,CAAC,MAAM;AACT,eAAS,EAAE,MAAM,eAAe,OAAO,8BAA8B,CAAC;AACtE;AAAA,IACF;AACA,UAAM,aAAa,IAAI,gBAAgB;AACvC,QAAI,YAA2B;AAC/B,aAAS,EAAE,MAAM,UAAU,CAAC;AAC5B,SAAK,KAAK,gBAAgB,WAAW,MAAM,EACxC,KAAK,CAAC,WAAW;AAChB,UAAI,WAAW,OAAO,QAAS;AAC/B,UAAI,CAAC,QAAQ;AACX,iBAAS,EAAE,MAAM,eAAe,OAAO,wBAAwB,CAAC;AAChE;AAAA,MACF;AACA,UAAI,EAAE,kBAAkB,aAAa;AACnC,YAAI,CAAC,OAAO,IAAI,KAAK,GAAG;AACtB,mBAAS,EAAE,MAAM,eAAe,OAAO,qBAAqB,CAAC;AAC7D;AAAA,QACF;AACA,iBAAS,EAAE,MAAM,SAAS,KAAK,OAAO,IAAI,CAAC;AAC3C;AAAA,MACF;AACA,kBAAY,IAAI;AAAA,QACd,IAAI,KAAK,CAAC,MAA6B,GAAG,EAAE,MAAM,eAAe,YAAY,CAAC;AAAA,MAChF;AACA,eAAS,EAAE,MAAM,SAAS,KAAK,UAAU,CAAC;AAAA,IAC5C,CAAC,EACA,MAAM,CAAC,UAAmB;AACzB,UAAI,WAAW,OAAO,QAAS;AAC/B,YAAM,SACJ,SAAS,OAAO,UAAU,YAAY,YAAY,QAC9C,OAAQ,MAA+B,MAAM,IAC7C;AACN;AAAA,QACE,WAAW,MACP,EAAE,MAAM,eAAe,OAAO,UAAU,IACxC,WAAW,MACT,EAAE,MAAM,eAAe,OAAO,yBAAyB,IACvD,EAAE,MAAM,SAAS,SAAS,mBAAmB;AAAA,MACrD;AAAA,IACF,CAAC;AACH,WAAO,MAAM;AACX,iBAAW,MAAM;AACjB,UAAI,UAAW,KAAI,gBAAgB,SAAS;AAAA,IAC9C;AAAA,EACF,GAAG,CAAC,gBAAgB,IAAI,CAAC;AACzB,SAAO;AACT;AAEA,SAAS,sBAAsB,UAA6C;AAC1E,SAAO;AAAA,IACL,SAAS;AAAA,IACT,SAAS;AAAA,IACT,SAAS;AAAA,IACT,SAAS;AAAA,IACT,SAAS;AAAA,IACT,SAAS;AAAA,IACT,SAAS,YAAY,SAAS;AAAA,IAC9B,SAAS,YAAY,UAAU;AAAA,IAC/B,SAAS,UAAU;AAAA,IACnB,SAAS,UAAU,aAAa;AAAA,IAChC,SAAS,UAAU;AAAA,IACnB,SAAS,UAAU;AAAA,IACnB,SAAS,UAAU;AAAA,IACnB,SAAS,UAAU;AAAA,EACrB,EAAE,KAAK,IAAI;AACb;","names":[]}