@opengeni/react 0.57.0 → 2.2.0-canary.0

package/src/components/markdown.tsx

@@ -3,13 +3,18 @@ import {
   isValidElement,
   memo,
   useEffect,
+  useMemo,
   useReducer,
   useRef,
   useState,
   type ComponentPropsWithoutRef,
   type ReactNode,
 } from "react";
-import ReactMarkdown, { type Components } from "react-markdown";
+import ReactMarkdown, {
+  defaultUrlTransform,
+  type Components,
+  type UrlTransform,
+} from "react-markdown";
 import remarkGfm from "remark-gfm";
 import { cn } from "../lib/cn";
 import { tableElementToTsv } from "../lib/clipboard";
@@ -46,11 +51,22 @@ export type MarkdownProps = {
    * transition — that blinked the whole document).
    */
   streaming?: boolean | undefined;
+  /**
+   * Open a session-local file link in the host's Files surface. The path is the
+   * exact decoded `sandbox:` payload; `line`, when present, is 1-based.
+   */
+  onSandboxFile?: ((path: string, line?: number) => void | Promise<void>) | undefined;
+};
+
+/** Exact target path plus optional 1-based line from a markdown href. */
+export type SandboxFileLocation = {
+  path: string;
+  line: number | null;
 };
 
 /* --- element renderers (themed to og-* tokens) ------------------------------ */
 
-const components: Components = {
+const baseComponents: Components = {
   h1: ({ children, ...props }) => (
     <h1
       className="mt-5 mb-2.5 text-xl font-semibold tracking-tight text-og-fg first:mt-0"
@@ -95,16 +111,6 @@ const components: Components = {
       {children}
     </em>
   ),
-  a: ({ children, ...props }) => (
-    <a
-      className="break-words font-medium text-og-accent-strong underline-offset-2 hover:underline"
-      target="_blank"
-      rel="noreferrer noopener"
-      {...props}
-    >
-      {children}
-    </a>
-  ),
   ul: ({ children, ...props }) => (
     <ul
       className="my-2.5 ml-5 flex list-disc flex-col gap-1 marker:text-og-fg-subtle first:mt-0 last:mb-0"
@@ -184,15 +190,161 @@ const components: Components = {
       {children}
     </td>
   ),
-  img: ({ alt, ...props }) => (
-    <img
-      alt={alt ?? ""}
-      className="my-3 max-w-full rounded-og-md border border-og-border"
-      {...props}
-    />
-  ),
+  img: ({ alt, src, ...props }) =>
+    src ? (
+      <img
+        alt={alt ?? ""}
+        src={src}
+        className="my-3 max-w-full rounded-og-md border border-og-border"
+        {...props}
+      />
+    ) : alt ? (
+      <span className="text-og-fg-subtle" aria-disabled="true">
+        {alt}
+      </span>
+    ) : null,
 };
 
+const MARKDOWN_LINK_CLASS =
+  "break-words font-medium text-og-accent-strong underline-offset-2 hover:underline";
+
+function markdownComponents(onSandboxFile: MarkdownProps["onSandboxFile"]): Components {
+  return {
+    ...baseComponents,
+    a: ({ children, href, ...props }) => {
+      const location = sandboxFileLocationFromHref(href);
+      if (location !== null) {
+        return (
+          <SandboxMarkdownLink location={location} onSandboxFile={onSandboxFile}>
+            {children}
+          </SandboxMarkdownLink>
+        );
+      }
+      if (isSandboxHref(href) || !href) {
+        return (
+          <span
+            className="break-words font-medium text-og-fg-subtle underline decoration-dotted underline-offset-2"
+            aria-disabled="true"
+            title={
+              isSandboxHref(href)
+                ? "This sandbox file reference is invalid"
+                : "This link is unavailable"
+            }
+          >
+            {children}
+          </span>
+        );
+      }
+      return (
+        <a
+          className={MARKDOWN_LINK_CLASS}
+          target="_blank"
+          rel="noreferrer noopener"
+          href={href}
+          {...props}
+        >
+          {children}
+        </a>
+      );
+    },
+  };
+}
+
+function SandboxMarkdownLink({
+  location,
+  onSandboxFile,
+  children,
+}: {
+  location: SandboxFileLocation;
+  onSandboxFile: MarkdownProps["onSandboxFile"];
+  children: ReactNode;
+}) {
+  const [state, setState] = useState<"idle" | "loading" | "error">("idle");
+  const { path, line } = location;
+  if (!onSandboxFile) {
+    return (
+      <span
+        className="break-words font-medium text-og-fg-subtle underline decoration-dotted underline-offset-2"
+        aria-disabled="true"
+        title="This sandbox file requires a session-aware handler"
+      >
+        {children}
+      </span>
+    );
+  }
+  const idleTitle = line !== null ? `Open ${path} at line ${line}` : `Open ${path}`;
+  return (
+    <button
+      type="button"
+      className={cn(
+        MARKDOWN_LINK_CLASS,
+        "inline-flex min-h-7 cursor-pointer items-center disabled:cursor-wait disabled:opacity-70 pointer-coarse:min-h-11",
+      )}
+      disabled={state === "loading"}
+      aria-busy={state === "loading"}
+      title={state === "error" ? "Couldn't open this file. Select to retry." : idleTitle}
+      onClick={() => {
+        setState("loading");
+        void Promise.resolve(onSandboxFile(path, line ?? undefined)).then(
+          () => setState("idle"),
+          () => setState("error"),
+        );
+      }}
+    >
+      {children}
+      {state === "loading" ? " (opening…)" : state === "error" ? " (retry)" : null}
+    </button>
+  );
+}
+
+const SANDBOX_SCHEME = "sandbox:";
+const LEGACY_WORKSPACE_PREFIX = "/workspace/";
+const TRAILING_LINE = /:([0-9]+)$/u;
+const TRAILING_INVALID_LINE = /:-(?:[0-9]+)$|:[0-9]+-[0-9]+$/u;
+const CONTROL_CHARACTER = /[\u0000-\u001f\u007f]/u;
+
+function isSandboxHref(href: string | undefined): boolean {
+  return href?.startsWith(SANDBOX_SCHEME) ?? false;
+}
+
+/**
+ * Parse an OpenGeni `sandbox:` application href (plus the historical bare
+ * `/workspace/...` form). The decoded path is intentionally opaque here:
+ * target selection, path policy, and filesystem authority belong to the
+ * session-aware host and its FileSystem boundary.
+ */
+export function sandboxFileLocationFromHref(href: string | undefined): SandboxFileLocation | null {
+  if (!href) return null;
+  const encodedLocation = isSandboxHref(href)
+    ? href.slice(SANDBOX_SCHEME.length)
+    : href.startsWith(LEGACY_WORKSPACE_PREFIX)
+      ? href
+      : null;
+  if (!encodedLocation || encodedLocation.includes("?") || encodedLocation.includes("#")) {
+    return null;
+  }
+  if (TRAILING_INVALID_LINE.test(encodedLocation)) return null;
+  const lineMatch = TRAILING_LINE.exec(encodedLocation);
+  const encodedPath = lineMatch ? encodedLocation.slice(0, -lineMatch[0].length) : encodedLocation;
+  const line = lineMatch?.[1] ? Number(lineMatch[1]) : null;
+  if (line !== null && (!Number.isSafeInteger(line) || line < 1)) return null;
+  if (!encodedPath) return null;
+  try {
+    const path = decodeURIComponent(encodedPath);
+    return path && !CONTROL_CHARACTER.test(path) ? { path, line } : null;
+  } catch {
+    return null;
+  }
+}
+
+/** Return the exact decoded path for a supported sandbox-link href. */
+export function sandboxFilePathFromHref(href: string | undefined): string | null {
+  return sandboxFileLocationFromHref(href)?.path ?? null;
+}
+
+const markdownUrlTransform: UrlTransform = (url, key, node) =>
+  key === "href" && node.tagName === "a" && isSandboxHref(url) ? url : defaultUrlTransform(url);
+
 /** How long after the stream ends the reveal pipeline stays for trailing animations. */
 /** Trailing ink window after stream end — keep ≥ {@link INK_FADE_MS}. */
 const REVEAL_LINGER_MS = 480 * MOTION_INSPECT_SCALE;
@@ -284,7 +436,7 @@ function MarkdownTable({ children, className, ...props }: ComponentPropsWithoutR
   );
 }
 
-function MarkdownImpl({ children, className, streaming = false }: MarkdownProps) {
+function MarkdownImpl({ children, className, streaming = false, onSandboxFile }: MarkdownProps) {
   // Tip-ink engine for THIS body: created on the first streaming render, kept
   // through a short linger after the stream ends (so the last age window can
   // finish), then dropped so settled bodies pay zero cost. Observing during
@@ -373,6 +525,7 @@ function MarkdownImpl({ children, className, streaming = false }: MarkdownProps)
   // fences don't snap to final GFM one commit before the crystallize morph.
   // Reveal identity still tracks the true source (`children`).
   const parseText = streaming || revealActive ? softenStreamingMarkdown(children) : children;
+  const components = useMemo(() => markdownComponents(onSandboxFile), [onSandboxFile]);
 
   // `min-w-0` lets the prose shrink inside flex parents (message bubbles) so
   // long links and code blocks wrap/scroll instead of forcing overflow.
@@ -390,6 +543,7 @@ function MarkdownImpl({ children, className, streaming = false }: MarkdownProps)
           remarkPlugins={[remarkGfm]}
           rehypePlugins={rehypePlugins}
           components={components}
+          urlTransform={markdownUrlTransform}
         >
           {parseText}
         </ReactMarkdown>

package/src/components/message-timeline.tsx

@@ -14,6 +14,7 @@ import {
   ChevronRightIcon,
   PauseCircleIcon,
   PauseIcon,
+  MessageCircleQuestionIcon,
   PencilLineIcon,
   PlayIcon,
   RefreshCwIcon,
@@ -71,6 +72,7 @@ import {
   type AuthNeededItem,
   type ContextCompactionItem,
   type GoalItem,
+  type HumanInputItem,
   type MachineInputBatchItem,
   type NoticeItem,
   type TimelineGroup,
@@ -160,7 +162,7 @@ export type MessageTimelineProps = {
   toolRegistry?: ToolRegistry | undefined;
   /** Resolve opaque retained screenshot receipts through the authenticated host SDK. */
   loadRetainedScreenshot?: RetainedScreenshotLoader | undefined;
-  /** Resolve permanent generated-image receipts through the authenticated host SDK. */
+  /** Resolve permanent workspace image/file receipts through the authenticated host SDK. */
   loadRetainedArtifact?: RetainedArtifactLoader | undefined;
   /** Mint short-lived native playback sources for retained generated videos. */
   loadVideoArtifactPlayback?: VideoArtifactPlaybackLoader | undefined;
@@ -375,7 +377,9 @@ export function MessageTimeline({
   // post-commit settle (two rAFs). That absorbs sync late layout while hidden
   // so load/remount does not ease into the tip — live tip-follow is unchanged
   // once revealed. A flash of the window's TOP is still structurally impossible.
-  const [revealed, setRevealed] = useState(false);
+  // The accepted-create handoff uses the reserved local id "c" so its known
+  // first message is visible immediately; loaded histories still park first.
+  const [revealed, setRevealed] = useState(resolvedItems[0]?.id === "c");
   // Mirror `pinned` into a ref, written ONLY by applyPinned, so the
   // ResizeObserver rAF (a stable closure) reads the live value and a snap can
   // never race a just-unpinned reader across a pending React commit.
@@ -2031,7 +2035,9 @@ function useLiveSettleFold(folded: boolean): boolean {
 function timelineGroupKey(group: TimelineGroup): string {
   switch (group.kind) {
     case "item":
-      return group.item.id;
+      return group.item.kind === "user-message" && group.item.reconciliationKey
+        ? group.item.reconciliationKey
+        : group.item.id;
     case "activity":
       return group.id;
     case "turn":
@@ -2249,6 +2255,8 @@ export function TimelineRow({
   switch (item.kind) {
     case "user-message":
       return <UserMessageRow item={item} renderMessageText={renderMessageText} />;
+    case "human-input":
+      return <HumanInputConversationRow item={item} />;
     case "agent-message":
       return <AgentMessageRow item={item} renderMessageText={renderMessageText} />;
     case "worker-completion":
@@ -2380,14 +2388,7 @@ function UserMessageRow({
     | undefined;
 }) {
   const enter = useEntranceAnimation();
-  const deliveryLabel =
-    item.delivery?.state === "sending"
-      ? "Sending…"
-      : item.delivery?.state === "queued"
-        ? "Queued"
-        : item.delivery?.state === "failed"
-          ? "Not sent"
-          : null;
+  const deliveryFailed = item.delivery?.state === "failed";
   return (
     <div className={cn(enter && "animate-og-enter", "flex justify-end")}>
       <div className="flex max-w-[85%] min-w-0 flex-col items-end gap-1">
@@ -2422,19 +2423,25 @@ function UserMessageRow({
             ) : null}
           </div>
         </CopyHoverFrame>
-        {deliveryLabel ? (
-          <div className="flex max-w-full items-center gap-2 px-1 text-og-xs text-og-fg-subtle">
-            <span title={item.delivery?.error}>{deliveryLabel}</span>
-            {item.delivery?.state === "failed" && item.delivery.onRetry ? (
+        {deliveryFailed ? (
+          <div
+            role="status"
+            className="flex max-w-full items-center gap-2 px-1 text-og-xs text-og-status-failed"
+          >
+            <span className="inline-flex items-center gap-1" title={item.delivery?.error}>
+              <TriangleAlertIcon className="size-3.5 shrink-0" aria-hidden="true" />
+              <span>Message not sent</span>
+            </span>
+            {item.delivery?.onRetry ? (
               <button
                 type="button"
-                className="font-medium text-og-fg underline decoration-og-border underline-offset-2 hover:text-og-fg-strong"
+                className="font-medium text-og-status-failed underline decoration-og-status-failed/50 underline-offset-2 hover:text-og-fg"
                 onClick={item.delivery.onRetry}
               >
                 Retry
               </button>
             ) : null}
-            {item.delivery?.state === "failed" && item.delivery.onRemove ? (
+            {item.delivery?.onRemove ? (
               <button
                 type="button"
                 className="font-medium text-og-fg-subtle underline decoration-og-border underline-offset-2 hover:text-og-fg"
@@ -2450,6 +2457,139 @@ function UserMessageRow({
   );
 }
 
+function HumanInputConversationRow({ item }: { item: HumanInputItem }) {
+  const enter = useEntranceAnimation();
+  const multipleQuestions = Math.max(item.questions.length, item.answers.length) > 1;
+  const questionNumberById = new Map(
+    item.questions.map((question, index) => [question.id, index + 1]),
+  );
+  const settledLabel =
+    item.response.outcome === "answered"
+      ? "You answered"
+      : item.response.outcome === "skipped"
+        ? "Skipped"
+        : item.response.outcome === "expired"
+          ? "Expired"
+          : "Cancelled";
+  const copyText = humanInputConversationCopyText(item, settledLabel);
+
+  return (
+    <div
+      className={cn(enter && "animate-og-enter", "flex w-full flex-col gap-2.5")}
+      data-human-input-history={item.requestId}
+    >
+      <div className="flex max-w-[90%] items-start gap-3 rounded-og-lg rounded-bl-og-xs border border-og-border bg-og-surface-1 px-3.5 py-3 sm:max-w-[82%]">
+        <span className="mt-0.5 inline-flex size-8 shrink-0 items-center justify-center rounded-og-md bg-og-status-waiting/10 text-og-status-waiting">
+          <MessageCircleQuestionIcon aria-hidden="true" className="size-4" />
+        </span>
+        <div className="min-w-0 flex-1">
+          <p className="text-og-xs font-medium text-og-fg-subtle">Agent asked</p>
+          <div className="mt-1.5 space-y-3">
+            {item.questions.length > 0 ? (
+              item.questions.map((question, index) => (
+                <div key={question.id}>
+                  {question.label ? (
+                    <p className="text-og-sm font-semibold text-og-fg">
+                      {multipleQuestions ? (
+                        <span className="mr-1.5 tabular-nums text-og-fg-muted">{index + 1}.</span>
+                      ) : null}
+                      {multipleQuestions ? " " : null}
+                      {question.label}
+                    </p>
+                  ) : null}
+                  <p
+                    className={cn(
+                      "text-og-md leading-6 text-og-fg",
+                      question.label && "mt-0.5 text-og-sm text-og-fg-muted",
+                    )}
+                  >
+                    {!question.label && multipleQuestions ? (
+                      <span className="mr-1.5 tabular-nums text-og-fg-muted">{index + 1}.</span>
+                    ) : null}
+                    {!question.label && multipleQuestions ? " " : null}
+                    {question.prompt}
+                  </p>
+                </div>
+              ))
+            ) : (
+              <p className="text-og-sm text-og-fg-muted">The agent requested structured input.</p>
+            )}
+          </div>
+        </div>
+      </div>
+
+      <div className="flex justify-end">
+        <CopyHoverFrame
+          copyText={copyText}
+          label="Copy answer"
+          className="w-fit max-w-[90%] min-w-0 sm:max-w-[82%]"
+          trailing={<MessageFooterTime occurredAt={item.occurredAt} />}
+        >
+          <div className="w-fit max-w-full min-w-0 rounded-og-lg rounded-br-og-xs border border-og-border bg-og-surface-2 px-4 py-2.5 text-og-md leading-6 text-og-fg">
+            <p className="text-og-xs font-medium text-og-fg-subtle">{settledLabel}</p>
+            {item.response.outcome === "answered" ? (
+              <div className="mt-1.5 space-y-3">
+                {item.answers.length > 0 ? (
+                  item.answers.map((answer, answerIndex) => (
+                    <div key={answer.questionId}>
+                      {multipleQuestions ? (
+                        <p className="text-og-sm font-semibold text-og-fg">
+                          <span className="mr-1.5 tabular-nums text-og-fg-muted">
+                            {questionNumberById.get(answer.questionId) ?? answerIndex + 1}.
+                          </span>{" "}
+                          {answer.label}
+                        </p>
+                      ) : null}
+                      <div className={cn("text-og-md text-og-fg", multipleQuestions && "mt-0.5")}>
+                        {answer.values.length > 1 ? (
+                          <ul className="list-disc space-y-0.5 pl-5">
+                            {answer.values.map((value) => (
+                              <li key={`${answer.questionId}-${value}`}>{value}</li>
+                            ))}
+                          </ul>
+                        ) : (
+                          <p>{answer.values[0] || "Answered"}</p>
+                        )}
+                      </div>
+                    </div>
+                  ))
+                ) : (
+                  <p>Answered</p>
+                )}
+              </div>
+            ) : null}
+          </div>
+        </CopyHoverFrame>
+      </div>
+    </div>
+  );
+}
+
+function humanInputConversationCopyText(item: HumanInputItem, settledLabel: string): string {
+  const questions = item.questions
+    .map(
+      (question, index) =>
+        `${item.questions.length > 1 ? `${index + 1}. ` : ""}${question.label || "Question"}: ${question.prompt}`,
+    )
+    .join("\n\n");
+  const questionNumberById = new Map(
+    item.questions.map((question, index) => [question.id, index + 1]),
+  );
+  const answers = item.answers
+    .map(
+      (answer, index) =>
+        `${
+          item.questions.length > 1
+            ? `${questionNumberById.get(answer.questionId) ?? index + 1}. `
+            : ""
+        }${answer.label}: ${answer.values.join(", ") || "Answered"}`,
+    )
+    .join("\n\n");
+  return [questions, `${settledLabel}${answers ? `\n\n${answers}` : ""}`]
+    .filter(Boolean)
+    .join("\n\n");
+}
+
 function AgentMessageRow({
   item,
   renderMessageText,
@@ -2701,6 +2841,11 @@ const GOAL_META: Record<GoalItem["action"], GoalMeta> = {
   },
   resumed: { label: "Goal resumed", pill: NEUTRAL_PILL, icon: PlayIcon },
   cleared: { label: "Goal cleared", pill: NEUTRAL_PILL, icon: Trash2Icon },
+  held: {
+    label: "Goal held",
+    pill: "border-og-status-waiting/35 bg-og-status-waiting/10 text-og-status-waiting",
+    icon: PauseCircleIcon,
+  },
   continuation: { label: "Continuing toward the goal", pill: NEUTRAL_PILL, icon: ArrowRightIcon },
 };
 

package/src/components/model-policy-picker.tsx

@@ -4,6 +4,7 @@ import {
   ChevronDownIcon,
   ChevronLeftIcon,
   ChevronRightIcon,
+  Globe2Icon,
   KeyRoundIcon,
   ZapIcon,
 } from "lucide-react";
@@ -20,7 +21,6 @@ import {
 import { cn } from "../lib/cn";
 import { usePortalTokenSource, usePortalTokenStyle } from "../lib/use-portal-token-style";
 import {
-  coerceReasoningEffortForModel,
   effortOptionsForModel,
   findPickerRow,
   groupPickerRowsByBillingClass,
@@ -64,6 +64,7 @@ export const defaultModelPolicyPickerMessages: ModelPolicyPickerMessages = {
   codexOnly: "Codex-only session",
   billingHints: {
     opengeni_credits: "Will use credits",
+    external: "Provider terms and limits apply",
     codex_subscription: "ChatGPT / Codex plan",
     supergrok_subscription: "SuperGrok / xAI plan",
     byok: "Billed to your AI Gateway",
@@ -92,6 +93,8 @@ export type ModelPolicyPickerProps = {
   sessionKey?: string | undefined;
   /** Prefer bottom on new-chat surfaces and top for bottom-docked composers. */
   menuSide?: "top" | "bottom" | undefined;
+  /** Hide latency controls on surfaces whose saved policy does not include latency. */
+  allowLatencyMode?: boolean | undefined;
   /** Classes for the portalled menu surface. Prefer --og-* tokens for theming. */
   contentClassName?: string | undefined;
   /** Inline styles for the portalled menu, applied after inherited --og-* tokens. */
@@ -151,6 +154,7 @@ export function BillingClassMark(props: {
 }) {
   const labels: Record<PickerBillingClass, string> = {
     opengeni_credits: "OpenGeni",
+    external: "External provider",
     codex_subscription: "Codex",
     supergrok_subscription: "SuperGrok",
     byok: "Bring your own key",
@@ -173,6 +177,8 @@ export function BillingClassMark(props: {
     >
       {props.billingClass === "opengeni_credits" ? (
         <OpenGeniMark className={mark} />
+      ) : props.billingClass === "external" ? (
+        <Globe2Icon className={mark} aria-hidden />
       ) : props.billingClass === "codex_subscription" ? (
         <ChatGptMark className={mark} />
       ) : props.billingClass === "supergrok_subscription" ? (
@@ -354,17 +360,6 @@ export function ModelPolicyPickerMenu(
   const focusModel =
     effectiveNav.modelId === null ? undefined : findPickerRow(rows, effectiveNav.modelId);
   const selectedRow = findPickerRow(rows, props.model);
-  const { latencyMode, loading, onLatencyModeChange } = props;
-
-  useEffect(() => {
-    if (loading || !selectedRow?.selectable) return;
-    const supportsCurrentMode = runnableLatencyModesForModel(selectedRow.catalog).includes(
-      latencyMode,
-    );
-    if (!supportsCurrentMode && latencyMode !== "standard") {
-      onLatencyModeChange("standard");
-    }
-  }, [latencyMode, loading, onLatencyModeChange, selectedRow]);
 
   const go = (next: PickerNavState, nextDirection: 1 | -1) => {
     setDirection(nextDirection);
@@ -374,7 +369,7 @@ export function ModelPolicyPickerMenu(
   const selectEffort = (row: ClientPickerModelRow, effort: ReasoningEffort) => {
     if (!row.selectable) return;
     if (row.id !== props.model) props.onModelChange(row.id);
-    props.onEffortChange(coerceReasoningEffortForModel(row.catalog, effort));
+    props.onEffortChange(effort);
   };
 
   const pageKey =
@@ -445,7 +440,7 @@ export function ModelPolicyPickerMenu(
           icon={<BillingClassMark billingClass={focusModel.billingClass} />}
           onBack={() => go({ level: "models", rail: focusModel.billingClass, modelId: null }, -1)}
           trailing={
-            supportsFast ? (
+            supportsFast && props.allowLatencyMode !== false ? (
               <button
                 type="button"
                 disabled={!focusModel.selectable}
@@ -460,9 +455,6 @@ export function ModelPolicyPickerMenu(
                 onClick={() => {
                   if (!activeModel) {
                     props.onModelChange(focusModel.id);
-                    props.onEffortChange(
-                      coerceReasoningEffortForModel(focusModel.catalog, props.effort),
-                    );
                   }
                   props.onLatencyModeChange(
                     activeModel && props.latencyMode === "fast" ? "standard" : "fast",

package/src/components/pierre-file.tsx

@@ -25,7 +25,7 @@ type FileComponent = ComponentType<{
 }>;
 
 export type PierreFileProps = {
-  /** Workspace-relative path (used for the header + language inference). */
+  /** Target path (used for the header + language inference). */
   path: string;
   /** The decoded text contents. */
   contents: string;